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

> Compartilhe seus agentes com sua equipe através de links públicos sem necessidade de autenticação

## Visão Geral

O **Share Agent** permite que você compartilhe seus agentes de IA com sua equipe ou clientes através de links públicos. Esta funcionalidade é ideal para:

* **Colaboração em equipe** sem necessidade de múltiplas contas
* **Demonstrações** para clientes ou stakeholders
* **Acesso rápido** a agentes específicos
* **Testes públicos** de funcionalidades

<Note>
  **Segurança**: Os chats compartilhados são acessíveis publicamente através do link gerado.
  Certifique-se de compartilhar apenas com pessoas autorizadas.
</Note>

## Como Compartilhar um Agente

### Passo 1: Acessar Configurações do Agente

<AccordionGroup>
  <Accordion icon="gear" title="Localizar o agente na listagem">
    1. Vá para a **tela de agentes** no dashboard principal
    2. Localize o agente que deseja compartilhar
    3. No **card do agente**, clique no ícone de **"Configurações"** (⚙️)

    <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="Card do Agente com Botão de Configurações" width="813" height="871" data-path="images/prints/shareagent01_agentcard.png" />
  </Accordion>

  <Accordion icon="share" title="Acessar Share Agent">
    1. No menu de configurações do agente, clique em **"Share Agent"**
    2. Você será direcionado para a tela de compartilhamento

    <Tip>
      Esta opção está disponível para todos os tipos de agentes criados na plataforma.
    </Tip>
  </Accordion>
</AccordionGroup>

### Passo 2: Configurar o Compartilhamento

<AccordionGroup>
  <Accordion icon="link" title="Gerar link de compartilhamento">
    Na tela de **Share Agent** você verá:

    * **URL do Chat Compartilhado**: Link público para acesso ao agente
    * **API Key**: Chave específica para este compartilhamento
    * **Configurações de acesso**: Opções de segurança e controle

    <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="Tela de Configuração do Share Agent" width="894" height="755" data-path="images/prints/shareagent02_share_screen.png" />

    <Info>
      **API Key Específica**: Cada compartilhamento gera uma API key única para controle de acesso e monitoramento.
    </Info>
  </Accordion>

  <Accordion icon="copy" title="Copiar informações de acesso">
    **Para compartilhar com sua equipe:**

    1. **Copie a URL** do chat compartilhado
    2. **Anote a API Key** se necessário para integrações
    3. **Compartilhe o link** com as pessoas autorizadas

    <Warning>
      Mantenha a API Key segura. Ela pode ser usada para acessar o agente programaticamente.
    </Warning>
  </Accordion>
</AccordionGroup>

### Passo 3: Acessar o Chat Compartilhado

<AccordionGroup>
  <Accordion icon="link" title="Abrir link compartilhado">
    1. Clique em **"Open Link"** na tela de configuração
    2. Uma nova aba será aberta com o chat compartilhado
    3. O chat estará pronto para uso imediato

    <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="Interface do Chat Compartilhado" width="2879" height="1507" data-path="images/prints/shareagent03_share_chat.png" />
  </Accordion>

  <Accordion icon="users" title="Acesso sem autenticação">
    **Características do chat compartilhado:**

    * ✅ **Sem login necessário** - Acesso direto através do link
    * ✅ **Interface simplificada** - Foco na conversa com o agente
    * ✅ **Funcionalidade completa** - Todas as capacidades do agente disponíveis
    * ✅ **Sessões independentes** - Cada usuário tem sua própria conversa

    <Tip>
      Ideal para demonstrações, testes em equipe ou acesso rápido por clientes.
    </Tip>
  </Accordion>
</AccordionGroup>

## Casos de Uso

### Para Equipes

<AccordionGroup>
  <Accordion icon="users" title="Colaboração interna">
    **Cenários ideais:**

    * Testes de agentes por diferentes membros da equipe
    * Validação de funcionalidades antes do deploy
    * Treinamento de novos colaboradores
    * Demonstrações internas de projetos
  </Accordion>

  <Accordion icon="chart-bar" title="Demonstrações para clientes">
    **Benefícios:**

    * Acesso imediato sem necessidade de cadastro
    * Interface limpa e profissional
    * Experiência completa do agente
    * Facilita fechamento de vendas
  </Accordion>
</AccordionGroup>

### Para Desenvolvimento

<AccordionGroup>
  <Accordion icon="code" title="Integração via API">
    Use a **API Key gerada** para integrar o agente compartilhado em:

    ```javascript theme={null}
    // Exemplo de integração
    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: 'Olá, preciso de ajuda!',
        agent_id: 'shared-agent-id'
      })
    });
    ```
  </Accordion>

  <Accordion icon="flask" title="Testes automatizados">
    **Possibilidades:**

    * Testes de regressão de agentes
    * Validação de respostas em diferentes cenários
    * Monitoramento de performance
    * Coleta de métricas de uso
  </Accordion>
</AccordionGroup>

## Gerenciamento de Compartilhamentos

### Segurança e Controle

<AccordionGroup>
  <Accordion icon="shield" title="Boas práticas de segurança">
    **Recomendações:**

    * 🔒 **Compartilhe apenas com pessoas autorizadas**
    * 🔄 **Regenere links periodicamente** para maior segurança
    * 📊 **Monitore o uso** através das métricas da plataforma
    * ⚠️ **Revogue acesso** quando necessário

    <Warning>
      Links compartilhados são públicos. Não inclua informações sensíveis nas configurações do agente.
    </Warning>
  </Accordion>

  <Accordion icon="chart-line" title="Monitoramento de uso">
    **Métricas disponíveis:**

    * Número de conversas iniciadas
    * Tempo médio de sessão
    * Mensagens trocadas
    * Horários de maior uso

    <Info>
      Acesse as métricas através do dashboard principal da plataforma.
    </Info>
  </Accordion>
</AccordionGroup>

### Limitações e Considerações

<AccordionGroup>
  <Accordion icon="info" title="Limitações técnicas">
    **Pontos importantes:**

    * 📝 **Histórico limitado** - Conversas não são persistidas indefinidamente
    * 🔄 **Sessões temporárias** - Cada acesso cria uma nova sessão
    * ⚡ **Rate limiting** - Pode haver limites de uso por IP
    * 🎯 **Funcionalidades básicas** - Algumas funcionalidades avançadas podem não estar disponíveis
  </Accordion>

  <Accordion icon="dollar-sign" title="Considerações de custo">
    **Impacto nos custos:**

    * Uso de tokens da sua API key principal
    * Consumo baseado no volume de conversas
    * Monitoramento recomendado para controle de gastos

    <Tip>
      Configure alertas de uso para evitar custos inesperados com alto volume de acesso.
    </Tip>
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Link não funciona:**

    * Verifique se o agente ainda está ativo
    * Confirme se a API key não foi revogada
    * Teste em modo incógnito para descartar cache

    **Agente não responde no chat compartilhado:**

    * Verifique se há créditos na API key principal
    * Confirme se o modelo do agente está disponível
    * Verifique logs de erro no dashboard principal

    **Acesso negado:**

    * Confirme se o link está correto e completo
    * Verifique se não há restrições de IP
    * Teste com diferentes navegadores

    **Performance lenta:**

    * Pode haver alto volume de uso simultâneo
    * Verifique a performance do modelo escolhido
    * Considere otimizar as instruções do agente
  </Accordion>
</AccordionGroup>

***

🚀 **Pronto!** Agora você pode compartilhar seus agentes com facilidade e colaborar com sua equipe de forma eficiente. Use esta funcionalidade para demonstrações, testes e acesso rápido aos seus agentes de IA!
