From ad9f0a38febee72e5fa8b89fee0fbd2d3879199a Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Wed, 2 Apr 2025 16:41:53 +0000 Subject: [PATCH 1/9] move ai docs up a level --- .../ai-agents => coder-ai}/README.md | 8 +- .../ai-agents => coder-ai}/agents.md | 0 .../ai-agents => coder-ai}/best-practices.md | 2 +- .../ai-agents => coder-ai}/coder-dashboard.md | 4 +- .../ai-agents => coder-ai}/create-template.md | 4 +- .../ai-agents => coder-ai}/custom-agents.md | 0 .../ai-agents => coder-ai}/headless.md | 4 +- .../ai-agents => coder-ai}/ide-integration.md | 2 +- .../ai-agents => coder-ai}/issue-tracker.md | 8 +- .../ai-agents => coder-ai}/securing.md | 0 docs/manifest.json | 122 +++++++++--------- 11 files changed, 77 insertions(+), 77 deletions(-) rename docs/{tutorials/ai-agents => coder-ai}/README.md (86%) rename docs/{tutorials/ai-agents => coder-ai}/agents.md (100%) rename docs/{tutorials/ai-agents => coder-ai}/best-practices.md (96%) rename docs/{tutorials/ai-agents => coder-ai}/coder-dashboard.md (83%) rename docs/{tutorials/ai-agents => coder-ai}/create-template.md (92%) rename docs/{tutorials/ai-agents => coder-ai}/custom-agents.md (100%) rename docs/{tutorials/ai-agents => coder-ai}/headless.md (93%) rename docs/{tutorials/ai-agents => coder-ai}/ide-integration.md (93%) rename docs/{tutorials/ai-agents => coder-ai}/issue-tracker.md (86%) rename docs/{tutorials/ai-agents => coder-ai}/securing.md (100%) diff --git a/docs/tutorials/ai-agents/README.md b/docs/coder-ai/README.md similarity index 86% rename from docs/tutorials/ai-agents/README.md rename to docs/coder-ai/README.md index fe3ef1bb97c37..f9dc58c3ee6be 100644 --- a/docs/tutorials/ai-agents/README.md +++ b/docs/coder-ai/README.md @@ -1,4 +1,4 @@ -# Run AI Agents in Coder (Early Access) +# Use AI Coding Agents in Coder Workspaces > [!NOTE] > @@ -19,14 +19,14 @@ AI Coding Agents such as [Claude Code](https://docs.anthropic.com/en/docs/agents With Coder, you can self-host AI agents in isolated development environments with proper context and tooling around your existing developer workflows. Whether you are a regulated enterprise or an individual developer, running AI agents at scale with Coder is much more productive and secure than running them locally. -![AI Agents in Coder](../../images/guides//ai-agents/landing.png) +![AI Agents in Coder](../images/guides/ai-agents/landing.png) ## Prerequisites Coder is free and open source for developers, with a [premium plan](https://coder.com/pricing) for enterprises. You can self-host a Coder deployment in your own cloud provider. -- A [Coder deployment](../../install/) with v2.21.0 or later -- A Coder [template](../../admin/templates/) for your project(s). +- A [Coder deployment](../install/index.md) with v2.21.0 or later +- A Coder [template](../admin/templates/index.md) for your project(s). - Access to at least one ML model (e.g. Anthropic Claude, Google Gemini, OpenAI) - Cloud Model Providers (AWS Bedrock, GCP Vertex AI, Azure OpenAI) are supported with some agents - Self-hosted models (e.g. llama3) and AI proxies (OpenRouter) are supported with some agents diff --git a/docs/tutorials/ai-agents/agents.md b/docs/coder-ai/agents.md similarity index 100% rename from docs/tutorials/ai-agents/agents.md rename to docs/coder-ai/agents.md diff --git a/docs/tutorials/ai-agents/best-practices.md b/docs/coder-ai/best-practices.md similarity index 96% rename from docs/tutorials/ai-agents/best-practices.md rename to docs/coder-ai/best-practices.md index 82df73ce21af0..45e975a50ed68 100644 --- a/docs/tutorials/ai-agents/best-practices.md +++ b/docs/coder-ai/best-practices.md @@ -31,7 +31,7 @@ for development. With AI Agents, this is no exception. - Ensure your [template](./create-template.md) is truly pre-configured for development without manual intervention (e.g. repos are cloned, dependencies are built, secrets are added/mocked, etc.) - > Note: [External authentication](../../admin/external-auth.md) can be helpful + > Note: [External authentication](../admin/external-auth.md) can be helpful > to authenticate with third-party services such as GitHub or JFrog. - Give your agent the proper tools via MCP to interact with your codebase and related services. diff --git a/docs/tutorials/ai-agents/coder-dashboard.md b/docs/coder-ai/coder-dashboard.md similarity index 83% rename from docs/tutorials/ai-agents/coder-dashboard.md rename to docs/coder-ai/coder-dashboard.md index bc660191497fe..a82ccb0f6b8ff 100644 --- a/docs/tutorials/ai-agents/coder-dashboard.md +++ b/docs/coder-ai/coder-dashboard.md @@ -17,9 +17,9 @@ Once you have an agent running and reporting activity to Coder, you can view status and switch between workspaces from the Coder dashboard. -![Coder Dashboard](../../images/guides/ai-agents/workspaces-list.png) +![Coder Dashboard](../images/guides/ai-agents/workspaces-list.png) -![Workspace Details](../../images/guides/ai-agents/workspace-details.png) +![Workspace Details](../images/guides/ai-agents/workspace-details.png) ## Next Steps diff --git a/docs/tutorials/ai-agents/create-template.md b/docs/coder-ai/create-template.md similarity index 92% rename from docs/tutorials/ai-agents/create-template.md rename to docs/coder-ai/create-template.md index 56b51505ff0d2..3cbff7cab86b5 100644 --- a/docs/tutorials/ai-agents/create-template.md +++ b/docs/coder-ai/create-template.md @@ -27,7 +27,7 @@ template that has all of the tools and dependencies installed. This can be done in the Coder UI: -![Duplicate template](../../images/guides/ai-agents/duplicate.png) +![Duplicate template](../images/guides/ai-agents/duplicate.png) ## 2. Add a module for supported agents @@ -48,7 +48,7 @@ report status back to the Coder control plane. The Coder dashboard should now show tasks being reported by the agent. -![AI Agents in Coder](../../images/guides//ai-agents/landing.png) +![AI Agents in Coder](../images/guides/ai-agents/landing.png) ## Next Steps diff --git a/docs/tutorials/ai-agents/custom-agents.md b/docs/coder-ai/custom-agents.md similarity index 100% rename from docs/tutorials/ai-agents/custom-agents.md rename to docs/coder-ai/custom-agents.md diff --git a/docs/tutorials/ai-agents/headless.md b/docs/coder-ai/headless.md similarity index 93% rename from docs/tutorials/ai-agents/headless.md rename to docs/coder-ai/headless.md index c2c415380ac04..99d9e709904ca 100644 --- a/docs/tutorials/ai-agents/headless.md +++ b/docs/coder-ai/headless.md @@ -44,12 +44,12 @@ coder exp mcp configure cursor # Configure Cursor to interact with Coder ## Coder CLI Workspaces can be created, started, and stopped via the Coder CLI. See the -[CLI docs](../../reference/cli/) for more information. +[CLI docs](../reference/cli/index.md) for more information. ## REST API The Coder REST API can be used to manage workspaces and agents. See the -[API docs](../../reference/api/) for more information. +[API docs](../reference/api/index.md) for more information. ## Next Steps diff --git a/docs/tutorials/ai-agents/ide-integration.md b/docs/coder-ai/ide-integration.md similarity index 93% rename from docs/tutorials/ai-agents/ide-integration.md rename to docs/coder-ai/ide-integration.md index 678faf18a743a..6f15631135087 100644 --- a/docs/tutorials/ai-agents/ide-integration.md +++ b/docs/coder-ai/ide-integration.md @@ -21,7 +21,7 @@ Once you have an agent running and reporting activity to Coder, you can view the status and switch between workspaces from the IDE. This can be very helpful for reviewing code, working along with the agent, and more. -![IDE Integration](../../images/guides/ai-agents/ide-integration.png) +![IDE Integration](../images/guides/ai-agents/ide-integration.png) ## Next Steps diff --git a/docs/tutorials/ai-agents/issue-tracker.md b/docs/coder-ai/issue-tracker.md similarity index 86% rename from docs/tutorials/ai-agents/issue-tracker.md rename to docs/coder-ai/issue-tracker.md index 597dd652ddfd5..186c18e5c900b 100644 --- a/docs/tutorials/ai-agents/issue-tracker.md +++ b/docs/coder-ai/issue-tracker.md @@ -28,7 +28,7 @@ The [start-workspace](https://github.com/coder/start-workspace-action) GitHub action will create a Coder workspace based on a specific phrase in a comment (e.g. `@coder`). -![GitHub Issue](../../images/guides/ai-agents/github-action.png) +![GitHub Issue](../images/guides/ai-agents/github-action.png) When properly configured with an [AI template](./create-template.md), the agent will begin working on the issue. @@ -39,15 +39,15 @@ We're working on adding support for an agent automatically creating pull requests and responding to your comments. Check back soon or [join our Discord](https://discord.gg/coder) to stay updated. -![GitHub Pull Request](../../images/guides/ai-agents/github-pr.png) +![GitHub Pull Request](../images/guides/ai-agents/github-pr.png) ## Integrating with Other Issue Trackers While support for other issue trackers is under consideration, you can can use -the [REST API](../../reference/api/) or [CLI](../../reference/cli/) to integrate +the [REST API](../reference/api/index.md) or [CLI](../reference/cli/index.md) to integrate with other issue trackers or CI pipelines. -In addition, an [Open in Coder](../../admin/templates/open-in-coder.md) flow can +In addition, an [Open in Coder](../admin/templates/open-in-coder.md) flow can be used to generate a URL and/or markdown button in your issue tracker to automatically create a workspace with specific parameters. diff --git a/docs/tutorials/ai-agents/securing.md b/docs/coder-ai/securing.md similarity index 100% rename from docs/tutorials/ai-agents/securing.md rename to docs/coder-ai/securing.md diff --git a/docs/manifest.json b/docs/manifest.json index c0845490606b8..6149a62ca623f 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -673,6 +673,67 @@ } ] }, + { + "title": "Use AI Coding Agents in Coder workspaces", + "description": "Learn how to run and integrate AI coding agents like GPT-Code, OpenDevin, or SWE-Agent in Coder workspaces to boost developer productivity.", + "path": "./coder-ai/README.md", + "state": ["early access"], + "children": [ + { + "title": "Learn about coding agents", + "description": "Learn about the different AI agents and their tradeoffs", + "path": "./coder-ai/agents.md" + }, + { + "title": "Create a Coder template for agents", + "description": "Create a purpose-built template for your AI agents", + "path": "./coder-ai/create-template.md", + "state": ["early access"] + }, + { + "title": "Integrate with your issue tracker", + "description": "Assign tickets to AI agents and interact via code reviews", + "path": "./coder-ai/issue-tracker.md", + "state": ["early access"] + }, + { + "title": "Best practices \u0026 adding tools via MCP", + "description": "Improve results by adding tools to your agents", + "path": "./coder-ai/best-practices.md", + "state": ["early access"] + }, + { + "title": "Supervise agents via Coder UI", + "description": "Interact with agents via the Coder UI", + "path": "./coder-ai/coder-dashboard.md", + "state": ["early access"] + }, + { + "title": "Supervise agents via the IDE", + "description": "Interact with agents via VS Code or Cursor", + "path": "./coder-ai/ide-integration.md", + "state": ["early access"] + }, + { + "title": "Programmatically manage agents", + "description": "Manage agents via MCP, the Coder CLI, and/or REST API", + "path": "./coder-ai/headless.md", + "state": ["early access"] + }, + { + "title": "Securing agents in Coder", + "description": "Learn how to secure agents with boundaries", + "path": "./coder-ai/securing.md", + "state": ["early access"] + }, + { + "title": "Custom agents", + "description": "Learn how to use custom agents with Coder", + "path": "./coder-ai/custom-agents.md", + "state": ["early access"] + } + ] + }, { "title": "Contributing", "description": "Learn how to contribute to Coder", @@ -716,67 +777,6 @@ "description": "Learn how to install and run Coder quickly", "path": "./tutorials/quickstart.md" }, - { - "title": "Run AI Coding Agents with Coder", - "description": "Learn how to run and secure agents in Coder", - "path": "./tutorials/ai-agents/README.md", - "state": ["early access"], - "children": [ - { - "title": "Learn about coding agents", - "description": "Learn about the different AI agents and their tradeoffs", - "path": "./tutorials/ai-agents/agents.md" - }, - { - "title": "Create a Coder template for agents", - "description": "Create a purpose-built template for your AI agents", - "path": "./tutorials/ai-agents/create-template.md", - "state": ["early access"] - }, - { - "title": "Integrate with your issue tracker", - "description": "Assign tickets to AI agents and interact via code reviews", - "path": "./tutorials/ai-agents/issue-tracker.md", - "state": ["early access"] - }, - { - "title": "Best practices \u0026 adding tools via MCP", - "description": "Improve results by adding tools to your agents", - "path": "./tutorials/ai-agents/best-practices.md", - "state": ["early access"] - }, - { - "title": "Supervise agents via Coder UI", - "description": "Interact with agents via the Coder UI", - "path": "./tutorials/ai-agents/coder-dashboard.md", - "state": ["early access"] - }, - { - "title": "Supervise agents via the IDE", - "description": "Interact with agents via VS Code or Cursor", - "path": "./tutorials/ai-agents/ide-integration.md", - "state": ["early access"] - }, - { - "title": "Programmatically manage agents", - "description": "Manage agents via MCP, the Coder CLI, and/or REST API", - "path": "./tutorials/ai-agents/headless.md", - "state": ["early access"] - }, - { - "title": "Securing agents in Coder", - "description": "Learn how to secure agents with boundaries", - "path": "./tutorials/ai-agents/securing.md", - "state": ["early access"] - }, - { - "title": "Custom agents", - "description": "Learn how to use custom agents with Coder", - "path": "./tutorials/ai-agents/custom-agents.md", - "state": ["early access"] - } - ] - }, { "title": "Write a Template from Scratch", "description": "Learn how to author Coder templates", From 2dc3f88eabb3b1679c9660de63946c643a4741a3 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Wed, 2 Apr 2025 17:34:42 +0000 Subject: [PATCH 2/9] title and icon --- docs/manifest.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/manifest.json b/docs/manifest.json index 6149a62ca623f..d3cff1ce705b7 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -674,9 +674,10 @@ ] }, { - "title": "Use AI Coding Agents in Coder workspaces", + "title": "Run AI Coding Agents in Coder", "description": "Learn how to run and integrate AI coding agents like GPT-Code, OpenDevin, or SWE-Agent in Coder workspaces to boost developer productivity.", "path": "./coder-ai/README.md", + "icon_path": "./images/icons/wand-sparkles.svg", "state": ["early access"], "children": [ { From fe794a24f338d685d6606a7771a129a7a24fa90f Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 16:37:45 +0000 Subject: [PATCH 3/9] add wand-sparkles --- docs/coder-ai/best-practices.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/coder-ai/best-practices.md b/docs/coder-ai/best-practices.md index 45e975a50ed68..16eb35a7e6cc2 100644 --- a/docs/coder-ai/best-practices.md +++ b/docs/coder-ai/best-practices.md @@ -2,7 +2,8 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is rapidly evolving. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > From 9e7f959f15853b112be670b8729074aa0e851a0c Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 16:49:41 +0000 Subject: [PATCH 4/9] edit wand-sparkles --- docs/images/icons/wand-sparkles.svg | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/images/icons/wand-sparkles.svg diff --git a/docs/images/icons/wand-sparkles.svg b/docs/images/icons/wand-sparkles.svg new file mode 100644 index 0000000000000..d1b9823854440 --- /dev/null +++ b/docs/images/icons/wand-sparkles.svg @@ -0,0 +1,3 @@ + + + From d5a6737116d99ba8d6ae88aa1dbd7dc2c84054e2 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 16:58:31 +0000 Subject: [PATCH 5/9] edit wand-sparkles/resize --- docs/images/icons/wand-sparkles.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/images/icons/wand-sparkles.svg b/docs/images/icons/wand-sparkles.svg index d1b9823854440..7f07e954a7235 100644 --- a/docs/images/icons/wand-sparkles.svg +++ b/docs/images/icons/wand-sparkles.svg @@ -1,3 +1,3 @@ - + From c5a9e88652faf94b116284aa46478ac413177b89 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 17:08:16 +0000 Subject: [PATCH 6/9] edit wand-sparkles/resize --- docs/images/icons/wand-sparkles.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/images/icons/wand-sparkles.svg b/docs/images/icons/wand-sparkles.svg index 7f07e954a7235..4df97a5683367 100644 --- a/docs/images/icons/wand-sparkles.svg +++ b/docs/images/icons/wand-sparkles.svg @@ -1,3 +1,3 @@ - + From f61fc99f5b10802956d5edf0c9cb794f1bc1bc92 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 17:18:30 +0000 Subject: [PATCH 7/9] s/wand-sparkles/wand --- docs/images/icons/wand-sparkles.svg | 3 --- docs/images/icons/wand.svg | 3 +++ docs/manifest.json | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) delete mode 100644 docs/images/icons/wand-sparkles.svg create mode 100644 docs/images/icons/wand.svg diff --git a/docs/images/icons/wand-sparkles.svg b/docs/images/icons/wand-sparkles.svg deleted file mode 100644 index 4df97a5683367..0000000000000 --- a/docs/images/icons/wand-sparkles.svg +++ /dev/null @@ -1,3 +0,0 @@ - - - diff --git a/docs/images/icons/wand.svg b/docs/images/icons/wand.svg new file mode 100644 index 0000000000000..92c499bab807c --- /dev/null +++ b/docs/images/icons/wand.svg @@ -0,0 +1,3 @@ + + + diff --git a/docs/manifest.json b/docs/manifest.json index 08dd8201fc518..bafea994181aa 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -677,7 +677,7 @@ "title": "Run AI Coding Agents in Coder", "description": "Learn how to run and integrate AI coding agents like GPT-Code, OpenDevin, or SWE-Agent in Coder workspaces to boost developer productivity.", "path": "./coder-ai/README.md", - "icon_path": "./images/icons/wand-sparkles.svg", + "icon_path": "./images/icons/wand.svg", "state": ["early access"], "children": [ { From 1ac45c1a8bee430ccff089ddb22dd9797fbfeaff Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 18:11:45 +0000 Subject: [PATCH 8/9] align notes --- docs/coder-ai/README.md | 3 ++- docs/coder-ai/agents.md | 7 ++++--- docs/coder-ai/best-practices.md | 2 +- docs/coder-ai/coder-dashboard.md | 3 ++- docs/coder-ai/create-template.md | 3 ++- docs/coder-ai/custom-agents.md | 3 ++- docs/coder-ai/headless.md | 3 ++- docs/coder-ai/ide-integration.md | 3 ++- docs/coder-ai/issue-tracker.md | 3 ++- docs/coder-ai/securing.md | 3 ++- 10 files changed, 21 insertions(+), 12 deletions(-) diff --git a/docs/coder-ai/README.md b/docs/coder-ai/README.md index f9dc58c3ee6be..d40c8d4c6c45f 100644 --- a/docs/coder-ai/README.md +++ b/docs/coder-ai/README.md @@ -2,7 +2,8 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/agents.md b/docs/coder-ai/agents.md index 2a2aa8c216107..009629cc67082 100644 --- a/docs/coder-ai/agents.md +++ b/docs/coder-ai/agents.md @@ -2,9 +2,10 @@ > [!NOTE] > -> This page is not exhaustive and the landscape is evolving rapidly. Please -> [open an issue](https://github.com/coder/coder/issues/new) or submit a pull -> request if you'd like to see your favorite agent added or updated. +> This page is not exhaustive and the landscape is evolving rapidly. +> +> Please [open an issue](https://github.com/coder/coder/issues/new) or submit a +> pull request if you'd like to see your favorite agent added or updated. There are several types of coding agents emerging: diff --git a/docs/coder-ai/best-practices.md b/docs/coder-ai/best-practices.md index 16eb35a7e6cc2..00fbeacfd528e 100644 --- a/docs/coder-ai/best-practices.md +++ b/docs/coder-ai/best-practices.md @@ -2,7 +2,7 @@ > [!NOTE] > -> This functionality is in early access and is rapidly evolving. +> This functionality is in early access and is evolving rapidly. > > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. diff --git a/docs/coder-ai/coder-dashboard.md b/docs/coder-ai/coder-dashboard.md index a82ccb0f6b8ff..90004897c3542 100644 --- a/docs/coder-ai/coder-dashboard.md +++ b/docs/coder-ai/coder-dashboard.md @@ -1,6 +1,7 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/create-template.md b/docs/coder-ai/create-template.md index 3cbff7cab86b5..1b3c385f083e1 100644 --- a/docs/coder-ai/create-template.md +++ b/docs/coder-ai/create-template.md @@ -2,7 +2,8 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/custom-agents.md b/docs/coder-ai/custom-agents.md index 5c276eb4bdcbd..b6c67b6f4b3c9 100644 --- a/docs/coder-ai/custom-agents.md +++ b/docs/coder-ai/custom-agents.md @@ -2,7 +2,8 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/headless.md b/docs/coder-ai/headless.md index 99d9e709904ca..b88511524bde3 100644 --- a/docs/coder-ai/headless.md +++ b/docs/coder-ai/headless.md @@ -1,6 +1,7 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/ide-integration.md b/docs/coder-ai/ide-integration.md index 6f15631135087..0a1bb1ff51ff6 100644 --- a/docs/coder-ai/ide-integration.md +++ b/docs/coder-ai/ide-integration.md @@ -1,6 +1,7 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/issue-tracker.md b/docs/coder-ai/issue-tracker.md index 186c18e5c900b..680384b37f0e9 100644 --- a/docs/coder-ai/issue-tracker.md +++ b/docs/coder-ai/issue-tracker.md @@ -2,7 +2,8 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > diff --git a/docs/coder-ai/securing.md b/docs/coder-ai/securing.md index 31b628b83ebd1..91ce3b6da5249 100644 --- a/docs/coder-ai/securing.md +++ b/docs/coder-ai/securing.md @@ -1,6 +1,7 @@ > [!NOTE] > -> This functionality is in early access and still evolving. +> This functionality is in early access and is evolving rapidly. +> > For now, we recommend testing it in a demo or staging environment, > rather than deploying to production. > From b45bf9712a0bb0b7c27d99fefc9dc37294c8f866 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Fri, 4 Apr 2025 20:30:36 +0000 Subject: [PATCH 9/9] adjust title; copy tweaks --- docs/coder-ai/README.md | 2 +- docs/coder-ai/best-practices.md | 10 ++++++---- docs/manifest.json | 4 ++-- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/coder-ai/README.md b/docs/coder-ai/README.md index d40c8d4c6c45f..7c7227b960e58 100644 --- a/docs/coder-ai/README.md +++ b/docs/coder-ai/README.md @@ -15,7 +15,7 @@ AI Coding Agents such as [Claude Code](https://docs.anthropic.com/en/docs/agents - Protyping web applications or landing pages - Researching / onboarding to a codebase - Assisting with lightweight refactors -- Writing tests and documentation +- Writing tests and draft documentation - Small, well-defined chores With Coder, you can self-host AI agents in isolated development environments with proper context and tooling around your existing developer workflows. Whether you are a regulated enterprise or an individual developer, running AI agents at scale with Coder is much more productive and secure than running them locally. diff --git a/docs/coder-ai/best-practices.md b/docs/coder-ai/best-practices.md index 00fbeacfd528e..3b031278c4b02 100644 --- a/docs/coder-ai/best-practices.md +++ b/docs/coder-ai/best-practices.md @@ -1,4 +1,4 @@ -# Best Practices & Adding Tools via MCP +# Model Context Protocols (MCP) and adding AI tools > [!NOTE] > @@ -22,8 +22,8 @@ for development. With AI Agents, this is no exception. ## Best Practices -- Since agents are still early, it is best to use the most capable ML models you - have access to in order to evaluate their performance. +- Use the most capable ML models you have access to in order to evaluate Agent + performance. - Set a system prompt with the `AI_SYSTEM_PROMPT` environment in your template - Within your repositories, write a `.cursorrules`, `CLAUDE.md` or similar file to guide the agent's behavior. @@ -31,9 +31,11 @@ for development. With AI Agents, this is no exception. (e.g. `gh`) in your image/template. - Ensure your [template](./create-template.md) is truly pre-configured for development without manual intervention (e.g. repos are cloned, dependencies - are built, secrets are added/mocked, etc.) + are built, secrets are added/mocked, etc.). + > Note: [External authentication](../admin/external-auth.md) can be helpful > to authenticate with third-party services such as GitHub or JFrog. + - Give your agent the proper tools via MCP to interact with your codebase and related services. - Read our recommendations on [securing agents](./securing.md) to avoid diff --git a/docs/manifest.json b/docs/manifest.json index bafea994181aa..08dba2fc368ca 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -698,8 +698,8 @@ "state": ["early access"] }, { - "title": "Best practices \u0026 adding tools via MCP", - "description": "Improve results by adding tools to your agents", + "title": "Model Context Protocols (MCP) and adding AI tools", + "description": "Improve results by adding tools to your AI agents", "path": "./coder-ai/best-practices.md", "state": ["early access"] },