Looking for Chat Widget (embeddable chat)? See Chat Widget Interface.For an overview of managing all interface types, see Managing Agent Interfaces.
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
1
Access the Interfaces Panel
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
2
Add Airia Agent Interface
In the interfaces panel:
- Click + Add Interface if this is a new interface
- Select Airia Agent from the available interface types
- Or click the edit icon next to an existing Airia Agent interface to modify its configuration
3
Configure Interface Settings
Configure the following settings for your Airia Agent 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.If a Department is set on the agent, it will automatically be added as a category.
4
Save Configuration
Click Save to activate your Airia Agent interface. You will see a confirmation that the interface has been successfully configured.
Your agent will now be available in the Airia platform. Users can find it by navigating to the Agents tab in Airia Chat.
Managing Your Airia Agent
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
How do I ensure my Airia Agent uses the correct version?
How do I ensure my Airia Agent uses the correct version?
All interfaces execute against the Active version of your agent. To ensure your Airia Agent uses the latest version:
- Navigate to your agent in the agent list
- Verify the Agent shows the correct Active Version
- 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
Why can't users find my agent in Airia Chat?
Why can't users find my agent in Airia Chat?
If your Airia Agent 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
How do I improve my agent's discoverability?
How do I improve my agent's discoverability?
To help users find your Airia Agent:
- 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
Can I have both Airia Agent and Chat Widget for the same agent?
Can I have both Airia Agent and Chat Widget for the same agent?
Yes! You can configure multiple interface types simultaneously:
- Airia Agent: For public discovery in the Airia platform
- Chat Widget: For embedding in your own websites or applications
- API Interface: For programmatic access