diff --git a/docs/ai-coder/agents/getting-started.md b/docs/ai-coder/agents/getting-started.md index 3b74d75661..e4e0536fe0 100644 --- a/docs/ai-coder/agents/getting-started.md +++ b/docs/ai-coder/agents/getting-started.md @@ -1,7 +1,7 @@ # Getting Started This guide walks platform teams and administrators through enabling Coder -Agents, preparing your deployment, and running your first chat. +Agents, preparing your deployment, and running your first Coder Agent. > [!NOTE] > Coder Agents is in [Early Access](./early-access.md). Deploy to a @@ -24,7 +24,7 @@ Before you begin, confirm the following: for the agent to select when provisioning workspaces. - **Admin access** to the Coder deployment for enabling the experiment and configuring providers. -- **Coder Agents User role** assigned to each user who needs to create or use chats. +- **Coder Agents User role** assigned to each user who needs to interact with Coder Agents. Owners can assign this from **Admin** > **Users**. See [Grant Coder Agents User](#step-3-grant-coder-agents-user) below. @@ -74,7 +74,7 @@ Detailed instructions for each provider and model option are in the ## Step 3: Grant Coder Agents User -The **Coder Agents User** role controls which users can create and use chats. +The **Coder Agents User** role controls which users can interact with Coder Agents. Members do not have Coder Agents User by default. 1. Go to **Admin** > **Users** in the Coder dashboard. @@ -85,10 +85,10 @@ Repeat for each user who needs access. Owners always have full access and do not need the role. > [!NOTE] -> Users who created chats before this role was introduced are +> Users who created conversations before this role was introduced are > automatically granted the role during upgrade. -## Step 4: Start your first chat +## Step 4: Start your first Coder Agent 1. Go to the **Agents** page in the Coder dashboard. 1. Select a model from the dropdown (your default will be pre-selected). @@ -144,7 +144,7 @@ set of expectations and limitations. ### Set a deployment-wide system prompt -Administrators can set a system prompt that applies to all chats across the +Administrators can set a system prompt that applies to all Coder Agents across the deployment. Use this to encode organizational conventions: - Coding standards and style guidelines. @@ -177,7 +177,7 @@ with tighter network policies. ### Plan for LLM costs -Every chat turn sends tokens to your LLM provider. Long-running tasks, +Every conversation turn sends tokens to your LLM provider. Long-running tasks, sub-agent delegation, and complex multi-step work can consume significant token volume. Consider: @@ -207,12 +207,12 @@ multiplier, not a replacement for developer judgment. The [Chats API](./chats-api.md) enables programmatic access to Coder Agents. This is useful for building automations such as: -- Triggering chats from CI/CD pipelines when builds fail. -- Creating chats from GitHub webhooks on new issues or PRs. +- Triggering Coder Agents from CI/CD pipelines when builds fail. +- Creating Coder Agents from GitHub webhooks on new issues or PRs. - Building internal tools or dashboards on top of the API. - Scripting batch operations across repositories. -**Quick example — create a chat via the API:** +**Quick example — create a Coder Agent via the API:** ```sh curl -X POST https://coder.example.com/api/experimental/chats \ @@ -245,7 +245,7 @@ narrowly scoped. Create an `AGENTS.md` file in the home directory (`~/.coder/AGENTS.md`) or the workspace agent's working directory to provide persistent context to the agent. This file is automatically read and included in the system prompt -for every chat that uses that workspace. +for every conversation with a Coder Agent that uses that workspace. Use it for: @@ -275,7 +275,7 @@ Good feedback includes: - **What you tried** — the prompt, the template, and the model. - **What happened** — the agent's behavior, any errors, unexpected results. - **What you expected** — the outcome you were looking for. -- **Context** — screenshots, chat IDs, or links to the Agents page help +- **Context** — screenshots, `chat_id` values, or links to the Agents page help the team investigate quickly. Your input directly influences product direction during Early Access. diff --git a/docs/manifest.json b/docs/manifest.json index 7007181d3e..7307d1eed4 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -1204,7 +1204,7 @@ "children": [ { "title": "Getting Started", - "description": "Enable Coder Agents, prepare your deployment, and run your first chat", + "description": "Enable Coder Agents, prepare your deployment, and run your first Coder Agent", "path": "./ai-coder/agents/getting-started.md", "state": ["early access"] }, diff --git a/site/src/pages/AgentsPage/AgentAnalyticsPageView.tsx b/site/src/pages/AgentsPage/AgentAnalyticsPageView.tsx index 79d9235040..f6aef93e41 100644 --- a/site/src/pages/AgentsPage/AgentAnalyticsPageView.tsx +++ b/site/src/pages/AgentsPage/AgentAnalyticsPageView.tsx @@ -24,7 +24,7 @@ export const AgentAnalyticsPageView: FC = ({
diff --git a/site/src/pages/AgentsPage/AgentSettingsBehaviorPageView.tsx b/site/src/pages/AgentsPage/AgentSettingsBehaviorPageView.tsx index 1c1bbbba8b..0bc3592a9f 100644 --- a/site/src/pages/AgentsPage/AgentSettingsBehaviorPageView.tsx +++ b/site/src/pages/AgentsPage/AgentSettingsBehaviorPageView.tsx @@ -249,7 +249,7 @@ export const AgentSettingsBehaviorPageView: FC< <> {/* ── Personal prompt (always visible) ── */}

