Conversation
![tembo[bot]](https://avatars.githubusercontent.com/in/1223475?s=60&v=4){kind=small}
agent/agent-v2.mdx
Outdated
| --- | ||
|
|
||
| <Info> | ||
| Agent v2 is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) and is powered by Anthropic's Claude 4.5 Sonnet model. |
There was a problem hiding this comment.
Nit: since the underlying model may change, it might be safer to phrase this as “currently powered by …”.
| Agent v2 is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) and is powered by Anthropic's Claude 4.5 Sonnet model. | |
| Agent v2 is available on [Enterprise plans](https://mintlify.com/pricing?ref=agent) and is currently powered by Anthropic's Claude 4.5 Sonnet model. |
agent/agent-v2.mdx
Outdated
|
|
||
| ## Configuration with AGENTS.md | ||
|
|
||
| Customize the agent's behavior by adding a `.claude/CLAUDE.md` file to your repository root. This file defines: |
There was a problem hiding this comment.
This section title says AGENTS.md, but the content points to .claude/CLAUDE.md (and later the page repeats that). That seems inconsistent with /agent/customize, which documents AGENTS.md.
| Customize the agent's behavior by adding a `.claude/CLAUDE.md` file to your repository root. This file defines: | |
| Customize the agent's behavior by adding an `AGENTS.md` file to your repository. This file defines: |
agent/agent-v2.mdx
Outdated
| ### Git and GitHub | ||
| - **Branch management**: Create and switch branches | ||
| - **Commit changes**: Stage and commit updates with descriptive messages | ||
| - **Pull requests**: Open PRs with clear descriptions using `gh` CLI |
There was a problem hiding this comment.
Minor: calling out gh specifically makes it sound like a requirement. Might be better to describe the outcome rather than the implementation detail.
| - **Pull requests**: Open PRs with clear descriptions using `gh` CLI | |
| - **Pull requests**: Open PRs with clear descriptions |
agent/agent-v2.mdx
Outdated
| Be specific about what you want: | ||
|
|
||
| ``` | ||
| ❌ "Update the docs" |
There was a problem hiding this comment.
Style: the ✅/❌ markers can render inconsistently across platforms/themes. Consider using plain labels.
| ❌ "Update the docs" | |
| Bad: "Update the docs" | |
| Good: "Add a section to /api-playground/overview explaining how to add authentication headers to API requests" |
agent/index.mdx
Outdated
| --- | ||
|
|
||
| <Warning> | ||
| This documentation describes agent v1, which is deprecated. Please refer to [agent v2](/agent/agent-v2) for the latest version powered by Claude 4.5 Sonnet with enhanced capabilities and autonomous planning. |
There was a problem hiding this comment.
Since this is the v1 deprecation banner, might be better to avoid tying it to a specific model name (less churn if the backing model changes).
| This documentation describes agent v1, which is deprecated. Please refer to [agent v2](/agent/agent-v2) for the latest version powered by Claude 4.5 Sonnet with enhanced capabilities and autonomous planning. | |
| This documentation describes agent v1, which is deprecated. Please refer to [agent v2](/agent/agent-v2) for the latest version with enhanced capabilities and autonomous planning. |
- Added file upload capability in file operations section - Documented Slack-specific features including file attachments - Added examples of using file uploads with the agent - Updated task management section with interactive prompts - Added session management details
- Changed 'powered by' to 'currently powered by' for model flexibility - Fixed AGENTS.md vs .claude/CLAUDE.md inconsistency throughout - Removed 'using gh CLI' implementation detail - Replaced emoji markers with 'Good'/'Bad' text labels for better rendering - Removed model name from v1 deprecation banner
|
|
||
| ## Where to use agent v2 | ||
|
|
||
| - **Dashboard**: Press <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux) from any dashboard page |
There was a problem hiding this comment.
Keyboard shortcut formatting: docs elsewhere use the key name vs the symbol, and spaces around + read better.
| - **Dashboard**: Press <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux) from any dashboard page | |
| - **Dashboard**: Press <kbd>Command</kbd> + <kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows/Linux) from any dashboard page |
| - Prevents goal drift during complex updates | ||
| - Provides visibility into what's being worked on |
There was a problem hiding this comment.
These two bullets read like continuations; making them consistent with the rest of the list improves scanability.
| - Prevents goal drift during complex updates | |
| - Provides visibility into what's being worked on | |
| - **Goal alignment**: Prevents goal drift during complex updates | |
| - **Visibility**: Provides visibility into what's being worked on |
| [attach: endpoints.ts] | ||
| ``` | ||
|
|
||
| The agent automatically fetches, processes, and includes the files in your documentation. |
There was a problem hiding this comment.
This sentence is a bit absolute; softening it avoids over-promising.
| The agent automatically fetches, processes, and includes the files in your documentation. | |
| The agent automatically fetches and processes attached files and can include them in your documentation. |
|
closing in favor of #3426 |
1 participant
Summary
Changes
New page: agent/agent-v2.mdx
Documents the new autonomous agent with:
Updated: agent/index.mdx
Updated: docs.json
Rationale
The agent now uses Claude 4.5 Sonnet with enhanced capabilities including autonomous planning, task management, and specialized tools. This documentation reflects those capabilities and provides users with a comprehensive understanding of what the agent can do.
The v1 documentation remains accessible but is clearly marked as deprecated to guide users toward the new version.
Note
Low Risk
Documentation-only changes plus a navigation reorder; no runtime or security-sensitive code paths are affected.
Overview
Introduces a new
agent/agent-v2.mdxpage documenting the v2 autonomous documentation agent (capabilities, workflow, tool access,AGENTS.mdconfiguration, Slack/file upload support, best practices, and limitations).Updates the existing
agent/index.mdxpage with a deprecation warning for agent v1 that links users to the new v2 docs, and updatesdocs.jsonnavigation to includeagent/agent-v2as the first page in the Agent section.Written by Cursor Bugbot for commit 2ad4b98. This will update automatically on new commits. Configure here.