Ferramentas

As páginas desta seção descrevem as integrações externas que podem ser oferecidas aos agentes do SquadOS. Cada referência identifica o serviço, os métodos de autenticação conhecidos e as ações publicadas no snapshot documentado.

O catálogo não é uma lista de ferramentas automaticamente disponíveis para todo agente. Há duas configurações independentes:

1. a organização ativa a integração, conecta uma conta e pode limitar as ações;
2. cada agente recebe uma conta e um subconjunto das ações permitidas.

Ativar uma integração não a adiciona aos agentes. Conectar uma conta também não autoriza nenhum agente até que a ferramenta seja incluída e o agente seja salvo.

Antes de escolher uma integração

Defina primeiro o resultado esperado e o menor acesso necessário. Confirme:

• qual serviço externo contém ou receberá os dados;
• qual conta ou workspace deve ser usado;
• se a operação é apenas de leitura ou também cria, altera ou exclui dados;
• quais ações exatas o agente precisa executar;
• quais informações da conversa podem ser enviadas ao serviço terceiro.

Não escolha uma integração apenas porque o nome do serviço parece adequado. Leia a lista de ações e seus parâmetros: é ela que determina o que o agente realmente pode fazer.

Disponibilizar uma integração para a organização

A rota Ferramentas (/admin/tools) exige Visualizar ferramentas. Para ativar, conectar e editar ações, a pessoa precisa de Criar e editar ferramentas; a remoção pertence a Excluir ferramentas.

1. Abra Ferramentas e selecione a aba Disponíveis.
2. Pesquise a integração e abra seu card em Configurar ferramenta.
3. Clique em Ativar. A integração passa para Ativas.
4. Abra a integração ativa e selecione Conectar agora.
5. Se houver mais de um método, escolha o método de autenticação apropriado.
6. Conclua o fluxo hospedado pela Composio. Ferramentas sem autenticação são conectadas diretamente.
7. Em Contas, confirme que a conta aparece como ativa.

Ativação e autenticação são etapas distintas. Uma integração pode estar ativa na organização e ainda aparecer em Desconectadas ou Aguardando autenticação. Consulte o fluxo completo em Ferramentas da Organização.

Credenciais e contas

OAuth, chave de API, bearer token, autenticação básica e campos próprios do serviço percorrem a página segura hospedada pela Composio. Não escreva senhas, tokens ou chaves no prompt do agente, na descrição da ferramenta ou em uma base de conhecimento.

Uma integração pode ter várias contas. Dê nomes que diferenciem propósito e ambiente, como Suporte — produção e Marketing — homologação. Ao recuperar uma credencial, use Contas → Ações da conta → Reconectar na linha correta para preservar a identidade e os vínculos daquela conta.

Se uma referência desta seção explicar como obter uma chave ou credencial OAuth, siga essa preparação somente quando o método escolhido no fluxo de conexão pedir esses dados. O OAuth gerenciado pela plataforma não exige que cada organização crie seu próprio aplicativo no provedor.

Limitar as ações da organização

Abra uma integração ativa e use Editar ações para definir o conjunto máximo disponível na organização. Sem uma lista curada, todas as ações publicadas pela integração ficam disponíveis para seleção no agente.

Prefira o menor conjunto possível. Separe ações de leitura das que enviam mensagens, criam registros, movimentam dinheiro ou excluem conteúdo. Uma ação executada pelo agente usa as permissões da conta conectada no serviço externo.

Adicionar a um agente

1. Abra o agente e entre na seção Ferramentas.
2. Selecione Adicionar Ferramenta.
3. Escolha uma integração ativa da organização.
4. Escolha a conta correta e somente as ações necessárias.
5. Revise os parâmetros configuráveis, salve o agente e faça um teste seguro.

O seletor do agente mostra somente integrações ativas que ainda não foram adicionadas a ele. A lista de ações do agente nunca pode ultrapassar a curadoria da organização.

Como ler cada referência

Cada página de integração contém:

• Visão geral: finalidade do serviço e usos típicos;
• Autenticação: métodos conhecidos pelo snapshot;
• Como conectar: preparação específica e entrada pelo SquadOS;
• Ações disponíveis: identificador técnico, entradas, obrigatoriedade e saída.

Os identificadores e parâmetros devem ser copiados exatamente; não invente uma ação nem um campo. Como o catálogo da Composio evolui, trate a versão e a data registradas no frontmatter como o snapshot daquela página. Se o editor do agente ou o schema entregue durante a execução divergir, use o contrato atual do produto e registre a documentação para revisão.

Catálogo por categoria

O catálogo documentado reúne 106 integrações:

Categoria	Integrações
IA & Modelos	12
Web Scraping & Busca	7
Analytics & BI	8
E-mail	8
CRM & Pagamentos	7
Comunicação & Chat	7
Produtividade & Gestão	12
Google Workspace & Arquivos	5
Dev & Infra	22
Marketing & Social	8
Mídia & Design	7
Colaboração & Outros	3

Use a navegação lateral para abrir a referência de cada integração. A presença de uma página documenta o conector, mas não garante que ele esteja habilitado no plano, na plataforma ou na organização atual.

Diagnóstico rápido

• Não aparece em Disponíveis: a integração pode não estar habilitada na plataforma ou pode já estar em Ativas.
• Aguardando configuração: a autenticação da plataforma ainda precisa ser preparada por um superadministrador.
• Aguardando autenticação: abra a integração e conclua Conectar agora.
• Não aparece no agente: confirme que a integração está ativa, que a conta está conectada e que ela ainda não foi adicionada àquele agente.
• Ação ausente: revise Editar ações na organização e a seleção do agente.
• Parâmetro rejeitado: use o schema atual exibido pelo produto; não adapte o nome ou o tipo por tentativa.
• Conta com erro: reconecte pela própria linha em Contas.

O produto possui limitações de permissão conhecidas nessa área. Até a correção, conceda Visualizar ferramentas apenas a pessoas autorizadas a administrar integrações e consulte os alertas em Ferramentas da Organização.