提示词设计指南
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
掌握提示词设计技巧，充分发挥 Ask AI 的潜力。本指南详解 DocSearch v4 的提示词工作原理，分享主流 AI 服务商的成熟技巧，并提供实用案例，助您为技术文档打造高效且风格统一的 AI 响应。
您将了解：
-
Ask AI 如何结合提示词与您的内容生成响应
-
经过验证的提示词技巧与模式
-
常见误区及规避方法
-
安全性与合规性最佳实践
1. Ask AI 的提示词工作原理
-
基础系统提示词（隐藏） - 每次 Ask AI 请求均以专有系统提示词启动，强制执行安全策略、检索机制和语气控制。
-
您的补充提示词 - 您提供的简短附加指令（例如："以 Kubernetes SRE 身份回答，优先使用简洁的要点列表"）。
-
用户问题 - 访客在聊天框输入的内容。
-
上下文段落 - 从 Algolia 索引中自动提取的相关内容片段。
您仅需控制第 2 步；其余环节由 Ask AI 自动处理。请将您的提示词视为策略补充层，而非完整重写。
2. 高效提示词设计原则
| Goal | What to do | Why it helps |
|---|---|---|
| Be explicit | State role, style and constraints in the first sentence. | LLMs obey the earliest, clearest instruction. |
| Ground in context | Add product names, audience level, or domain jargon. | Reduces hallucinations and keeps answers on-brand. |
| Set format | "Answer in Markdown with H2 headings and a summary table." (we handled this for you) | Ensures consistent rendering in your site theme. |
| Show, don't tell | Give one or two short exemplars of the desired output. | Few-shot examples outperform general adjectives. |
| Limit scope | "If you're unsure, say I don't know." | Encourages honesty over speculation. |
| Iterate & test | Look at the feedback, tweak, re-run. | Prompting is an empirical craft - small wording changes matter. |
技巧 - 保持简洁 冗长的提示词会挤占上下文窗口空间，导致相关文档片段被截断并拖慢响应速度。
3. 实用提示词模式
风格迁移
You are a senior React maintainer. Explain concepts in the style of React docs: concise intro ➜ "Example" ➜ "Gotchas".
角色设定 + 受众定位
Act as a cloud-native Solutions Architect.
Audience: junior DevOps engineers migrating to Kubernetes.
Goal: explain trade-offs in plain English, no jargon.
多步推理
FIRST think step-by-step about possible causes.
THEN output only the final answer in bullet points.
4. 常见误区
| Anti-pattern | What happens | Fix |
|---|---|---|
| Vagueness - "Explain this." | Generic or rambling answers. | Specify role, topic, length. |
| Prompt stuffing - 1 000-word instructions. | Context window overflow; higher cost. | Trim to the essentials. |
| Conflicting rules | Model picks one at random. | Merge rules or order them by priority. |
5. 安全与合规
-
切勿在提示词中粘贴密钥、个人身份信息（PII）或内部 URL。
-
避免在提示词中使用公司政策等敏感信息。
-
测试阶段需抽样检查生成内容是否符合策略要求。
6. 延伸阅读
-
OpenAI - 提示词工程最佳实践 (help.openai.com)
-
OpenAI Cookbook - GPT-4.1 提示词指南 (cookbook.openai.com)
-
Anthropic - Claude 提示词工程综述 (docs.anthropic.com)
这些资源包含具体模板、示例库及思维链提示等高级技巧。
快速检查清单
-
明确定义角色与目标受众
-
指定期望的响应格式
-
包含示例（≤2个）
-
添加范围限制与回退机制
-
使用真实用户问题测试效果
祝您设计愉快！请谨记：持续迭代 → 观察效果 → 精益求精！