Pular para o conteúdo

Composio

Composio

O Composio é uma plataforma de integração que permite que agentes de IA e LLMs se autentiquem e interajam com mais de 500 aplicativos externos — como Slack, GitHub, Gmail, Google Sheets, Notion, Stripe e muitos outros — por meio de chamadas de função padronizadas. Com a integração Composio no SquadOS, seus agentes podem descobrir ferramentas disponíveis, gerenciar conexões com serviços externos, executar ações em múltiplos aplicativos e criar fluxos de automação reutilizáveis (recipes) diretamente a partir do chat.

Esta ferramenta utiliza sem autenticação (NO_AUTH) para conectar.

CampoObrigatórioDescrição
N/ANãoEsta ferramenta não exige credenciais.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por Composio.
  3. Clique no card para abrir o modal de detalhes e em Ativar — a ferramenta vai direto para a lista de ativas, sem etapa de login. (Detalhes do fluxo em Ferramentas da Organização.)

COMPOSIO_CHECK_ACTIVE_CONNECTION

Descontinuada: use a verificação de múltiplas conexões ativas para operações em lote. Verifica o status de conexão ativa de um toolkit ou de um ID de conta conectada específico. Retorna os detalhes da conexão se estiver ativa, ou os parâmetros necessários para estabelecer a conexão caso não exista. Conexões ativas habilitam ações do agente no toolkit.

NomeTipoObrigatórioDescrição
connected_account_idstringNãoID da conta conectada específica cujo status verificar
toolkitstringNãoNome do toolkit a verificar
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_CHECK_ACTIVE_CONNECTIONS

Verifica o status de conexão ativa para múltiplos toolkits ou IDs de contas conectadas específicos. Retorna os detalhes da conexão se estiver ativa, ou os parâmetros necessários para estabelecer a conexão caso não exista. Conexões ativas habilitam ações do agente nos toolkits.

NomeTipoObrigatórioDescrição
requestsarraySimLista de solicitações de verificação de conexão
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_CREATE_PLAN

Construtor de fluxos de trabalho que garante que o LLM produza um plano completo e passo a passo para qualquer caso de uso. Deve ser chamado após COMPOSIO_SEARCH_TOOLS ou COMPOSIO_MANAGE_CONNECTIONS para casos de uso de dificuldade média ou alta. Gera um plano completo com seções como etapas do fluxo, avaliação de complexidade, matriz de decisão e tratamento de falhas.

NomeTipoObrigatórioDescrição
difficultystring ("medium" | "hard")SimNível de dificuldade do plano. Use "medium" para complexidade moderada e "hard" para tarefas complexas com múltiplas etapas ou lógica avançada. Não chamar para tarefas fáceis.
known_fieldsstringSimEntradas do fluxo de trabalho já conhecidas como pares chave:valor separados por vírgula (ex.: "channel_name:pod-sdk, user_names:John"). Ajuda a inferir memórias relevantes.
primary_tool_slugsarraySimLista de slugs de ferramentas primárias que podem realizar a tarefa principal. Nunca inventar slugs; usar apenas os retornados por Search.
reasoningstringSimBreve raciocínio sobre o caso de uso e como as ferramentas selecionadas podem realizá-lo
related_tool_slugsarrayNãoLista de slugs de ferramentas relacionadas/de suporte que podem ser úteis. Nunca inventar slugs.
use_casestringSimExplicação detalhada do caso de uso que o usuário está tentando realizar
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_ENABLE_TRIGGER

Habilita um gatilho específico para o usuário autenticado.

NomeTipoObrigatórioDescrição
config_paramsobjectNãoParâmetros de configuração para o gatilho
connected_account_idstringSimID da conta conectada para a qual habilitar o gatilho
toolkit_slugstringSimSlug do toolkit
trigger_namestringSimNome do gatilho a habilitar
user_idstringNãoID do usuário para o gatilho
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_EXECUTE_TOOL

Executa uma ferramenta usando a API da Composio.

NomeTipoObrigatórioDescrição
allow_destructivebooleanNãoSe deve permitir a execução de ferramentas destrutivas. Se true, a ferramenta será executada mesmo que seja destrutiva.
argumentsobjectSimOs argumentos a serem passados para a ferramenta. O esquema dos argumentos está presente na resposta de retrieve_actions.
connected_account_idstringNãoID da conta conectada a usar. Se não fornecido, usa a primeira conexão ativa do toolkit.
tool_slugstringSimO slug da ferramenta a executar, obtido da lista de ferramentas retornada por retrieve_actions.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_DEPENDENCY_GRAPH

