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

# Create and Manage AI Agents with Collate AI Studio

# Collate AI Studio

<iframe width="560" height="315" src="https://www.youtube.com/embed/L5Zd8T87KK0?si=Fs3EnYwE-JbZgjJ3" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

AI Studio allows you to create and manage AI agents and personas in the Collate Semantic Intelligence Platform. These agents help automate tasks such as metadata discovery, governance reviews, and data quality workflows.

AI Studio provides a UI experience where users can define how an agent behaves, what tools it can use, and what task it should perform.

## Access AI Studio

1. Open the left navigation menu
2. Select **Ask Collate**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio1.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=e69878c39fdca6b882a4700fb0662a4c" alt="Select Ask Collate from navigation menu" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio1.png" />

3. Click **AI Studio**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio2.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=3267bc701169937a5f3f33b591963ec5" alt="AI Studio main page" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio2.png" />

The AI Studio page displays both system agents and user-created agents. From here you can review existing agents or create a new one.

## Edit an Existing Agent

Collate includes system agents such as the documentation agent, tier agent, and data quality agent. You can review and update how these agents behave.

For example, you may want descriptions generated in a different language or change how detailed the responses are.

### Steps

1. Open the left navigation menu
2. Select **Ask Collate**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio1.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=e69878c39fdca6b882a4700fb0662a4c" alt="Select Ask Collate from navigation menu" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio1.png" />

3. Select **AI Studio**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio2.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=3267bc701169937a5f3f33b591963ec5" alt="AI Studio main page" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio2.png" />

4. Open an existing agent such as **Documentation Agent**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio16.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=166986c9c6647dd5a5746c2304571c3a" alt="Open existing agent" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio16.png" />

5. Review the persona, tools, and prompt used by the agent
6. Edit the prompt to change the behavior

**Example change:**

```
Write descriptions in Spanish for documentation updates.
```

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio17.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=7945fc8b7a7baea6f52544ceec81521c" alt="Edit agent prompt" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio17.png" />

7. Save the changes

The agent will now follow the updated instructions.

## Create an AI Agent

AI agents perform tasks based on a defined persona, selected tools, and a natural language prompt.

In this example, we create an agent to support a PII audit.

### Step 1: Create a New Agent

In AI Studio, click **New Agent**.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio3.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=c1ef8a2712c162c37e128f403dbcb510" alt="Click New Agent button" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio3.png" />

Enter a name and description and then click on **Save and Next**.

**Example:**

* **Name:** PII Audit Agent
* **Description:** Supports PII audit and metadata review

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio4.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=df89826cecd5f09f7cf9618259b14c79" alt="Enter agent name and description" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio4.png" />

### Step 2: Select a Persona

Choose a persona that defines the agent’s role and expertise.

For this example, select **Data Steward** and save.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio5.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=88e1eb98616101a10df1d6f0727da9e5" alt="Select persona for agent" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio5.png" />

<Info>
  System personas include curated knowledge and responsibilities. They help the agent understand how to approach tasks such as governance or documentation.
</Info>

### Step 3: Select Agent Tools

Choose the capabilities the agent needs.

For a PII audit, select:

* **Metadata Management**
* **Discovery and Search**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio6.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=8a13bb039303948fe39a45e6ee11c9a2" alt="Select agent tools" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio6.png" />

These tools allow the agent to explore assets and work with metadata.

### Step 4: Define the Task

Provide a natural language prompt describing what the agent should do.

**Example prompt:**

```
Help identify assets relevant to a PII audit. Search metadata and review related data assets.
```

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio7.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=806bfc191fc0376d8146669b7f847956" alt="Define agent task prompt" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio7.png" />

This prompt becomes the default instruction for the agent.

### Step 5: Select a Bot

Choose the application bot that will execute the agent actions.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio8.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=3a902a69c2e0a416c983e07be5606e97" alt="Select bot for agent" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio8.png" />

<Warning>
  Bots act as service accounts and control what the agent can access and modify. The permissions of the bot define the guardrails for the agent.
</Warning>

For more details, see [Roles Based Access Control (RBAC)](/how-to-guides/admin-guide/roles-policies/authorization#roles-based-access-controls-rbac-search).

### Step 6: Save the Agent

Click **Save** to create the agent.

The agent now appears in the AI Studio agent list. You can now use this agent in Ask Collate or interact with it programmatically using the AI SDK.

See [AI SDK documentation](/sdk/ai-sdk) to learn how to send requests to this agent from applications and automation workflows.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio9.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=9d9e0f9500638f2ed47121ab7e3a1a22" alt="Agent created successfully" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio9.png" />

## Create a Custom Persona

Personas define how an agent thinks and behaves. If system personas do not meet your needs, you can create your own.

### Step 1: Open Personas

1. Go to **AI Studio**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio2.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=3267bc701169937a5f3f33b591963ec5" alt="AI Studio main page" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio2.png" />

2. Select the **Personas** tab

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio10.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=55ad172441bc2ba977eb3edce74b0860" alt="Personas tab in AI Studio" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio10.png" />

This page shows system personas and user-created personas.

### Step 2: Create a New Persona

Click **New Persona**.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio11.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=1df69422e6f7288a24e14c6ba25ad266" alt="Click New Persona button" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio11.png" />

Provide the following information:

* **Name**
* **Description**
* **Detailed prompt**

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio12.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=3cdfb13c34b52c74fa517e9ee7438f85" alt="Enter persona details" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio12.png" />

The prompt should describe the role, expertise, and responsibilities of the persona.

### Step 3: Save the Persona

Click **Save**.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio14.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=5df53553b14870dffd4cf495c6898290" alt="Save persona" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio14.png" />

The persona can now be selected when creating new agents.

<img src="https://mintcdn.com/collatedocs/-dRT-EyJMn8W9j1m/public/images/collate-ai/ai-studio15.png?fit=max&auto=format&n=-dRT-EyJMn8W9j1m&q=85&s=56c619218dd0b3bbb238ab47d9fdd43c" alt="select persona when creating new agents" width="4024" height="1911" data-path="public/images/collate-ai/ai-studio15.png" />

## System and Custom Agents

<iframe width="560" height="315" src="https://www.youtube.com/embed/qpjlnTeizWM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

AI Studio includes two types of agents:

### System Agents

Built into the platform and support tasks such as documentation, tiering, and data quality.

### Custom Agents

Created by users to automate specific workflows.

## Interact with Agents Using AI SDK

Agents created in AI Studio can also be used in applications through the AI SDK.

The AI SDK allows developers to send natural language requests to Collate agents and receive responses that use the platform metadata context.

**Example use cases:**

* Automating governance checks
* Generating data reports
* Supporting GDPR or compliance workflows
* Integrating Collate intelligence into internal AI systems

The SDK can be used with languages such as Python, TypeScript, or Java.

## Best Practices

* Choose a persona that matches the role of the agent
* Enable only the tools needed for the task
* Write prompts in clear natural language
* Assign the correct bot to control access and permissions
