Skip to main content

​
Sharing Agents

Agent sharing enables you to distribute agent templates to other tenants or users for their own building and customization journey. Whether collaborating with your team, delivering solutions to clients, or contributing to the broader community, sharing provides the foundation for others to build upon your work.
Looking to give users access to interact with your agent? That’s handled through Agent Interfaces.

​
What Gets Shared

When you share an agent, you’re sharing the agent template - the building blocks others need to create their own version:
  • Agent configuration, prompts, and instructions
  • Variables and customization options
  • Tool integrations and flow logic
  • Interface settings and deployment patterns
Security: Sensitive data stored as credentials is automatically replaced with placeholders. However, you must manually review your agent before sharing to protect:
  • Sensitive information in Python code blocks
  • Hard-coded values in user-defined tool properties
  • Tool configurations that don’t utilize credentials for storing sensitive information
Recipients will configure their own credentials and data sources, ensuring each deployment remains isolated and secure.

​
Sharing Methods

The Airia platform offers two distinct approaches for sharing agent templates, each designed for different distribution needs:

​
Direct Sharing

Direct control over template distribution through private links or file export. Private Share Links generate secure, one-time use URLs that expire in 7 days - perfect for quick, tracked sharing with specific individuals. No file downloads required. Export to File creates portable JSON files you can distribute through any method - ideal for offline transfers, backups, air-gapped environments, or when you need complete control over the distribution channel. Learn more about Direct Sharing →

​
Community Sharing

Contribute templates to the public Airia Community after review. Make your agent templates available to the entire Airia ecosystem through the Community platform. Templates undergo a review process (typically 5-7 business days) before becoming publicly available to all users. Learn more about Community Sharing →

​
Choosing the Right Method

Select the sharing approach that best fits your use case:
MethodUse CaseDistributionAccess ControlBest For
Private Share LinksQuick, secure sharingDirect URLOne-time use, expires in 7 daysSharing with specific individuals or teams
Export to FileOffline/manual transferFile download & uploadManual distribution controlBackups, air-gapped environments, client deliveries
Community SharingPublic contributionCommunity platformPublic access after reviewSharing with broader community, templates

​
Getting Started

Choose the approach that best fits your needs:
  1. Direct Sharing - For controlled distribution using private share links or file export
  2. Community Sharing - For broader community impact and public collaboration

​
Frequently Asked Questions

Yes, that’s the purpose of sharing agent templates. Recipients import the template into their own environment where they have complete control to:
  • Modify prompts and instructions
  • Adjust variables and configurations
  • Connect their own tools and data sources
  • Deploy with their own credentials
Your original agent remains unchanged. Each import creates an independent copy in the recipient’s environment.
If you encounter issues when exporting or sharing an agent:
  1. Verify Published Agent Version - All sharing is performed based on the actively published agent version. If the steps don’t appear as expected, verify you have published the intended version.
  2. Check for Unsupported Features - We’re continually expanding supported features. If specific functionality isn’t yet supported for export, you’ll receive a notification
If problems persist, contact support with details about the agent and any error messages received. We’re continuously improving export capabilities based on user feedback.
If you want users to interact with your agent (chat, submit requests, etc.) rather than receiving the template for building, use Agent Interfaces instead.Interfaces allow you to expose agent functionality through:
  • Chat interfaces for direct conversations
  • API endpoints for programmatic access
  • Slack bots, browser extensions, and other deployment methods
With interfaces, users interact with YOUR deployed agent - they don’t receive a copy of the template.
Make your agent template easy to understand and customize by documenting it properly:Annotations (Notes) on the Canvas - Add notes directly to your agent canvas to guide recipients:
  • Explain the purpose of specific sections or logic flows
  • Highlight setup requirements or dependencies
  • Call out areas that need customization
  • Provide context for complex decision points
Agent Description - Use the Description field in your agent’s settings (supports rich text formatting) to document:
  • Overall purpose and use cases
  • Required credentials or integrations to configure
  • Variables that should be customized
  • Expected behavior and example interactions
  • Any limitations or special considerations
Well-documented agents are more likely to be successfully adopted and customized by recipients.