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

# Airia Catalog Interface

> Set up your agent interface for the Airia platform for public discovery and interaction

The Airia Catalog interface makes your agent available in the Airia catalog where users can discover and interact with it.

<Note>
  Looking for Chat Widget (embeddable chat)? See [Chat Widget Interface](/building-and-deploying-agents/interface-options/chat-widget).

  For an overview of managing all interface types, see [Managing Agent Interfaces](/building-and-deploying-agents/interface-options/managing-interfaces).
</Note>

## Key Features

### Public Discovery

* **Agent Directory**: Automatic inclusion in the Airia agent catalog
* **Search & Browse**: Users can find your agent through search and category browsing
* **Featured Placement**: Opportunity for featured placement based on quality and usage

### User Engagement

* **Usage Analytics**: Monitor how users interact with your agent
* **Feedback Collection**: Receive user feedback to improve your agent

### Configuration Inheritance

* **Smart Defaults**: Inherits name and description from your agent unless overridden
* **Active Version**: Always executes against your agent's Active version
* **Independent Control**: Can be taken offline without affecting other interfaces

## Configuration Steps

<Steps>
  <Step title="Access the Interfaces Panel" stepNumber={1}>
    Access the interfaces panel by either:

    * Clicking the **ellipsis (…)** menu to the right of your Agent and selecting **Interfaces**
    * Opening the Agent in Studio and clicking **Settings > Interfaces**
  </Step>

  <Step title="Add Airia Catalog Interface" stepNumber={2}>
    In the interfaces panel:

    * Click **+ Add Interface** if this is a new interface
    * Select **Airia Catalog** from the available interface types
    * Or click the edit icon next to an existing Airia Catalog interface to modify its configuration
  </Step>

  <Step title="Configure Interface Settings" stepNumber={3}>
    Configure the following settings for your Airia Catalog interface:

    * **Display Name**\
      *This is how users will see and identify your agent in the Airia catalog. By default, inherits the agent's name unless overridden.*

    * **Description**\
      *Provide a clear description of what your agent does. By default, inherits the agent's description unless overridden.*

    * **Default User Prompts**\
      *(Optional) Predefine example prompts that help users understand how to interact with your agent.*

    * **Associated Video**\
      *(Optional) Link a video that introduces your agent or explains its capabilities. Supports publicly accessible youtube and vimeo links.*

    * **Permissions**\
      *Configure who can access your agent in the Airia catalog. Configuring for **Private** access allows you to limit to explicit users or entire user groups.*

    * **Conversation Type**\
      *Choose the type of interaction your agent supports:*\
      **Standard Chat** (Recommended): Text-based conversations with rich text and upload capabilities.\
      **Image Only**: Accepts a single image as input\
      **File Only**: Accepts a single file as input

    * **Supported Input Modes**\
      *Enable end users to provide context to agents beyond just text.*\
      **File Upload**: Supports directly providing images, csvs, pdfs, and more from the user's device.\
      **Whiteboard**: Construct custom images on the fly - include hand drawings, flow diagrams, and annotated images.\
      **Code**: Insert code blocks and specify the language.\
      **Math**: Opens calculator to enable drafting complex math formulas

    * **Support for Citations and Artifacts**\
      *Customize agent reponse formatting to enhance conversations where users are building documents or referencing specialized data sources.*\
      **Artifacts**: Enables inline file creation with versioning (Word docs, PowerPoints, HTML)\
      **Citations**: Highlights citations from documents or PDFs\\

    * **Categories**\
      *Add labels and categories to help users discover your agent in the platform.*

          <Note>
            If a Department is set on the agent, it will automatically be added as a category.
          </Note>
  </Step>

  <Step title="Save Configuration" stepNumber={4}>
    Click **Save** to activate your Airia Catalog interface. You will see a confirmation that the interface has been successfully configured.

    <Info>
      Your agent will now be available in the Airia platform. Users can find it by navigating to the Agents tab in Airia Chat.
    </Info>
  </Step>
</Steps>

## Managing Your Airia Catalog Interface

### Updating Your Agent

* **Version Control**: Interface automatically uses your agent's Active version
* **Content Updates**: Update descriptions, prompts, or categories as needed

### Best Practices

* **Clear Description**: Write a concise, informative description of your agent's capabilities
* **Example Prompts**: Provide 3-5 example prompts that showcase your agent's abilities
* **Regular Updates**: Keep your agent's Active version current with improvements
* **Respond to Feedback**: Monitor user reviews and iterate based on feedback

## Troubleshooting

<AccordionGroup>
  <Accordion title="How do I ensure my Airia Catalog Interface uses the correct version?">
    All interfaces execute against the **Active version** of your agent. To ensure your Airia Catalog Interface uses the latest version:

    1. Navigate to your agent in the agent list
    2. Verify the Agent shows the correct **Active Version**
    3. If an update is required:
       * Go into the Agent
       * Select the version number in the top left
       * Click **Set Active**
       * Return to the agent list

    Your Airia Catalog interface will automatically use the updated Active version.
  </Accordion>

  <Accordion title="Why can't users find my agent in Airia Chat?">
    If your Airia Catalog Interface isn't appearing in the platform:

    * **Access Control**: Check that access settings allow the appropriate users to see the agent
    * **Save Status**: Confirm the interface configuration was saved successfully
    * **Categories**: Make sure you've assigned relevant categories for discoverability
  </Accordion>

  <Accordion title="How do I improve my agent's discoverability?">
    To help users find your Airia Catalog Interface:

    * **Clear Naming**: Use descriptive, searchable names
    * **Relevant Categories**: Assign appropriate categories that users would search for
    * **Good Description**: Write a clear description that explains your agent's purpose and capabilities
  </Accordion>

  <Accordion title="Can I have both Airia Catalog and Chat Widget for the same agent?">
    Yes! You can configure multiple interface types simultaneously:

    * **Airia Catalog**: For public discovery in the Airia platform
    * **Chat Widget**: For embedding in your own websites or applications
    * **API Interface**: For programmatic access

    Each interface can be configured and managed independently, allowing you to provide multiple access methods for different user scenarios.
  </Accordion>
</AccordionGroup>