Obtém o grafo de dependências de uma ferramenta específica, exibindo ferramentas pai relacionadas que podem ser úteis. Chama a API do Composio Labs para recuperar ferramentas comumente usadas em conjunto ou antes da ferramenta especificada, auxiliando na descoberta de ferramentas relacionadas e na compreensão de fluxos de trabalho comuns.

NomeTipoObrigatórioDescrição
tool_namestringSimNome da ferramenta para obter o grafo de dependências
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_REQUIRED_PARAMETERS

Obtém os parâmetros necessários para conectar a um toolkit via iniciar conexão. Retorna os nomes e tipos exatos dos parâmetros necessários para o campo parameters de initiate_connection. Suporta chaves de API, credenciais OAuth, campos de conexão e cenários de autenticação híbrida. Se has_default_credentials for verdadeiro, é possível chamar initiate_connection com parâmetros vazios para um fluxo OAuth sem configuração.

NomeTipoObrigatórioDescrição
toolkitstringSimNome do toolkit para analisar os requisitos de autenticação. Retorna parâmetros para chaves de API, credenciais OAuth ou campos de conexão necessários por initiate_connection.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_RESPONSE_SCHEMA

Recupera o esquema de resposta de uma ferramenta Composio especificada. Busca a definição completa do esquema de resposta de qualquer ferramenta Composio válida, retornando-a como um dicionário que descreve a estrutura de resposta esperada.

NomeTipoObrigatórioDescrição
toolstringSimNome da ferramenta. Por exemplo: GITHUB_LIST_PULL_REQUESTS. Os nomes relevantes podem ser encontrados usando a ferramenta COMPOSIO_RETRIEVE_ACTIONS.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_INITIATE_CONNECTION

Inicia uma conexão com um toolkit com suporte abrangente de autenticação. Suporta todos os cenários: OAuth padrão da Composio (sem parâmetros), OAuth customizado (client id/secret do usuário), autenticação por chave de API ou bearer token, autenticação básica (usuário/senha), cenários híbridos (OAuth + campos de conexão como nome do site) e sem autenticação. Detecta e valida automaticamente a configuração de autenticação em relação aos campos de conexão.

NomeTipoObrigatórioDescrição
parametersobjectNãoParâmetros de autenticação para a conexão. A estrutura depende do tipo de autenticação: API Key: {"generic_api_key": "sua_chave"}; Bearer Token: {"bearer_token": "seu_token"}; Basic Auth: {"username": "usuario", "password": "senha"}; OAuth customizado: {"client_id": "seu_id", "client_secret": "seu_secret"}; Campos de conexão: {"subdomain": "seu_subdominio"}. Deixar vazio {} para fluxo OAuth padrão. Use get_required_parameters para ver os nomes exatos dos parâmetros.
toolkitstringSimNome do toolkit a conectar (ex.: 'gmail', 'github', 'linear')
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_LIST_TOOLKITS

Lista todos os toolkits disponíveis na Composio com opções de filtragem.

NomeTipoObrigatórioDescrição
categorystringNãoFiltrar toolkits por categoria
min_toolsintegerNãoFiltrar toolkits por número mínimo de ferramentas
name_filterstringNãoFiltrar toolkits por nome/slug
no_auth_onlybooleanNãoRetornar apenas toolkits que não exigem autenticação
sizeintegerNãoLimitar o número de resultados retornados
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_LIST_TRIGGERS

Lista os gatilhos disponíveis e seus esquemas de configuração.

NomeTipoObrigatórioDescrição
toolkit_namesarrayNãoLista de nomes de toolkits para filtrar os gatilhos. Se não fornecida ou vazia, todos os gatilhos serão retornados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_MANAGE_CONNECTIONS

Cria ou gerencia conexões com os aplicativos do usuário. Retorna um link de autenticação personalizado que funciona para OAuth, chaves de API e todos os outros tipos de autenticação. Se uma conexão já estiver ativa, retorna os detalhes da conexão. Caso contrário, retorna uma URL de redirecionamento (redirect_url) para criar uma nova conexão.

NomeTipoObrigatórioDescrição
toolkitsarraySimSlugs de toolkits para verificar ou conectar. Devem ser slugs válidos; nunca inventar. Exemplos: ['gmail', 'github', 'slack', 'googlesheets', 'outlook'].
reinitiate_allbooleanNãoForçar a reconexão de todos os toolkits listados, mesmo que já possuam conexões ativas. Use quando as credenciais possam estar desatualizadas ou para solucionar problemas de conexão. Padrão: false.
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

Executar múltiplas ferramentas Composio em paralelo

Seção intitulada “Executar múltiplas ferramentas Composio em paralelo”

