From b29f00335669a55d3591a9e168aba13341ebc932 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 12 Feb 2026 18:53:56 +0000 Subject: [PATCH 01/12] Update agent docs with new capabilities and file processing features --- agent/index.mdx | 36 ++++++++++++++++++++++++++++++------ agent/slack.mdx | 18 ++++++++++++++++++ 2 files changed, 48 insertions(+), 6 deletions(-) diff --git a/agent/index.mdx b/agent/index.mdx index 13dfb5d5f..e35040f7a 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -5,21 +5,45 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] --- - The agent is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) for anyone with access to your dashboard. + The agent is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) and is powered by Anthropic's Claude 4.5 Sonnet model. -The agent creates pull requests with proposed changes to your documentation based on your prompts. When you send a request to the agent, it references your documentation, connected repositories, and Slack messages to create content that follows technical writing best practices and adheres to the Mintlify schema. +The agent is an autonomous technical writer that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, it researches your documentation and connected repositories, creates a structured plan for complex tasks, writes or updates content following technical writing best practices, and validates changes before creating pull requests. ## What you can do with the agent Use the agent to: -- Write new content based on your prompts, links to pull requests, or Slack threads. -- Revise outdated code examples and API references. -- Search and update existing content. +- Write new content based on your prompts, pull requests, Slack threads, or file attachments. +- Update existing documentation with new features or API changes. +- Process and include images, diagrams, and other files directly from Slack or the dashboard. +- Search and revise code examples and API references across your docs. - Answer questions about your docs and technical writing topics. +- Address code review feedback and maintain documentation quality. - Capture knowledge from Slack conversations and pull requests before it gets lost. +## How the agent works + +When you send a request, the agent: + +1. **Researches**: Reads your existing documentation, connected repositories, and relevant context. +2. **Plans**: Creates a structured task list for complex documentation work. +3. **Writes**: Generates or updates content following technical writing standards. +4. **Validates**: Runs Mintlify CLI checks to ensure documentation builds correctly. +5. **Creates PR**: Opens a pull request with proposed changes for review. + +All changes go through pull requests. The agent never commits directly to your main branch. + +## Key capabilities + +The agent can: + +- **Read files and images**: Process attachments from Slack messages or dashboard uploads to include diagrams, code snippets, and other content in your docs. +- **Handle larger content updates**: Make wholesale modifications to extensive documentation sections with better context awareness. +- **Address code review feedback**: Read pull request comments and resolve documentation issues flagged by review bots. +- **Execute longer context tasks**: Maintain focus across complex, multi-step documentation projects with improved task management. +- **Access full file system**: Navigate and coordinate changes across multiple files and directories efficiently. + ## Where you can use the agent - **Dashboard**: From any page in your dashboard, use the keyboard shortcut ⌘+I (macOS) or Ctrl+I (Windows/Linux) to open the agent panel. Or click **Ask agent** on the [Overview](https://dashboard.mintlify.com/) page. @@ -27,7 +51,7 @@ Use the agent to: The agent panel open in the dashboard. The agent panel open in the dashboard. -- **Slack**: Add the agent to your Slack workspace and mention `@mintlify` to prompt it. +- **Slack**: Add the agent to your Slack workspace and mention `@mintlify` in any channel. You can attach files and images directly to your messages for the agent to process. - **API**: Embed the agent in custom applications using the [agent endpoints](/api/agent/create-agent-job). ## Next steps diff --git a/agent/slack.mdx b/agent/slack.mdx index 901d66d97..08dab5392 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -29,6 +29,7 @@ Once connected, you can: - Send direct messages to the agent to use it privately to update your documentation. - Mention `@mintlify` in a channel to use it publicly and collaboratively. +- Attach files and images directly to your messages for the agent to process and include in your docs. - Continue conversations in threads to iterate on changes. - Share pull request links with the agent to update related documentation. @@ -38,9 +39,26 @@ Use the agent to update your documentation with a new request or in an existing - **New request**: Send a direct message to the agent or mention `@mintlify` in a channel with instructions on what to update. - **Existing thread**: Reply in the thread and mention `@mintlify` with instructions on what to update. +- **With attachments**: Upload images, diagrams, code files, or other documents with your message. The agent automatically processes and includes them in your documentation. The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates. +### Using file attachments + +Attach files to your Slack message when requesting documentation updates: + +``` +@mintlify Add this architecture diagram to the system overview page +[attach: diagram.png] +``` + +``` +@mintlify Document these API endpoints +[attach: api-spec.yaml] +``` + +The agent automatically fetches, processes, and integrates the files into your documentation. + ## Best practices - **Be specific**: Tell the agent exactly what you want documented and where it should go. From c02aedb7811eefcd9f310a9da4eefc8fa51f15d2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 12 Feb 2026 18:55:36 +0000 Subject: [PATCH 02/12] Remove model and provider references --- agent/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index e35040f7a..8825db6bd 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -5,7 +5,7 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] --- - The agent is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) and is powered by Anthropic's Claude 4.5 Sonnet model. + The agent is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) for anyone with access to your dashboard. The agent is an autonomous technical writer that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, it researches your documentation and connected repositories, creates a structured plan for complex tasks, writes or updates content following technical writing best practices, and validates changes before creating pull requests. From f076dcff41d7eef05aa58e54f5758d55f9f79d8f Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:15:00 -0800 Subject: [PATCH 03/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/agent/index.mdx b/agent/index.mdx index 8825db6bd..4b46fcda2 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -22,18 +22,6 @@ Use the agent to: - Address code review feedback and maintain documentation quality. - Capture knowledge from Slack conversations and pull requests before it gets lost. -## How the agent works - -When you send a request, the agent: - -1. **Researches**: Reads your existing documentation, connected repositories, and relevant context. -2. **Plans**: Creates a structured task list for complex documentation work. -3. **Writes**: Generates or updates content following technical writing standards. -4. **Validates**: Runs Mintlify CLI checks to ensure documentation builds correctly. -5. **Creates PR**: Opens a pull request with proposed changes for review. - -All changes go through pull requests. The agent never commits directly to your main branch. - ## Key capabilities The agent can: From f2e2952eb2750d461353ec1efe04922c1ac282cb Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:15:07 -0800 Subject: [PATCH 04/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index 4b46fcda2..bd34caf7c 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -8,7 +8,15 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] The agent is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) for anyone with access to your dashboard. -The agent is an autonomous technical writer that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, it researches your documentation and connected repositories, creates a structured plan for complex tasks, writes or updates content following technical writing best practices, and validates changes before creating pull requests. +The agent is an AI tool that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, the agent: + +- **Researches**: Reads your existing documentation, any connected repositories, and relevant context. +- **Plans**: Creates a structured task list for complex documentation work. +- **Writes**: Generates or updates content following writing standards and best practices. +- **Validates**: Runs Mintlify CLI checks to ensure documentation builds correctly. +- **Creates a PR**: Opens a pull request with proposed changes for review. + +All changes go through pull requests. The agent never commits directly to your main branch. ## What you can do with the agent From 65b5b5fcdb64e8325ef8b18cf84f83fd8756ddc3 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:15:13 -0800 Subject: [PATCH 05/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index bd34caf7c..6fa5426c0 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -24,7 +24,7 @@ Use the agent to: - Write new content based on your prompts, pull requests, Slack threads, or file attachments. - Update existing documentation with new features or API changes. -- Process and include images, diagrams, and other files directly from Slack or the dashboard. +- Process and include images, diagrams, and other files directly from Slack. - Search and revise code examples and API references across your docs. - Answer questions about your docs and technical writing topics. - Address code review feedback and maintain documentation quality. From 331893e0c389b5349b772bc5526e25c2c6f42f49 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:15:20 -0800 Subject: [PATCH 06/12] Apply suggestion from @ethanpalm --- agent/slack.mdx | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index 08dab5392..ea043fce5 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -43,22 +43,6 @@ Use the agent to update your documentation with a new request or in an existing The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates. -### Using file attachments - -Attach files to your Slack message when requesting documentation updates: - -``` -@mintlify Add this architecture diagram to the system overview page -[attach: diagram.png] -``` - -``` -@mintlify Document these API endpoints -[attach: api-spec.yaml] -``` - -The agent automatically fetches, processes, and integrates the files into your documentation. - ## Best practices - **Be specific**: Tell the agent exactly what you want documented and where it should go. From 6c7120c614472b86e503e1628f61ee81fc4afca2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 12 Feb 2026 19:16:46 +0000 Subject: [PATCH 07/12] Add workflows for PR review feedback and file attachments --- agent/workflows.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/agent/workflows.mdx b/agent/workflows.mdx index 7b027f57a..23d99fe83 100644 --- a/agent/workflows.mdx +++ b/agent/workflows.mdx @@ -30,12 +30,24 @@ Prompt the agent with a specific pull request to generate release notes or chang For example: `@mintlify Generate release notes for this PR: [PR link]`. +## Address pull request review feedback + +Share a pull request link with the agent to address reviewer comments and code review feedback on documentation pull requests. + +For example: `@mintlify Address the review comments on this PR: [PR link]`. + ## Generate code examples Prompt the agent to generate code examples for features throughout your docs or on specific pages. For example: `@mintlify Generate a code example to make the authentication method easier to understand`. +## Add images or files to your docs + +Attach files or images directly to your Slack message when prompting the agent. The agent processes the attachment and includes it in the documentation. + +For example: `@mintlify Add this diagram to the architecture overview page` with the image attached to the message. + ## Review existing content Prompt the agent to review existing content for technical accuracy, style, grammar, or other issues. From 23c22e96be0da9264ce5c2ee375524e94ede23ea Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:17:33 -0800 Subject: [PATCH 08/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/agent/index.mdx b/agent/index.mdx index 6fa5426c0..ef7115742 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -30,8 +30,6 @@ Use the agent to: - Address code review feedback and maintain documentation quality. - Capture knowledge from Slack conversations and pull requests before it gets lost. -## Key capabilities - The agent can: - **Read files and images**: Process attachments from Slack messages or dashboard uploads to include diagrams, code snippets, and other content in your docs. From 282826b3b1a73dcb6d1a7a3e7f4a2f1c7b2174aa Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:18:30 -0800 Subject: [PATCH 09/12] Apply suggestions from code review --- agent/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index ef7115742..d1e072b7d 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -32,7 +32,7 @@ Use the agent to: The agent can: -- **Read files and images**: Process attachments from Slack messages or dashboard uploads to include diagrams, code snippets, and other content in your docs. +- **Read files and images**: Process attachments from Slack messages to include diagrams, code snippets, and other content in your docs. - **Handle larger content updates**: Make wholesale modifications to extensive documentation sections with better context awareness. - **Address code review feedback**: Read pull request comments and resolve documentation issues flagged by review bots. - **Execute longer context tasks**: Maintain focus across complex, multi-step documentation projects with improved task management. From 7c0c90d8bc2703573c4b617310b6cd34283e82be Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:18:36 -0800 Subject: [PATCH 10/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index d1e072b7d..5be477e6e 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -33,7 +33,6 @@ Use the agent to: The agent can: - **Read files and images**: Process attachments from Slack messages to include diagrams, code snippets, and other content in your docs. -- **Handle larger content updates**: Make wholesale modifications to extensive documentation sections with better context awareness. - **Address code review feedback**: Read pull request comments and resolve documentation issues flagged by review bots. - **Execute longer context tasks**: Maintain focus across complex, multi-step documentation projects with improved task management. - **Access full file system**: Navigate and coordinate changes across multiple files and directories efficiently. From 188fccd916acfd588175bf7052ed5e477b1a6bc9 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:19:20 -0800 Subject: [PATCH 11/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index 5be477e6e..db1fc1d7a 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -34,7 +34,6 @@ The agent can: - **Read files and images**: Process attachments from Slack messages to include diagrams, code snippets, and other content in your docs. - **Address code review feedback**: Read pull request comments and resolve documentation issues flagged by review bots. -- **Execute longer context tasks**: Maintain focus across complex, multi-step documentation projects with improved task management. - **Access full file system**: Navigate and coordinate changes across multiple files and directories efficiently. ## Where you can use the agent From b42a68602b611295d285101fd55d378540f29ed7 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 12 Feb 2026 11:19:26 -0800 Subject: [PATCH 12/12] Apply suggestion from @ethanpalm --- agent/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent/index.mdx b/agent/index.mdx index db1fc1d7a..bfa80b1c8 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -33,7 +33,7 @@ Use the agent to: The agent can: - **Read files and images**: Process attachments from Slack messages to include diagrams, code snippets, and other content in your docs. -- **Address code review feedback**: Read pull request comments and resolve documentation issues flagged by review bots. +- **Address code review feedback**: Read pull request comments and resolve them. - **Access full file system**: Navigate and coordinate changes across multiple files and directories efficiently. ## Where you can use the agent