跳转到主要内容
在你的文档项目根目录添加一个 .mintlify/Assistant.md 文件，为 AI 助手提供自定义指令来定义其响应方式（ASSISTANT.md 也是可接受的文件名）。AI 助手将这些指令作为每个响应的系统级上下文。
请将 Assistant.md 文件放在 .mintlify/ 目录中，而不是项目根目录。如果你将文件存放在项目根目录，你的自定义指令将通过 /assistant.md 路径公开访问。.mintlify/ 目录不会公开提供服务，因此你的 Assistant.md 文件在该目录中时不可被访问。如果你必须将 Assistant.md 文件存放在项目根目录或任何其他目录，请将其添加到 .mintignore 文件中，以将其从文档站点中排除。
Assistant.md 文件中的指令会添加到 AI 助手的系统提示中。它们不会替换或覆盖 AI 助手的默认指令。 请让指令保持简洁并聚焦。因为 Assistant.md 会包含在每次响应中，冗长或散乱的内容会挤占用户上下文并稀释回答质量。对于仅在相关时才需要加载的、面向特定主题的指导，请改用 skills。 对 Assistant.md 的更改会在下一次部署后生效。要验证效果，请在你的线上站点打开 AI 助手，提出能触发新指令的问题，例如术语偏好或升级路径。 对于 AI 助手仅在问题匹配时才应引入的、面向特定主题的深入指导，请使用 assistant skills，而不是将内容加入 Assistant.md。 要删除自定义指令，请删除 Assistant.md 文件。 使用 Assistant.md 可以：
  • 调整 AI 助手的角色和语气
  • 提供产品特定的上下文
  • 定义支持升级路径
  • 指定术语偏好
  • 限定或界定 AI 助手的关注领域
  • 提供特定版本的指导

​
Assistant.md 文件示例

.mintlify/Assistant.md
You are a helpful assistant for Acme Corp's developer platform.

## Tone
- Be concise and direct. Getting to the point helps people more than being exhaustive.
- Use technical language appropriate for software developers. Most people asking you questions are familiar with Acme's products.

## Product context
- Acme SDK v3 is the current stable release. v2 is deprecated. If people ask about v2, remind them it's deprecated but answer their questions.
- Direct billing questions to support@acme.com.

## Terminology
- Use "workspace" instead of "project" or "organization".
- Use "access token" instead of "API key".