Integrações e credenciais

Um Agente frequentemente precisa de mais do que os arquivos que recebe: uma busca em uma base de jurisprudência, uma consulta ao seu CRM, um Canvas em que você já confia. As Integrações dão ao Agente serviços externos que ele pode chamar, com a credencial fora do alcance dele. As Credenciais do Agent controlam quais credenciais do seu Workspace ele pode usar. A aba Capabilities anexa Canvases, Workflows e Agentes publicados como ferramentas. Para o assistente de contratos do exemplo da seção, uma integração chamada caselaw aponta para a base jurídica que o time assina, para que o Agente verifique como uma cláusula vem sendo interpretada.

​

Integrações

A seção Integrações da barra lateral lista os serviços externos que este Agente pode chamar, com o nome do Serviço, o Header usado e a Credencial que o autoriza. A credencial fica no Workspace e é aplicada pelo Tela no momento da requisição; o Agente nunca recebe o valor. Somente administradores do Workspace podem adicionar ou editar integrações. Os demais membros veem a lista em modo somente leitura, inclusive um selo Credencial não encontrada quando a credencial de uma integração não existe mais.

​

Adicionando uma integração

O diálogo resume a regra: As credenciais ficam cifradas e são aplicadas pelo proxy da Tela em tempo de execução; o valor cru nunca chega no sandbox do agente. Dois detalhes decorrem dela:

• Se você trocar a URL base depois de escolher uma credencial, precisa selecionar (ou digitar) a credencial novamente para autorizá-la no novo endereço.
• Credenciais que o Agente já usa como segredos comuns (veja abaixo) não aparecem na lista: uma integração não pode compartilhar chave com elas.

​

Dizendo ao Agente para usá-la

No Objetivo, cite o serviço pelo nome e diga quando usá-lo, em linguagem natural: “Quando uma cláusula mencionar uma lei, consulte a integração caselaw antes de sinalizá-la.” O Agente chama o serviço pelo nome; o Tela adiciona a credencial durante a requisição.

​

Credenciais do Agent

As integrações cobrem serviços com API key ou token. Para qualquer outro segredo de que o Agente precise, o Tela usa as mesmas Credenciais dos Workflows: o Agente se refere a uma credencial pelo nome e nunca vê o valor. Administradores as abrem no menu … ao lado do título do Agente, em Credenciais do Agent. O diálogo tem duas abas:

• Credenciais do Agent: credenciais específicas deste Agente. Elas sobrescrevem credenciais do Workspace com a mesma chave, o que é útil quando este Agente precisa usar uma conta diferente do resto do Workspace.
• Permissões de Uso: o Controle de Acesso a Credenciais. Ative ou desative as credenciais que este Agente pode usar; credenciais desabilitadas não ficam disponíveis durante a execução. Se você não alterar nada, todas as credenciais ficam habilitadas.

Para dizer ao Agente qual credencial usar, cite-a no Objetivo, por exemplo “Use a credencial SLACK_BOT_TOKEN para publicar o resumo no canal #juridico”. As regras de nomenclatura e o fluxo de rotação são os mesmos de Credenciais.

​

Outros recursos do Tela como ferramentas

Um Canvas, Workflow ou Agente publicado do seu Workspace pode virar uma ferramenta que o seu Agente chama. É assim que você reutiliza um Canvas que já extrai bem as partes de um contrato, ou um Workflow que arquiva um documento nos seus sistemas, em vez de ensinar o Agente a fazer isso do zero. Abra o diálogo Skills (clique em Adicionar skill na seção Skills) e mude para a aba Capabilities. Escolha um Projeto na lista, busque se precisar e passe o mouse sobre um card para clicar em Adicionar. Cada card mostra o título do recurso e o tipo: Canvas, Workflow ou Agente. Só recursos publicados aparecem, e o próprio Agente não aparece na lista. Depois de adicionar, descreva no Objetivo quando chamá-lo, do mesmo jeito que faria com uma skill. O Agente preenche as entradas do recurso com o que sabe e recebe o resultado publicado.