---
title: "Share Your Agent Directly"
description: "Export agents using private URLs or files for controlled distribution"
---

# 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) |

---

## Use Cases

<AccordionGroup>
  <Accordion title="Team Collaboration">
    Sharing agents across your organization

    <CardGroup cols={2}>
      <Card title="Private Links - Best for">
        - Quick sharing between team members
        - Tracking which teams accessed agents
        - Time-sensitive distributions
        - Ensuring one-time access
      </Card>
      <Card title="Files - Best for">
        - Distributing templates to multiple teams
        - Creating a library of reusable agents
        - Backup copies for team repositories
        - Long-term template storage
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Client Delivery">
    Delivering agent solutions to external clients

    <CardGroup cols={2}>
      <Card title="Private Links - Best for">
        - Controlled initial delivery
        - Single-recipient handoff
        - Tracking delivery confirmation
        - Quick proof-of-concept sharing
      </Card>
      <Card title="Files - Best for">
        - Formal project deliverables
        - Documentation packages
        - Multi-environment deployments
        - Contract fulfillment requirements
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Backup and Migration">
    Protecting and moving agents

    <CardGroup cols={2}>
      <Card title="Private Links - Best for">
        - Quick emergency backup sharing
        - Temporary cross-environment testing
        - Sharing with support teams
      </Card>
      <Card title="Files - Best for">
        - Regular backup schedules
        - Long-term archival storage
        - Platform migrations
        - Version control systems
        - Disaster recovery plans
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

---

## Best Practices

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="For Private Share Links">
    **Creation:**
    - Create links only when ready to share immediately
    - Generate separate links for each recipient (for tracking)
    - Note the 7-day expiration when sharing
    - Verify active version before link creation

    **Distribution:**
    - Share links through secure channels (encrypted email, secure messaging)
    - Inform recipients about one-time use limitation
    - Provide context about what the agent does
    - Include setup instructions or documentation

    **Management:**
    - Regularly review active links in management interface
    - Deactivate unused links to reduce exposure
    - Clean up expired and redeemed links periodically
    - Monitor access logs for audit purposes
  </Accordion>

  <Accordion title="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

    **File Distribution:**
    - 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

    **File Management:**
    - 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
  </Accordion>

  <Accordion title="For Recipients">
    **Pre-Import:**
    - Verify the source is trusted
    - Ensure platform compatibility
    - Prepare required credentials before importing
    - Review any provided documentation

    **Post-Import:**
    - Complete all configuration steps before deploying
    - Test thoroughly in a non-production environment first
    - Document any customizations you make
    - Keep your own backup copy

    **Security:**
    - Audit agent configurations before deployment
    - Validate tool permissions are appropriate
    - Ensure credentials are properly secured
    - Review prompts for any embedded sensitive data
  </Accordion>
</AccordionGroup>

---

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="How do I share an agent with multiple people?">
    You have two options:

    **Private Links (recommended for tracking):**
    - Create separate links for each person
    - Track individual access in link management
    - Maintain better security and audit trail

    **Export to File (Better for broad distribution):**
    - Export once, share file with multiple recipients
    - Suitable for team-wide or client-wide distribution
    - Recipients can re-import if needed
  </Accordion>
</AccordionGroup>

---

## Next Steps

- Recipients need to import? See [Use an Agent Shared with You](./import-agent)
- Want to share publicly? See [Community Sharing](./community-sharing)
- Need help? Review the [Sharing Overview](./overview)
