> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-ketanyekale-eng-37953-docs-gap-ios-refre.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Builder

> Create, configure, and launch AI agents directly inside CometChat.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-ketanyekale-eng-37953-docs-gap-ios-refre/jn-NC36jtF8NOSMe/images/cometchat-agent-builder.png?fit=max&auto=format&n=jn-NC36jtF8NOSMe&q=85&s=93169c51d8d36f351fdf230dd5958858" alt="CometChat Agent Builder" width="1441" height="801" data-path="images/cometchat-agent-builder.png" />
</Frame>

<div className="mt-8 mb-8 max-w-[70rem] mx-auto px-5">
  ## Overview

  Agent Builder provides the capability to create, configure, and customize AI agents directly within CometChat. It supports selecting models, integrating ready-to-use tools, APIs, and MCPs, and deploying agents without relying on any external management or orchestration platforms.

  <Note>
    **1:1 and group conversations.** AI Agents work in both one-on-one and group conversations. In a 1:1 chat, the end user talks directly with the agent user. In a group, the agent participates as a member — its messages are delivered and attributed like any other member's message. If the group contains only one user and one agent, the agent responds automatically. In groups with more than two members, the agent only responds when @mentioned.
  </Note>

  ## Getting Started

  ### How to create an agent – step-by-step guide

  <Steps className="mt-6">
    <Step title="Create or open an app" description="Set the foundation.">
      <p className="text-gray-600 dark:text-gray-300">
        Sign in at <a href="https://app.cometchat.com" target="_blank" rel="noreferrer">CometChat Dashboard ↗</a>. Create a new app or open an existing one where the agent will live.
      </p>
    </Step>

    <Step title="Navigate to Agent Builder" description="Access the workspace.">
      <p className="text-gray-600 dark:text-gray-300">
        From the dashboard, go to <strong>AI Agent → Agent Builder</strong> and select <strong>Add AI Agent</strong>.
      </p>
    </Step>

    <Step title="Fill in agent details" description="Define the basics.">
      <p className="text-gray-600 dark:text-gray-300">Provide the required metadata before you can create the agent:</p>

      <ul className="list-disc list-inside text-gray-600 dark:text-gray-300 mt-3">
        * **Agent Name** - enter a clear, memorable name.
        * **Icon URL** - supply an image URL for the agent avatar.
        * **Description** - describe the agent’s purpose so teammates can recognise it later.
      </ul>

      Click <strong>Add</strong> once all required fields are complete. Agent Builder redirects you to the configuration page where you can connect models, instructions, tools, and MCP endpoints.
    </Step>

    <Step title="Configure the agent" description="Set up capabilities.">
      <p className="text-gray-600 dark:text-gray-300">
        After creation, configure instructions, tools, and MCPs from the left-hand tabs. Detailed guidance lives in the <a href="/ai-agents/agent-builder/instructions">Instructions</a>, <a href="/ai-agents/agent-builder/tools/overview">Tools</a>, and <a href="/ai-agents/agent-builder/mcp/overview">MCP</a> sections.
      </p>
    </Step>
  </Steps>

  ## Advanced Configuration

  ### Instructions

  * Instructions define how your agent behaves, what it knows, and how it should respond. Use them to set tone, outline guardrails, and describe hand-off rules.
  * The instructions editor supports `@` mentions so you can reference specific tools and MCP resources inline—this gives the agent unambiguous guidance about when to invoke each capability.

  ### Tools and MCPs

  * Attach tools for deterministic actions (custom APIs, Google Suite, or other integrations) and link MCP endpoints for richer context.
  * You can embed any of these capabilities directly inside instructions using the `@` menu, ensuring the agent knows exactly when and how to rely on them.
</div>