> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evo-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Share Agent

> Share your agents with your team through public links without authentication required

## Overview

**Share Agent** allows you to share your AI agents with your team or clients through public links. This functionality is ideal for:

* **Team collaboration** without the need for multiple accounts
* **Demonstrations** for clients or stakeholders
* **Quick access** to specific agents
* **Public testing** of functionalities

<Note>
  **Security**: Shared chats are publicly accessible through the generated link.
  Make sure to share only with authorized people.
</Note>

## How to Share an Agent

### Step 1: Access Agent Settings

<AccordionGroup>
  <Accordion icon="gear" title="Locate the agent in the listing">
    1. Go to the **agents screen** in the main dashboard
    2. Locate the agent you want to share
    3. In the **agent card**, click on the **"Settings"** icon (⚙️)

    <img src="https://mintcdn.com/evoai/Aa4kqZ7vw51IF__0/images/prints/shareagent01_agentcard.png?fit=max&auto=format&n=Aa4kqZ7vw51IF__0&q=85&s=3a5fbcf87f75981d3b702d10e791657d" alt="Agent Card with Settings Button" width="813" height="871" data-path="images/prints/shareagent01_agentcard.png" />
  </Accordion>

  <Accordion icon="share" title="Access Share Agent">
    1. In the agent settings menu, click on **"Share Agent"**
    2. You will be directed to the sharing screen

    <Tip>
      This option is available for all types of agents created on the platform.
    </Tip>
  </Accordion>
</AccordionGroup>

### Step 2: Configure Sharing

<AccordionGroup>
  <Accordion icon="link" title="Generate sharing link">
    On the **Share Agent** screen you will see:

    * **Shared Chat URL**: Public link for agent access
    * **API Key**: Specific key for this sharing
    * **Access settings**: Security and control options

    <img src="https://mintcdn.com/evoai/Aa4kqZ7vw51IF__0/images/prints/shareagent02_share_screen.png?fit=max&auto=format&n=Aa4kqZ7vw51IF__0&q=85&s=7070d8bfeec1cff2a6e2d3dfb41a4dc3" alt="Share Agent Configuration Screen" width="894" height="755" data-path="images/prints/shareagent02_share_screen.png" />

    <Info>
      **Specific API Key**: Each sharing generates a unique API key for access control and monitoring.
    </Info>
  </Accordion>

  <Accordion icon="copy" title="Copy access information">
    **To share with your team:**

    1. **Copy the URL** of the shared chat
    2. **Note the API Key** if needed for integrations
    3. **Share the link** with authorized people

    <Warning>
      Keep the API Key secure. It can be used to access the agent programmatically.
    </Warning>
  </Accordion>
</AccordionGroup>

### Step 3: Access the Shared Chat

<AccordionGroup>
  <Accordion icon="link" title="Open shared link">
    1. Click on **"Open Link"** in the configuration screen
    2. A new tab will open with the shared chat
    3. The chat will be ready for immediate use

    <img src="https://mintcdn.com/evoai/Aa4kqZ7vw51IF__0/images/prints/shareagent03_share_chat.png?fit=max&auto=format&n=Aa4kqZ7vw51IF__0&q=85&s=b45d606c54da4756defad5928303bef8" alt="Shared Chat Interface" width="2879" height="1507" data-path="images/prints/shareagent03_share_chat.png" />
  </Accordion>

  <Accordion icon="users" title="Access without authentication">
    **Shared chat characteristics:**

    * ✅ **No login required** - Direct access through the link
    * ✅ **Simplified interface** - Focus on conversation with the agent
    * ✅ **Complete functionality** - All agent capabilities available
    * ✅ **Independent sessions** - Each user has their own conversation

    <Tip>
      Ideal for demonstrations, team testing, or quick access by clients.
    </Tip>
  </Accordion>
</AccordionGroup>

## Use Cases

### For Teams

<AccordionGroup>
  <Accordion icon="users" title="Internal collaboration">
    **Ideal scenarios:**

    * Agent testing by different team members
    * Functionality validation before deployment
    * Training new collaborators
    * Internal project demonstrations
  </Accordion>

  <Accordion icon="chart-bar" title="Client demonstrations">
    **Benefits:**

    * Immediate access without registration required
    * Clean and professional interface
    * Complete agent experience
    * Facilitates sales closing
  </Accordion>
</AccordionGroup>

### For Development

<AccordionGroup>
  <Accordion icon="code" title="API integration">
    Use the **generated API Key** to integrate the shared agent in:

    ```javascript theme={null}
    // Integration example
    const response = await fetch('https://app.evo-ai.co/api/shared-chat', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${SHARED_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        message: 'Hello, I need help!',
        agent_id: 'shared-agent-id'
      })
    });
    ```
  </Accordion>

  <Accordion icon="flask" title="Automated testing">
    **Possibilities:**

    * Agent regression testing
    * Response validation in different scenarios
    * Performance monitoring
    * Usage metrics collection
  </Accordion>
</AccordionGroup>

## Sharing Management

### Security and Control

<AccordionGroup>
  <Accordion icon="shield" title="Security best practices">
    **Recommendations:**

    * 🔒 **Share only with authorized people**
    * 🔄 **Regenerate links periodically** for greater security
    * 📊 **Monitor usage** through platform metrics
    * ⚠️ **Revoke access** when necessary

    <Warning>
      Shared links are public. Do not include sensitive information in agent settings.
    </Warning>
  </Accordion>

  <Accordion icon="chart-line" title="Usage monitoring">
    **Available metrics:**

    * Number of conversations started
    * Average session time
    * Messages exchanged
    * Peak usage hours

    <Info>
      Access metrics through the main platform dashboard.
    </Info>
  </Accordion>
</AccordionGroup>

### Limitations and Considerations

<AccordionGroup>
  <Accordion icon="info" title="Technical limitations">
    **Important points:**

    * 📝 **Limited history** - Conversations are not persisted indefinitely
    * 🔄 **Temporary sessions** - Each access creates a new session
    * ⚡ **Rate limiting** - There may be usage limits per IP
    * 🎯 **Basic functionalities** - Some advanced features may not be available
  </Accordion>

  <Accordion icon="dollar-sign" title="Cost considerations">
    **Cost impact:**

    * Token usage from your main API key
    * Consumption based on conversation volume
    * Monitoring recommended for expense control

    <Tip>
      Set up usage alerts to avoid unexpected costs with high access volume.
    </Tip>
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Common problems">
    **Link doesn't work:**

    * Check if the agent is still active
    * Confirm that the API key hasn't been revoked
    * Test in incognito mode to rule out cache issues

    **Agent doesn't respond in shared chat:**

    * Check if there are credits in the main API key
    * Confirm that the agent model is available
    * Check error logs in the main dashboard

    **Access denied:**

    * Confirm that the link is correct and complete
    * Check if there are IP restrictions
    * Test with different browsers

    **Slow performance:**

    * There may be high simultaneous usage volume
    * Check the performance of the chosen model
    * Consider optimizing agent instructions
  </Accordion>
</AccordionGroup>

***

🚀 **Ready!** Now you can share your agents with ease and collaborate with your team efficiently. Use this functionality for demonstrations, testing, and quick access to your AI agents!