COMPOSIO_MULTI_EXECUTE_TOOL

Executor rápido e paralelo para ferramentas descobertas via COMPOSIO_SEARCH_TOOLS. Executa até 50 ferramentas em paralelo entre aplicativos, desde que sejam logicamente independentes (sem dependências de ordenação ou de saída). As respostas contêm saídas estruturadas prontas para análise imediata.

NomeTipoObrigatórioDescrição
toolsarraySimLista de ferramentas logicamente independentes a executar em paralelo
thoughtstringNãoJustificativa concisa e de alto nível em uma frase (sem detalhamento passo a passo)
sync_response_to_workbenchbooleanSimDefinir como true quando a resposta puder ser grande ou necessária para scripts posteriores. Salva a resposta completa no workbench enquanto retorna uma prévia inline.
memoryobjectNãoDicionário com nomes de aplicativos como chaves e arrays de strings como valores. Armazena fatos duráveis como IDs estáveis, mapeamentos e preferências. Nunca omitir — incluir {} se não houver nada a memorizar.
current_stepstringNãoEnum curto para a etapa atual do fluxo de execução (ex.: FETCHING_EMAILS, GENERATING_REPLIES)
current_step_metricstringNãoMétricas de progresso para a etapa atual, no formato "feito/total unidades" (ex.: "10/100 emails")
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_REMOTE_BASH_TOOL

Executa comandos bash em um sandbox remoto para operações de arquivo, processamento de dados e tarefas de sistema. Essencial para lidar com grandes respostas de ferramentas salvas em arquivos remotos. Limite rígido de 3 minutos (180s) por execução — divida tarefas grandes em comandos menores.

NomeTipoObrigatórioDescrição
commandstringSimO comando bash a executar. Limite rígido de 3 minutos (180s) — divida tarefas grandes em comandos menores.
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_REMOTE_WORKBENCH

Processa arquivos remotos ou orquestra execuções em lote de ferramentas usando código Python em um sandbox Jupyter persistente remoto. Usar apenas para processar dados armazenados em arquivo remoto ou para encadear execuções em lote de ferramentas conhecidas da Composio. Se os dados já estiverem visíveis no chat, não usar esta ferramenta.

NomeTipoObrigatórioDescrição
code_to_executestringSimCódigo Python a executar dentro do sandbox Jupyter persistente remoto. O estado (importações, variáveis, arquivos) é preservado entre execuções. Limite rígido de 3 minutos (180s) — divida tarefas grandes em células menores.
thoughtstringNãoObjetivo breve para esta etapa
current_stepstringNãoEnum curto para a etapa atual do fluxo de execução
current_step_metricstringNãoMétricas de progresso para a etapa atual
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_SEARCH_TOOLS

Descobre ferramentas relevantes, planos de execução recomendados e armadilhas comuns para casos de uso específicos. A Composio conecta mais de 500 aplicativos — Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, pesquisa na web, automação de navegador, Meta (Instagram, Meta Ads), TikTok e muito mais. Sempre chamar esta ferramenta primeiro ao mencionar ou implicar um app ou fluxo de trabalho externo.

NomeTipoObrigatórioDescrição
queriesarraySimConsultas de pesquisa estruturadas em inglês para processar em paralelo. Dividir ações independentes de app/API em consultas separadas, incluindo pré-requisitos implícitos. Cada consulta retorna 4–6 ferramentas.
sessionobjectNãoContexto de sessão para correlacionar chamadas de meta ferramentas em um fluxo de trabalho. Usar {generate_id: true} para novos fluxos ou {id: "ID_EXISTENTE"} para continuar.
modelstringNãoNome do modelo LLM do cliente (recomendado). Usado para otimizar o comportamento de planejamento/pesquisa.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro em caso de falha. Formato: "X de Y pesquisas falharam, motivos: <detalhes>".
successfulbooleanSimIndica se todas as pesquisas foram concluídas com sucesso.

COMPOSIO_WAIT_FOR_CONNECTION

Aguarda que as conexões sejam estabelecidas para os toolkits informados.

NomeTipoObrigatórioDescrição
modestring ("any" | "all")NãoAguardar QUALQUER conexão ou TODAS chegarem ao estado ativo/com falha (padrão: any)
toolkitsarraySimLista de slugs de toolkits a aguardar
timeout_secondsintegerNãoTempo máximo de espera em segundos (padrão: 300, máximo: 600)
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

Criar / Atualizar recipe a partir de fluxo de trabalho

Seção intitulada “Criar / Atualizar recipe a partir de fluxo de trabalho”

COMPOSIO_CREATE_UPDATE_RECIPE

