> ## 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

> Configure agent settings, tools, connections, and instructions for CloudThinker AI agents

Manage agent settings at [Agents](https://app.cloudthinker.io/agents) in the CloudThinker console. Click on any agent to open the settings modal.

***

## Why Agent Configuration Matters

Out of the box, agents can access everything you've connected — which is powerful but sometimes too broad. A developer working on database performance doesn't need [Tony](/guide/agents/tony) to also have access to production IAM roles. A security audit workflow needs [Oliver](/guide/agents/oliver) to have access to CloudTrail logs that other agents don't need.

Agent configuration lets you scope each agent's capabilities to match how your team actually works:

* **Restrict access**: limit [Tony](/guide/agents/tony) to only database [connections](/guide/connections/overview); limit [Oliver](/guide/agents/oliver) to security-relevant services
* **Customize behavior**: inject company-specific context, policies, and escalation paths directly into agent instructions
* **Control autonomy**: choose which tools each agent can use independently vs. requiring approval

This is the difference between an AI agent that operates in your specific environment vs. one that gives generic cloud advice.

<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 modal has three tabs:

* **Builtin Tools**: Select which tools the agent can use
* **Connections**: Assign which connections the agent can access
* **Instructions**: Customize agent behavior with custom instructions

***

## Enable/Disable Agents

Control which agents are active in your workspace:

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

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

**When to disable an agent:**

* Limit scope to specific domains (e.g., only database operations)
* Reduce noise during focused operations
* Temporarily restrict access during maintenance

***

## Builtin Tools

Select which builtin tools each agent can use:

| 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 |

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

  <Step title="Open Builtin Tools Tab">
    Select the **Builtin Tools** tab
  </Step>

  <Step title="Configure Tools">
    Check or uncheck tools to enable or disable them for this agent
  </Step>
</Steps>

***

## Assign Connections

Control which [connections](/guide/connections/overview) each agent can access:

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

  <Step title="Open Connections Tab">
    Select the **Connections** tab
  </Step>

  <Step title="Manage Connections">
    Select which connections this agent can use
  </Step>

  <Step title="Save Changes">
    Save your configuration
  </Step>
</Steps>

**Recommended Assignments:**

| 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)            |

***

## Agent Instructions

Customize agent behavior through custom instructions:

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

  <Step title="Open Instructions Tab">
    Select the **Instructions** tab
  </Step>

  <Step title="Set Instructions">
    Define custom behavior:

    * **Role context**: Specific expertise for your environment
    * **Scope limits**: What the agent should/shouldn't access
    * **Operational guidelines**: Procedures and escalation paths
  </Step>
</Steps>

### Example Instructions

```
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
```

***

## Related

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/guide/agents">
    Learn about the five specialized agents
  </Card>

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