Customize assistant behavior

Customize the AI assistant by adding an Assistant.md file with system instructions that shape its tone, persona, focus areas, and response behavior.

Add a .mintlify/Assistant.md file at the root of your documentation project to give the assistant custom instructions that shape how it responds. The assistant also accepts ASSISTANT.md as a filename. It uses these instructions as system-level context for every response.

Instructions in an Assistant.md file add to the assistant's system prompt. They do not replace or override the assistant's default instructions.

To remove the custom instructions, remove the Assistant.md file.

Use Assistant.md to:

• Adjust the assistant's persona and tone
• Provide product-specific context
• Define support escalation paths
• Specify terminology preferences
• Restrict or scope the assistant's focus areas
• Provide version-specific guidance

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".

• Customize agent behavior
• Automations overview
• Themes