---
title: "Airia Catalog Interface"
description: "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>