Grok Code Fast 1 的提示工程

适用于使用代理编码工具的开发者

grok-code-fast-1 是一款轻量级的代理模型，旨在作为您在大多数常见编码工具中的结对编程伙伴。为了优化您的体验，我们提供了一些指导原则，以便您可以快速完成日常编码任务。

提供必要的上下文

大多数编码工具会自动为您收集必要的上下文。然而，通常最好通过选择您想要用作特定上下文的代码来明确指定。这使得 grok-code-fast-1 能够专注于您的任务并防止不必要的偏差。尝试指定相关的文件路径、项目结构或依赖项，并避免提供不相关的上下文。

• 要避免的无上下文提示

  改进错误处理

• 带有指定上下文的良好提示

  我的错误代码定义在 @errors.ts 中，你能用它作为参考，在 @sql.ts 中添加适当的错误处理和错误代码吗？我正在那里进行查询

设定明确的目标和要求

清晰地定义您的目标以及您希望 grok-code-fast-1 解决的具体问题。详细和具体的查询可以带来更好的性能。尽量避免模糊或未明确指定的提示，因为它们可能导致次优结果。

• 要避免的模糊提示

  创建一个食物追踪器

• 良好、详细的提示

  创建一个食物追踪器，当我输入食物项时，它能显示每天按不同营养素划分的卡路里消耗量。让它能提供总览，也能显示高级趋势。

持续优化您的提示

grok-code-fast-1 是一款高效的模型，其速度比其他领先的代理模型快 4 倍，成本仅为 1/10。这使您能够以前所未有的速度和经济性测试复杂的想法。即使初始输出不完美，我们强烈建议您利用其独特的快速和经济的迭代能力来优化您的查询——可以使用上述建议（例如，添加更多上下文），或者参考第一次尝试中的具体失败之处。

• 经过优化的良好提示示例

  之前的方法没有考虑到 IO 密集型过程可能会阻塞主线程，我们可能希望在它自己的线程循环中运行它，这样它就不会阻塞事件循环，而不是仅仅使用异步库版本。

分配代理任务

我们鼓励用户尝试将 grok-code-fast-1 用于代理式任务，而不是一次性查询。我们的 Grok 4 模型更适合一次性问答，而 grok-code-fast-1 则是您在大量代码中借助工具提供精确答案的理想伙伴。

一个好的思考方式是：

• grok-code-fast-1 擅长快速不懈地为您找到答案或实现所需的更改。
• Grok 4 最适合在您预先提供所有必要上下文的情况下深入探讨复杂概念和进行艰难调试。

适用于通过 xAI API 构建编码代理的开发者

通过 grok-code-fast-1，我们希望将代理编码模型带到开发者手中。除了我们的启动合作伙伴外，我们欢迎所有开发者在工具调用密集的领域试用 grok-code-fast-1，因为它速度快、成本低，因此使用多种工具找出正确答案既高效又经济。

正如博客文章中提到的，grok-code-fast-1 是一个推理模型，其思考过程中穿插着工具调用。我们还通过与 OpenAI 兼容的 API 发送总结的思考内容，以提供更好的用户体验支持。更多 API 详情请访问 https://docs.xai.ac.cn/docs/guides/function-calling。

推理内容

grok-code-fast-1 是一个推理模型，我们通过 chunk.choices[0].delta.reasoning_content 暴露其思考轨迹。请注意，思考轨迹仅在使用流式模式时可访问。

使用原生工具调用

grok-code-fast-1 提供对原生工具调用的第一方支持，并且是专门针对原生工具调用设计的。我们鼓励您使用它而不是基于 XML 的工具调用输出，后者可能会损害性能。

提供详细的系统提示

在您的系统提示中要彻底并提供许多细节。一个精心编写的系统提示，描述了任务、期望以及模型应注意的边缘情况，可以带来天壤之别。欲了解更多灵感，请参阅上面的用户最佳实践。

向模型引入上下文

grok-code-fast-1 习惯于在初始用户提示中看到大量上下文。我们建议开发者使用 XML 标签或 Markdown 格式的内容来标记上下文的不同部分，并为某些部分增加清晰度。描述性的 Markdown 标题/XML 标签及其相应的定义将使 grok-code-fast-1 更有效地利用上下文。

优化缓存命中

我们的缓存命中是 grok-code-fast-1 快速推理速度的重要贡献者。在模型按顺序使用多个工具的代理任务中，大多数前缀保持不变，因此会自动从缓存中检索以加快推理速度。我们不建议更改或扩充提示历史记录，因为这可能导致缓存未命中，从而显着降低推理速度。