> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Configuration

> Scope each agent's builtin tools, connections, and custom instructions from the Agents page

Configure what each agent can use and how it behaves from [Agents](https://app.cloudthinker.io/agents) in the CloudThinker console. Click an agent to open the **Agent Settings** dialog.

## Prerequisites

* Workspace admin permissions — [members](/guide/workspace-users) can chat with agents but can't edit them
* At least one [connection](/guide/connections/overview) in your workspace

## Settings tabs

<Frame>
  <img src="https://mintcdn.com/cloudthinker/U5K1Omsn5IZLCI4L/images/agents/agent-settings.png?fit=max&auto=format&n=U5K1Omsn5IZLCI4L&q=85&s=e170f508f44e9e6594093f71388856a5" alt="Agent Settings" width="1758" height="910" data-path="images/agents/agent-settings.png" />
</Frame>

The **Agent Settings** dialog has three tabs:

| Tab               | What it controls                                   |
| ----------------- | -------------------------------------------------- |
| **Builtin Tools** | Which builtin tools the agent can use              |
| **Connections**   | Which connections the agent can access             |
| **Instructions**  | Custom behavior, context, and operating guidelines |

## Enable or disable an agent

<Steps>
  <Step title="Open the Agents page">
    Go to [Agents](https://app.cloudthinker.io/agents) in the CloudThinker console.
  </Step>

  <Step title="Toggle the agent">
    Use the **Enable/Disable** toggle to activate or deactivate the agent.
  </Step>
</Steps>

Disable an agent to limit your workspace to specific domains, reduce noise during focused work, or restrict access during maintenance.

## Configure builtin tools

<Steps>
  <Step title="Select the agent">
    Go to [Agents](https://app.cloudthinker.io/agents) and click the agent.
  </Step>

  <Step title="Open the Builtin Tools tab">
    Select **Builtin Tools** in the Agent Settings dialog.
  </Step>

  <Step title="Check or uncheck tools">
    Enable only the tools this agent needs.
  </Step>
</Steps>

| Tool                      | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| **Create Memory**         | Store information for future reference                       |
| **Fetch URL**             | Retrieve content from web URLs                               |
| **Planning**              | Create and manage action plans                               |
| **Push Alert**            | Send alert notifications                                     |
| **Recommendation**        | Generate actionable recommendations                          |
| **Search Internet**       | Search the web for information                               |
| **Search Knowledge Base** | Query your organization's [knowledge base](/guide/knowledge) |

## Assign connections

<Steps>
  <Step title="Select the agent">
    Go to [Agents](https://app.cloudthinker.io/agents) and click the agent.
  </Step>

  <Step title="Open the Connections tab">
    Select **Connections** in the Agent Settings dialog.
  </Step>

  <Step title="Select connections">
    Choose which connections this agent can use, then save.
  </Step>
</Steps>

<Tip>
  Assign each agent only the connections its role requires. [Tony](/guide/agents/tony) doesn't need production IAM access to tune databases.
</Tip>

| Agent                          | Recommended connections                       |
| ------------------------------ | --------------------------------------------- |
| [Alex](/guide/agents/alex)     | All cloud provider accounts                   |
| [Oliver](/guide/agents/oliver) | Cloud accounts + security monitoring services |
| [Tony](/guide/agents/tony)     | Database connections + monitoring tools       |
| [Kai](/guide/agents/kai)       | Kubernetes clusters + observability platforms |
| [Anna](/guide/agents/anna)     | All connections (for coordination)            |

## Set custom instructions

<Steps>
  <Step title="Select the agent">
    Go to [Agents](https://app.cloudthinker.io/agents) and click the agent.
  </Step>

  <Step title="Open the Instructions tab">
    Select **Instructions** in the Agent Settings dialog.
  </Step>

  <Step title="Write the instructions">
    Cover three areas: role context (expertise for your environment), scope limits (what the agent should and shouldn't access), and operational guidelines (procedures and escalation paths).
  </Step>
</Steps>

Example:

```text theme={null}
You are Alex, the Cloud Engineer for Acme Corp.

Environment:
- Primary cloud: AWS (us-east-1, us-west-2)
- Secondary cloud: GCP (for ML workloads)
- Cost target: Reduce by 20% this quarter

Guidelines:
- Always check with @oliver before recommending security group changes
- Prioritize production stability over cost savings
- Flag any resource costing >$1000/month for review
```

## Next steps

<CardGroup cols={2}>
  <Card title="Customize Agents" icon="wand-magic-sparkles" href="/guide/agents/customize">
    Edit identity, language, and learning mode, or build your own agent
  </Card>

  <Card title="Approval" icon="shield-check" href="/guide/approval">
    Configure tool approval workflows
  </Card>
</CardGroup>