- Applied to all your chats. Only visible to you. + Applied to all your conversations. Only visible to you.

Set a default autostop for agent-created workspaces that don't have one defined in their template. Template-defined autostop - rules always take precedence. Active chats will extend the stop - time. + rules always take precedence. Active conversations will extend + the stop time.

{ } serversData={serversQuery.data} isLoadingServers={serversQuery.isLoading} diff --git a/site/src/pages/AgentsPage/AgentSettingsProvidersPage.tsx b/site/src/pages/AgentsPage/AgentSettingsProvidersPage.tsx index 66e0de1c27..8b01925025 100644 --- a/site/src/pages/AgentsPage/AgentSettingsProvidersPage.tsx +++ b/site/src/pages/AgentsPage/AgentSettingsProvidersPage.tsx @@ -45,7 +45,7 @@ const AgentSettingsProvidersPage: FC = () => { } providerConfigsData={providerConfigsQuery.data} modelConfigsData={modelConfigsQuery.data} diff --git a/site/src/pages/AgentsPage/AgentSettingsUsagePageView.tsx b/site/src/pages/AgentsPage/AgentSettingsUsagePageView.tsx index 3356e535a6..d975085857 100644 --- a/site/src/pages/AgentsPage/AgentSettingsUsagePageView.tsx +++ b/site/src/pages/AgentsPage/AgentSettingsUsagePageView.tsx @@ -188,8 +188,8 @@ export const AgentSettingsUsagePageView: FC< label="Usage" description={ selectedUserId - ? "Review deployment chat usage for a specific user." - : "Review deployment chat usage and drill into individual users." + ? "Review deployment Coder Agents usage for a specific user." + : "Review deployment Coder Agents usage and drill into individual users." } badge={} action={ diff --git a/site/src/pages/AgentsPage/AgentsPageView.stories.tsx b/site/src/pages/AgentsPage/AgentsPageView.stories.tsx index 662be1d85a..1092329e19 100644 --- a/site/src/pages/AgentsPage/AgentsPageView.stories.tsx +++ b/site/src/pages/AgentsPage/AgentsPageView.stories.tsx @@ -611,7 +611,7 @@ export const OpensAnalyticsForAdmins: Story = { await waitFor(() => { expect( screen.getByText( - "Review your personal chat usage and cost breakdowns.", + "Review your personal Coder Agents usage and cost breakdowns.", ), ).toBeInTheDocument(); }); @@ -633,7 +633,7 @@ export const OpensAnalyticsForNonAdmins: Story = { await waitFor(() => { expect( screen.getByText( - "Review your personal chat usage and cost breakdowns.", + "Review your personal Coder Agents usage and cost breakdowns.", ), ).toBeInTheDocument(); }); @@ -650,7 +650,7 @@ export const OpensSettingsForAdmins: Story = { await waitFor(() => { expect( screen.getByText( - "Custom instructions that shape how the agent responds in your chats.", + "Custom instructions that shape how the agent responds in your conversations.", ), ).toBeInTheDocument(); }); @@ -670,7 +670,7 @@ export const OpensSettingsForNonAdmins: Story = { await waitFor(() => { expect( screen.getByText( - "Custom instructions that shape how the agent responds in your chats.", + "Custom instructions that shape how the agent responds in your conversations.", ), ).toBeInTheDocument(); }); @@ -688,7 +688,7 @@ export const SettingsViewResets: Story = { await waitFor(() => { expect( screen.getByText( - "Custom instructions that shape how the agent responds in your chats.", + "Custom instructions that shape how the agent responds in your conversations.", ), ).toBeInTheDocument(); }); @@ -698,13 +698,13 @@ export const SettingsViewResets: Story = { await waitFor(() => { expect( screen.getByText( - "Review deployment chat usage and drill into individual users.", + "Review deployment Coder Agents usage and drill into individual users.", ), ).toBeInTheDocument(); }); - // Go back to chats - const backButton = screen.getByLabelText("Back to chats"); + // Go back to conversations + const backButton = screen.getByLabelText("Back to Agents"); await userEvent.click(backButton); // Re-open settings, should reset to Behavior @@ -712,7 +712,7 @@ export const SettingsViewResets: Story = { await waitFor(() => { expect( screen.getByText( - "Custom instructions that shape how the agent responds in your chats.", + "Custom instructions that shape how the agent responds in your conversations.", ), ).toBeInTheDocument(); }); diff --git a/site/src/pages/AgentsPage/components/AgentCreateForm.stories.tsx b/site/src/pages/AgentsPage/components/AgentCreateForm.stories.tsx index 986026e956..14e6ee73ab 100644 --- a/site/src/pages/AgentsPage/components/AgentCreateForm.stories.tsx +++ b/site/src/pages/AgentsPage/components/AgentCreateForm.stories.tsx @@ -24,7 +24,7 @@ const mock403Error = Object.assign( statusText: "Forbidden", data: { message: "Forbidden.", - detail: "Insufficient permissions to create chat.", + detail: "Insufficient permissions to use Coder Agents.", }, headers: {}, config: {}, diff --git a/site/src/pages/AgentsPage/components/ChatAccessDeniedAlert.tsx b/site/src/pages/AgentsPage/components/ChatAccessDeniedAlert.tsx index 27a97ffc05..a12c204d9f 100644 --- a/site/src/pages/AgentsPage/components/ChatAccessDeniedAlert.tsx +++ b/site/src/pages/AgentsPage/components/ChatAccessDeniedAlert.tsx @@ -30,7 +30,7 @@ export const ChatAccessDeniedAlert: FC = () => { >

Permission required

- You don't have permission to create chats. Contact your Coder + You don't have permission to use Coder Agents. Contact your Coder administrator for access. Refresh this page after access has been granted.

diff --git a/site/src/pages/AgentsPage/components/ChatCostSummaryView.tsx b/site/src/pages/AgentsPage/components/ChatCostSummaryView.tsx index d5c9b1b959..3236e15ac6 100644 --- a/site/src/pages/AgentsPage/components/ChatCostSummaryView.tsx +++ b/site/src/pages/AgentsPage/components/ChatCostSummaryView.tsx @@ -298,10 +298,13 @@ export const ChatCostSummaryView: FC = ({
- +
- Chat + Conversation Cost Messages @@ -325,7 +328,7 @@ export const ChatCostSummaryView: FC = ({ {chat.chat_title || ( - Untitled chat + Untitled conversation )} diff --git a/site/src/pages/AgentsPage/components/ChatElements/tools/ChatSummarizedTool.tsx b/site/src/pages/AgentsPage/components/ChatElements/tools/ChatSummarizedTool.tsx index 3140400615..9f3f3e14c2 100644 --- a/site/src/pages/AgentsPage/components/ChatElements/tools/ChatSummarizedTool.tsx +++ b/site/src/pages/AgentsPage/components/ChatElements/tools/ChatSummarizedTool.tsx @@ -39,7 +39,7 @@ export const ChatSummarizedTool: React.FC<{ - {errorMessage || "Failed to summarize chat"} + {errorMessage || "Failed to summarize conversation"} )} diff --git a/site/src/pages/AgentsPage/components/ChatModelAdminPanel/ModelsSection.tsx b/site/src/pages/AgentsPage/components/ChatModelAdminPanel/ModelsSection.tsx index cc4ce45ff2..7cd702aec0 100644 --- a/site/src/pages/AgentsPage/components/ChatModelAdminPanel/ModelsSection.tsx +++ b/site/src/pages/AgentsPage/components/ChatModelAdminPanel/ModelsSection.tsx @@ -341,8 +341,8 @@ export const ModelsSection: FC = ({ {!modelConfig.enabled ? "Cannot set a disabled model as default" : modelConfig.is_default - ? "Pinned as default for new chats" - : "Pin as default for new chats"} + ? "Pinned as default for new conversations" + : "Pin as default for new conversations"} diff --git a/site/src/pages/AgentsPage/components/MCPServerAdminPanel.tsx b/site/src/pages/AgentsPage/components/MCPServerAdminPanel.tsx index 57b3785d66..2355c85018 100644 --- a/site/src/pages/AgentsPage/components/MCPServerAdminPanel.tsx +++ b/site/src/pages/AgentsPage/components/MCPServerAdminPanel.tsx @@ -64,7 +64,7 @@ const AVAILABILITY_OPTIONS = [ { value: "force_on", label: "Force On", - description: "Always injected into every chat session.", + description: "Always injected into every conversation.", }, { value: "default_on", @@ -158,7 +158,7 @@ const ServerList: FC = ({ label={sectionLabel ?? "MCP Servers"} description={ sectionDescription ?? - "Configure external MCP servers that provide additional tools for AI chat sessions." + "Configure external MCP servers that provide additional tools for Coder Agents." } badge={sectionBadge} action={ @@ -744,7 +744,7 @@ const ServerForm: FC = ({