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

# Agents

> Configure and use AI agents to interact with your data

Agents are AI-powered assistants that can answer questions about your data, execute code, generate visualizations, and orchestrate multi-step workflows — all grounded in your verified enterprise data.

<Frame>
  <img src="https://mintcdn.com/corvicinc/E09Qw1MOZESGbjrM/images/agent-main-page.png?fit=max&auto=format&n=E09Qw1MOZESGbjrM&q=85&s=07a97c7293ca2d69c3dd60a6475899d2" alt="Corvic Agent chat interface with summary, skills, artifacts, and user files" width="2356" height="1368" data-path="images/agent-main-page.png" />
</Frame>

## Configuration

### Model Selection

Choose a completion model for your agent from the model dropdown, or let **Auto** pick the right model for you:

* **Auto** — automatically selects an appropriate model
* **Claude Sonnet 4.6**
* **Claude Opus 4.8**
* **GEMINI 2.5 Pro**
* **GPT 5.4**
* **Bring your own LLM** — add your own [LLM endpoints](/features/admin-console#llm-integrations) to bring your own models into Corvic

<Note>
  Custom LLM endpoints configured for your organization also appear in this list.
</Note>

The Agent tab also shows the **MCP Tools** connected to your agent (such as web search, file access, and database queries) and any **Corvic Apps** linked to the agent for data pipeline access.

### Skills, Artifacts & User Files

The agent sidebar provides quick access to key capabilities:

* **Summary** — A conversation summary that updates as you chat, with an audio summary option (coming soon)
* **Skills** — Reusable agent skills that extend what your agent can do. Add new skills by chatting with the agent itself, or use the "+" button to upload new skills.
* **Artifacts** — Outputs generated during conversations (tables, charts, code) are collected here for easy access
* **User Files** — Upload documents directly into the chat for the agent to process and use as context

### Agent Appearance

Customize how your agent looks and is described. Click on the agent name to open the Appearance settings, where you can configure:

* **Name & Description** — Give your agent a clear identity
* **Quick Start Video URL** — Link a video to help users get started
* **App Documentation URL** — Point users to relevant documentation
* **Color & Icon** — Choose a brand color and icon, or upload your own

## Chatting

Ask your agent a question in the chat input. The agent will orchestrate a chain of actions — querying tables, executing Python code, generating visualizations — to deliver a context-aware response grounded in your data.

<Note>
  Complex queries may take a minute or two as the agent reasons through multiple steps. You can watch the thought process unfold in real time.
</Note>

### Conversations & Threads

Each conversation with an agent is a **thread**. You can keep multiple threads per agent, rename them, and delete the ones you no longer need. Threads are addressable by URL, so you can return to — or share — any conversation.

Any thread can be published as a read-only public link, and the artifacts a thread produces can be shared individually. See [Sharing & Collaboration](/features/sharing) for details.

## Explainability

### Thought Process

Every agent response includes a transparent view of the reasoning chain. As the agent works, you can see each action it takes — listing tables, retrieving data, executing Python, generating plots — displayed as a step-by-step flow.

<Frame>
  <img src="https://mintcdn.com/corvicinc/E09Qw1MOZESGbjrM/images/agent-explainability-thoughtprocess.png?fit=max&auto=format&n=E09Qw1MOZESGbjrM&q=85&s=8e279cc7cdbe281f534cce1a1a246cb2" alt="Agent thought process showing chain of actions including list_tables, get_table, execute_python, and generate_vega_plot" width="793" height="1023" data-path="images/agent-explainability-thoughtprocess.png" />
</Frame>

### Action Output

Click on any action step to inspect its full output. For code execution steps, you can view the Python code that was run, the output variables, and the resulting data tables — giving you complete transparency into how the agent arrived at its answer.

<Frame>
  <img src="https://mintcdn.com/corvicinc/WrOJzBMmIXck5He1/images/agent-explainability-action-output.png?fit=max&auto=format&n=WrOJzBMmIXck5He1&q=85&s=8835c90d0c13a6370668f6310a960ed1" alt="Action output detail showing Python code execution and resulting data table" width="2266" height="1924" data-path="images/agent-explainability-action-output.png" />
</Frame>

## Sharing & Integration

### Sharing

Share your agent with teammates or external users from the **Integration & Sharing** dialog.

<Steps>
  <Step title="Open the Sharing tab">
    Open the "Integration & Sharing" dialog and select the **Sharing** tab.
  </Step>

  <Step title="Choose how to share">
    Use **Invite by Email** to send direct invitations and manage access roles, or **Share Link** to generate a shareable URL.
  </Step>

  <Step title="Restrict access (optional)">
    Add **Password Protection** to require a password before anyone can open the shared agent.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/corvicinc/E09Qw1MOZESGbjrM/images/agent-sharing.png?fit=max&auto=format&n=E09Qw1MOZESGbjrM&q=85&s=7552a9b6b8a6d074d6c214bfa5b36aaa" alt="Integration and Sharing dialog with email invite, share link, and password protection" width="822" height="795" data-path="images/agent-sharing.png" />
</Frame>

### MCP Integration

Integrate your agent directly into external applications using the MCP protocol.

<Steps>
  <Step title="Open the Integration tab">
    In the "Integration & Sharing" dialog, switch to the **Integration** tab.
  </Step>

  <Step title="Copy your credentials">
    Use the buttons to copy your **MCP URL** and **Access Token**.
  </Step>

  <Step title="Drop in a code snippet">
    Copy the ready-to-use **Python** or **Node.js** snippet and connect from your application.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/corvicinc/E09Qw1MOZESGbjrM/images/agent-mcp-integration.png?fit=max&auto=format&n=E09Qw1MOZESGbjrM&q=85&s=df5160157a7354ea1a2d0173b20c3b08" alt="MCP Integration tab showing Python and Node.js code snippets with Copy MCP URL and Copy Access Token" width="846" height="835" data-path="images/agent-mcp-integration.png" />
</Frame>

See our [integration guides](/integrations/overview) for detailed examples on connecting agents to your applications.

## Related Documentation

<CardGroup cols={2}>
  <Card title="Playbooks" icon="list-check" href="/features/playbooks">
    Run reusable, multi-stage plans the agent executes for you.
  </Card>

  <Card title="Spaces" icon="layer-group" href="/concepts/spaces">
    Learn about creating embedding spaces for agents.
  </Card>

  <Card title="Sharing & Collaboration" icon="share-nodes" href="/features/sharing">
    Share read-only chat threads and individual artifacts.
  </Card>

  <Card title="Workflows" icon="window" href="/features/workflows">
    Create agents using the Create Agent action in workflows.
  </Card>

  <Card title="API Secret Vault" icon="key" href="/features/api-secret-vault">
    Connect external APIs for your agents to call.
  </Card>

  <Card title="API Integrations" icon="plug" href="/integrations/overview">
    Integrate agents with your applications.
  </Card>

  <Card title="MCP API" icon="code" href="/integrations/mcp-api-integration">
    Connect agents via the MCP protocol.
  </Card>
</CardGroup>
