Share Your Agent Directly
Direct sharing gives you control over agent distribution through private share links or file export. Both methods are ideal for controlled sharing within teams, with clients, or across different environments.Comparing Your Options
| Feature | Private Share Links (Early Access) | Export to File |
|---|---|---|
| Best For | Quick sharing with specific people | Offline transfers, backups, archival |
| Distribution | Direct URL (no downloads) | File download & upload required |
| Setup Required | None - just share the link | Manual file transfer |
| Expiration | 7 days | No expiration |
| Usage Limits | One-time use | Unlimited reuse |
| Tracking | Built-in access logs | Manual tracking |
| Revocation | Can deactivate anytime | Cannot revoke after sharing |
| Internet Required | Yes | No (offline capable) |
Exporting Your Agent
All sharing starts with exporting your agent. Choose the method that fits your distribution channel.Active Version Required: All exports use your agent’s active published version. Verify you’ve published the intended version before exporting.
Accessing Export Options
You can access export functionality from two locations: From Agents List:- Click the action menu (three dots) on the target agent
- Select Export Agent
- Open your agent in the studio
- Open Version History panel
- Click the action menu on the Active Published version
- Select Export Agent
Use Cases
Team Collaboration
Team Collaboration
Sharing agents across your organization
Private Links - Best for
- Quick sharing between team members
- Tracking which teams accessed agents
- Time-sensitive distributions
- Ensuring one-time access
Files - Best for
- Distributing templates to multiple teams
- Creating a library of reusable agents
- Backup copies for team repositories
- Long-term template storage
Client Delivery
Client Delivery
Delivering agent solutions to external clients
Private Links - Best for
- Controlled initial delivery
- Single-recipient handoff
- Tracking delivery confirmation
- Quick proof-of-concept sharing
Files - Best for
- Formal project deliverables
- Documentation packages
- Multi-environment deployments
- Contract fulfillment requirements
Backup and Migration
Backup and Migration
Protecting and moving agents
Private Links - Best for
- Quick emergency backup sharing
- Temporary cross-environment testing
- Sharing with support teams
Files - Best for
- Regular backup schedules
- Long-term archival storage
- Platform migrations
- Version control systems
- Disaster recovery plans
Best Practices
Before Exporting
Before Exporting
- Test the agent thoroughly in your environment
- Verify it’s the correct version (publish if needed)
- Review for sensitive data in code blocks and tool properties
- Document setup requirements and dependencies
- Add canvas annotations and agent description
For Private Share Links
For Private Share Links
For Export to File
For Export to File
File Security:
- Store exported files in secure, access-controlled locations
- Use encryption for sensitive agent configurations
- Implement version control for agent files
- Track file distribution to recipients
- Use secure transfer methods (encrypted email, VPN, secure file share)
- Include README or setup documentation with files
- Verify file integrity after transfer
- Confirm successful import with recipients
- Use descriptive, version-dated filenames (e.g.,
customer-support-agent-v1.2-2025-11-12.json) - Maintain organized directory structure
- Document export purposes and recipients
- Archive old versions systematically
For Recipients
For Recipients
Pre-Import:
- Verify the source is trusted
- Ensure platform compatibility
- Prepare required credentials before importing
- Review any provided documentation
- Complete all configuration steps before deploying
- Test thoroughly in a non-production environment first
- Document any customizations you make
- Keep your own backup copy
- Audit agent configurations before deployment
- Validate tool permissions are appropriate
- Ensure credentials are properly secured
- Review prompts for any embedded sensitive data
Frequently Asked Questions
Can I create multiple links for the same agent?
Can I create multiple links for the same agent?
Yes, you can create as many links as needed. Each link is independent with its own expiration and usage tracking. This is useful for:
- Sharing with multiple recipients individually
- Tracking which specific people accessed the agent
- Creating new links after previous ones expire
- Having backup links in case one is lost
What happens to my links when I update the agent?
What happens to my links when I update the agent?
Existing links remain tied to the version that was active when the link was created. If you publish a new version:
- Old links continue to provide the previous version
- Create new links to share the updated version
- Recipients won’t automatically get updates
Can I extend a link's expiration date?
Can I extend a link's expiration date?
No, the 7-day expiration cannot be extended. If a link expires before use:
- Create a new link from the Share Agent section
- Share the new URL with the recipient
- Old expired links cannot be reactivated
- Consider using Export to File for longer-term sharing
How do I share an agent with multiple people?
How do I share an agent with multiple people?
Next Steps
- Recipients need to import? See Use an Agent Shared with You
- Want to share publicly? See Community Sharing
- Need help? Review the Sharing Overview