> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/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/lHAbZ74NvVn9xgmq/images/cometchat-agent-builder.png?fit=max&auto=format&n=lHAbZ74NvVn9xgmq&q=85&s=06b5a39f53e973f9ad07dca36255ce98" 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.

  ## 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="/docs/ai-agents/agent-builder/instructions">Instructions</a>, <a href="/docs/ai-agents/agent-builder/tools/overview">Tools</a>, and <a href="/docs/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>