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

# Kapso Agent

> A conversational agent that builds, inspects, and manages your project from the dashboard, the API, or Slack.

Kapso Agent operates your project for you: it inspects APIs and logs, builds workflows, configures the inbox, manages templates and WhatsApp Flows, and investigates findings.

> Kapso Agent is the project-level agent in the dashboard. It is not the [agent step](/docs/flows/step-types/agent-node) inside a workflow, which handles end-user conversations.

<div style={{ position: 'relative', paddingBottom: '62.1875%', height: 0 }}>
  <iframe style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} src="https://www.tella.tv/video/vid_cmtbntodg00ub0ajgadcvaqt1/embed?b=0&title=0&a=1&loop=0&t=0&muted=0&wt=0&o=0" title="Build a workflow using Kapso Agent" allow="autoplay; fullscreen" allowTransparency />
</div>

## Where it runs

* **Project home** - the home page opens on the Agent view with your recent sessions.
* **Agent panel** - a side panel available on every project page. Pages like Logs and Findings can pre-fill a prompt with the thing you're looking at.
* **Inbox** - the inbox has its own Agent sidebar.
* **Slack** - mention the agent in a connected channel or message it directly. See [Slack integration](/docs/kapso-agent/slack).
* **API** - trigger runs programmatically and receive lifecycle events through project webhooks. See [Agent API](/docs/kapso-agent/api).

## Sessions and runs

A session is a conversation with the agent. Each request inside a session is a run.

Run statuses: `queued`, `running`, `paused`, `waiting_for_approval`, `completed`, `failed`, `cancelled`.

One run executes at a time per session. Messages sent while a run is active wait in a queue - you can send a waiting message to the active run right away or remove it. Runs can be paused, resumed, or cancelled while active.

For multi-step work the agent creates a plan and keeps it updated as it progresses. Simple questions and single-tool operations run without one.

## Models

Every session starts on the mode's default model. Change the model and reasoning effort with the selector in the chat - reasoning effort is available for models that support it. [Custom modes](/docs/kapso-agent/modes) fix the model, so the selector is locked to the mode's configuration.

In Slack, the default mode, model, and reasoning effort come from **Integrations → Slack**. Runs triggered through the [API](/docs/kapso-agent/api) use the mode's configured model - there's no model parameter.

## Approvals

Tool calls with side effects ask for approval before executing. Which tools need it depends on the mode's [capabilities](/docs/kapso-agent/modes#capabilities). In Slack, the **Tool approvals** setting can turn approvals off for a project.

## Settings

Configure the agent under **Kapso Agent** in your project:

* **Resources** - MCP connections, GitHub repositories, and encrypted environment variables the agent can use. See [Resources](/docs/kapso-agent/resources).
* **Modes** - built-in and custom modes. See [Modes](/docs/kapso-agent/modes).
* **Sessions**, **Runs**, **API requests** - execution activity, live run traces, per-run AI cost, and a 30-day history of Platform API requests made by the agent.

## Billing

Agent runs consume your project's AI credits. Each run and session shows its AI cost. When credits run out, runs stop with "Not enough AI credits" until you add more.

## Next steps

<CardGroup cols={2}>
  <Card title="Resources" icon="plug" href="/docs/kapso-agent/resources">
    Connect tools, repositories, secrets, and sandboxes.
  </Card>

  <Card title="Modes" icon="layer-group" href="/docs/kapso-agent/modes">
    Built-in modes and how to create custom ones.
  </Card>

  <Card title="Slack integration" icon="slack" href="/docs/kapso-agent/slack">
    Run the agent from your Slack workspace.
  </Card>

  <Card title="Agent API" icon="code" href="/docs/kapso-agent/api">
    Trigger runs and receive lifecycle webhooks.
  </Card>
</CardGroup>