Converte um fluxo de trabalho executado em um notebook reutilizável. Usar apenas quando o fluxo de trabalho estiver completo ou o usuário solicitar explicitamente.

NomeTipoObrigatórioDescrição
recipe_idstringNãoID do recipe a atualizar (opcional). Se não fornecido, um novo recipe será criado.
namestringSimNome do notebook / recipe. Manter curto (idealmente menos de cinco palavras).
descriptionstringSimDescrição do notebook / recipe
output_schemaobjectSimEsquema JSON de saída esperado do notebook / recipe
input_schemaobjectSimEsquema JSON de entrada esperado para o notebook / recipe. Manter simples; todos os tipos de campo de entrada devem ser string.
workflow_codestringSimCódigo Python que implementa o fluxo de trabalho. Deve incluir todas as importações necessárias, execuções de ferramentas (via run_composio_tool) e tratamento de erros adequado. O notebook deve sempre terminar com a célula de saída (não print).
defaults_for_required_parametersobjectNãoValores padrão para os parâmetros obrigatórios do notebook / recipe
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_EXECUTE_RECIPE

Executa um recipe.

NomeTipoObrigatórioDescrição
recipe_idstringSimID do recipe a executar
input_dataobjectSimObjeto de entrada a ser passado para o recipe
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

Criar / Atualizar recipe a partir de fluxo de trabalho (Pydantic)

Seção intitulada “Criar / Atualizar recipe a partir de fluxo de trabalho (Pydantic)”

COMPOSIO_UPSERT_RECIPE

Converte o fluxo de trabalho executado em um recipe usando código Python Pydantic. O parâmetro recipe_slug é obrigatório. Se um recipe com o slug fornecido já existir, uma nova versão será criada. O recipe é definido usando modelos Pydantic que estendem a classe base ComposioRecipe — deve implementar modelos de request e response e o método execute.

NomeTipoObrigatórioDescrição
recipe_slugstringSimIdentificador slug do recipe (obrigatório). Para CRIAR: passar slug SEM o prefixo "RECIPE_" (ex.: "weather_lookup" → torna-se "RECIPE_WEATHER_LOOKUP_C"). Para ATUALIZAR: passar o slug completo exato da resposta de criação. Comprimento máximo: 32 caracteres.
namestringSimNome do notebook / recipe. Manter curto (idealmente menos de cinco palavras).
descriptionstringSimDescrição do notebook / recipe
recipe_codestringSimCódigo Python Pydantic que implementa o recipe, gerado pelo LLM com base no fluxo de trabalho executado. Deve incluir modelos Pydantic de request e response e uma classe de recipe estendendo ComposioRecipe com um método execute.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_RECIPE

Obtém os detalhes de um recipe existente pelo seu slug. Retorna o nome, a descrição, os esquemas de entrada/saída e os toolkits usados pelo recipe. Use para inspecionar a estrutura de um recipe antes de executá-lo.

NomeTipoObrigatórioDescrição
recipe_slugstringSimIdentificador slug do recipe (ex.: RECIPE_MY_WORKFLOW_C). Usar o slug exato retornado na criação.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_RECIPE_DETAILS

Obtém os detalhes de um recipe existente por ID.

NomeTipoObrigatórioDescrição
recipe_idstringSimID do recipe
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_WAIT_FOR_CONNECTIONS

Aguarda que a autenticação do usuário seja concluída. Chamar SOMENTE após exibir o link de autenticação retornado por COMPOSIO_MANAGE_CONNECTIONS. Aguarda até que o modo any/all dos toolkits atinja um estado final (ACTIVE/FAILED) ou o timeout seja atingido.

NomeTipoObrigatórioDescrição
toolkitsarraySimLista de slugs de toolkits a aguardar
modestring ("any" | "all")NãoAguardar QUALQUER conexão ou TODAS chegarem ao estado ativo/com falha (padrão: any)
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

COMPOSIO_GET_TOOL_SCHEMAS

Recupera os esquemas de entrada de ferramentas pelos seus slugs. Retorna definições completas de parâmetros necessários para executar cada ferramenta. Passar apenas slugs de ferramentas retornados por COMPOSIO_SEARCH_TOOLS — nunca adivinhar ou fabricar slugs.

NomeTipoObrigatórioDescrição
tool_slugsarraySimArray de slugs de ferramentas para recuperar os esquemas. Passar slugs válidos; nunca inventar.
includearrayNãoCampos do esquema a incluir. Padrão: ["input_schema"]. Incluir "output_schema" ao chamar ferramentas no workbench para validar a estrutura da resposta.
session_idstringNãoPassar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.