Ler links de documentos

A ação Ler links de documentos permite que seu agente abra o link de um documento compartilhado por um visitante no chat — uma especificação em PDF, um contrato do Word ou uma lista de preços do Excel —, leia o conteúdo e responda a perguntas sobre ele na mesma conversa.

Habilitando a ação

1. Acesse a aba Ações do seu agente
2. Clique em Adicionar ação → Ler links de documentos
3. Ajuste a configuração, se necessário, e salve
4. Teste no Playground colando o link de um documento e fazendo uma pergunta sobre ele

Exige um plano pago.

Opções de configuração

Quando usar

Descreva quando o agente deve ler o link de um documento. Uma descrição clara ajuda o agente a decidir, por exemplo: “Use quando o visitante compartilhar um link para um documento — PDF, Word, Excel ou PowerPoint — e fizer perguntas sobre o conteúdo.”

Domínios permitidos

Restrinja os links de documentos a hosts específicos, um por linha. Deixe em branco para permitir qualquer host público. Quando há uma lista configurada, o agente recusa educadamente links de outros domínios.

Máximo de páginas

Limita quantas páginas são processadas quando um PDF digitalizado precisa de OCR. Documentos de texto comuns não são afetados.

Formatos compatíveis

Páginas comuns da web não são compatíveis — esta ação lê apenas arquivos de documentos. Para responder com base no conteúdo de um site, adicione o site às fontes do seu agente.

Como funciona

1. Um visitante cola o link de um documento na mensagem e faz uma pergunta sobre ele
2. O agente busca o arquivo e extrai seu texto
3. A resposta é fundamentada no conteúdo do documento, junto com as fontes habituais do seu agente

O agente lê apenas os links que o visitante realmente compartilhou na mensagem — ele nunca inventa URLs para buscar.

Limites e segurança

• Somente links HTTPS públicos - O link deve usar https:// e apontar para um host acessível publicamente. Endereços de redes privadas e internas são sempre bloqueados.
• 20 MB por documento - Arquivos maiores são recusados com uma mensagem amigável.
• Documentos muito longos são encurtados - O agente lê o máximo que couber e avisa quando o conteúdo é cortado.
• O conteúdo dos documentos é tratado como não confiável - O agente usa o documento apenas como material de referência e não segue instruções incorporadas nele.

Testando sua ação

1. Habilite a ação e abra o Playground
2. Cole um link para um PDF hospedado e pergunte: “O que diz este documento?”
3. Teste um link incompatível (uma página comum da web) para ver o agente recusá-lo educadamente

Próximos passos

• Explore todas as ações
• Permita que seu agente pesquise na web
• Adicione conteúdo de sites como fontes