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

# Setting up an AI Agent

> Configure your first Ravenna AI agent with rules, knowledge access, and tool integrations to automate ticket triage and answer common questions.

AI Agents are your customizable AI assistants that automate ticket creation, routing, and responses across your support channels. Create agents with specific rules, personalities, and capabilities to handle different types of requests.

<Tabs>
  <Tab title="Interactive walkthrough">
    <div style={{ position: 'relative', paddingBottom: 'calc(62.55208333333333% + 41px)', height: 0, width: '100%' }}>
      <iframe src="https://demo.arcade.software/qyRk8fL8W5QxNrS1C9Ih?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Create an AI Agent" frameBorder="0" loading="lazy" allowFullScreen allow="clipboard-write" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', colorScheme: 'light' }} />
    </div>
  </Tab>

  <Tab title="Step-by-step">
    <Steps>
      <Step title="Open Agents">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/1.png)
        </Frame>

        Click **Agents** in the left sidebar to access the Agents management area.
      </Step>

      <Step title="Create a new agent">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/2.png)
        </Frame>

        Click **New** to create a new agent.

        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/3.png)
        </Frame>

        Enter a name and description for your agent that reflects its purpose.
      </Step>

      <Step title="Upload an avatar">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/4.png)
        </Frame>

        Upload an avatar image to give your agent a visual identity. When you select an image, a cropping dialog appears where you can adjust the crop area to select the portion of the image you want to use.

        <Tip>
          **Image requirements**

          * **File formats:** PNG, GIF, or WebP only (required for Slack compatibility)
          * **Maximum file size:** 1MB
          * **Output size:** Images are automatically resized to 512x512 pixels
        </Tip>
      </Step>

      <Step title="Configure rules">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/5.png)
        </Frame>

        Add [rules](/documentation/automate/agents/overview#rules) to define how your agent handles specific scenarios. Rules use natural language to tell the agent when and how to respond. Use `@` mentions to reference [forms](/documentation/tickets/forms/custom-fields), [knowledge bases](/documentation/automate/knowledge/overview), and other resources.
      </Step>

      <Step title="Connect knowledge">
        Select which [knowledge folders](/documentation/automate/knowledge/overview) your agent should access when answering questions. Agents only have access to knowledge you explicitly grant them.
      </Step>

      <Step title="Set personality and appearance">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/6.png)
        </Frame>

        Customize your agent's personality, tone, response length, and emoji usage to match your brand voice. This determines how the agent communicates with users.
      </Step>

      <Step title="Deploy to channels">
        <Frame>
          ![Agents](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/ai-agents/7.png)
        </Frame>

        Deploy your agent to [channels](/integrations/slack/setup) where it will be active. Each channel can only have one agent assigned. The agent will respond to messages based on its configured rules and settings.
      </Step>

      <Step title="Test your agent">
        Send test messages to your channels to verify the agent responds correctly, uses the right [forms](/documentation/tickets/forms/custom-fields), and retrieves relevant information from your [knowledge bases](/documentation/automate/knowledge/overview).
      </Step>
    </Steps>
  </Tab>
</Tabs>