Composio
Visão geral
Seção intitulada “Visão geral”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.
- Documentação na Composio: docs.composio.dev/toolkits/composio
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza sem autenticação (NO_AUTH) para conectar.
| Campo | Obrigatório | Descrição |
|---|---|---|
| N/A | Não | Esta ferramenta não exige credenciais. |
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Composio. - 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.)
Ações disponíveis
Seção intitulada “Ações disponíveis”Verificar conexão ativa (descontinuada)
Seção intitulada “Verificar conexão ativa (descontinuada)”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
connected_account_id | string | Não | ID da conta conectada específica cujo status verificar |
toolkit | string | Não | Nome do toolkit a verificar |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Verificar múltiplas conexões ativas
Seção intitulada “Verificar múltiplas conexões ativas”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
requests | array | Sim | Lista de solicitações de verificação de conexão |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar plano
Seção intitulada “Criar plano”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
difficulty | string ("medium" | "hard") | Sim | Ní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_fields | string | Sim | Entradas 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_slugs | array | Sim | Lista de slugs de ferramentas primárias que podem realizar a tarefa principal. Nunca inventar slugs; usar apenas os retornados por Search. |
reasoning | string | Sim | Breve raciocínio sobre o caso de uso e como as ferramentas selecionadas podem realizá-lo |
related_tool_slugs | array | Não | Lista de slugs de ferramentas relacionadas/de suporte que podem ser úteis. Nunca inventar slugs. |
use_case | string | Sim | Explicação detalhada do caso de uso que o usuário está tentando realizar |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Habilitar gatilho
Seção intitulada “Habilitar gatilho”COMPOSIO_ENABLE_TRIGGER
Habilita um gatilho específico para o usuário autenticado.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
config_params | object | Não | Parâmetros de configuração para o gatilho |
connected_account_id | string | Sim | ID da conta conectada para a qual habilitar o gatilho |
toolkit_slug | string | Sim | Slug do toolkit |
trigger_name | string | Sim | Nome do gatilho a habilitar |
user_id | string | Não | ID do usuário para o gatilho |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar ferramenta Composio
Seção intitulada “Executar ferramenta Composio”COMPOSIO_EXECUTE_TOOL
Executa uma ferramenta usando a API da Composio.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
allow_destructive | boolean | Não | Se deve permitir a execução de ferramentas destrutivas. Se true, a ferramenta será executada mesmo que seja destrutiva. |
arguments | object | Sim | Os argumentos a serem passados para a ferramenta. O esquema dos argumentos está presente na resposta de retrieve_actions. |
connected_account_id | string | Não | ID da conta conectada a usar. Se não fornecido, usa a primeira conexão ativa do toolkit. |
tool_slug | string | Sim | O slug da ferramenta a executar, obtido da lista de ferramentas retornada por retrieve_actions. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter grafo de dependências da ferramenta
Seção intitulada “Obter grafo de dependências da ferramenta”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tool_name | string | Sim | Nome da ferramenta para obter o grafo de dependências |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter parâmetros obrigatórios para conexão
Seção intitulada “Obter parâmetros obrigatórios para conexão”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
toolkit | string | Sim | Nome 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. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter esquema de resposta
Seção intitulada “Obter esquema de resposta”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tool | string | Sim | Nome da ferramenta. Por exemplo: GITHUB_LIST_PULL_REQUESTS. Os nomes relevantes podem ser encontrados usando a ferramenta COMPOSIO_RETRIEVE_ACTIONS. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Iniciar conexão
Seção intitulada “Iniciar conexão”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
parameters | object | Não | Parâ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. |
toolkit | string | Sim | Nome do toolkit a conectar (ex.: 'gmail', 'github', 'linear') |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar toolkits
Seção intitulada “Listar toolkits”COMPOSIO_LIST_TOOLKITS
Lista todos os toolkits disponíveis na Composio com opções de filtragem.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
category | string | Não | Filtrar toolkits por categoria |
min_tools | integer | Não | Filtrar toolkits por número mínimo de ferramentas |
name_filter | string | Não | Filtrar toolkits por nome/slug |
no_auth_only | boolean | Não | Retornar apenas toolkits que não exigem autenticação |
size | integer | Não | Limitar o número de resultados retornados |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar gatilhos
Seção intitulada “Listar gatilhos”COMPOSIO_LIST_TRIGGERS
Lista os gatilhos disponíveis e seus esquemas de configuração.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
toolkit_names | array | Não | Lista de nomes de toolkits para filtrar os gatilhos. Se não fornecida ou vazia, todos os gatilhos serão retornados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Gerenciar conexões
Seção intitulada “Gerenciar conexões”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
toolkits | array | Sim | Slugs de toolkits para verificar ou conectar. Devem ser slugs válidos; nunca inventar. Exemplos: ['gmail', 'github', 'slack', 'googlesheets', 'outlook']. |
reinitiate_all | boolean | Não | Forç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_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica 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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tools | array | Sim | Lista de ferramentas logicamente independentes a executar em paralelo |
thought | string | Não | Justificativa concisa e de alto nível em uma frase (sem detalhamento passo a passo) |
sync_response_to_workbench | boolean | Sim | Definir 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. |
memory | object | Não | Dicioná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_step | string | Não | Enum curto para a etapa atual do fluxo de execução (ex.: FETCHING_EMAILS, GENERATING_REPLIES) |
current_step_metric | string | Não | Métricas de progresso para a etapa atual, no formato "feito/total unidades" (ex.: "10/100 emails") |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar comandos bash remotamente
Seção intitulada “Executar comandos bash remotamente”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
command | string | Sim | O comando bash a executar. Limite rígido de 3 minutos (180s) — divida tarefas grandes em comandos menores. |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar código remotamente no workbench
Seção intitulada “Executar código remotamente no workbench”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
code_to_execute | string | Sim | Có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. |
thought | string | Não | Objetivo breve para esta etapa |
current_step | string | Não | Enum curto para a etapa atual do fluxo de execução |
current_step_metric | string | Não | Métricas de progresso para a etapa atual |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Pesquisar ferramentas Composio
Seção intitulada “Pesquisar ferramentas Composio”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
queries | array | Sim | Consultas 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. |
session | object | Não | Contexto 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. |
model | string | Não | Nome do modelo LLM do cliente (recomendado). Usado para otimizar o comportamento de planejamento/pesquisa. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro em caso de falha. Formato: "X de Y pesquisas falharam, motivos: <detalhes>". |
successful | boolean | Sim | Indica se todas as pesquisas foram concluídas com sucesso. |
Aguardar conexão
Seção intitulada “Aguardar conexão”COMPOSIO_WAIT_FOR_CONNECTION
Aguarda que as conexões sejam estabelecidas para os toolkits informados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
mode | string ("any" | "all") | Não | Aguardar QUALQUER conexão ou TODAS chegarem ao estado ativo/com falha (padrão: any) |
toolkits | array | Sim | Lista de slugs de toolkits a aguardar |
timeout_seconds | integer | Não | Tempo máximo de espera em segundos (padrão: 300, máximo: 600) |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica 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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe_id | string | Não | ID do recipe a atualizar (opcional). Se não fornecido, um novo recipe será criado. |
name | string | Sim | Nome do notebook / recipe. Manter curto (idealmente menos de cinco palavras). |
description | string | Sim | Descrição do notebook / recipe |
output_schema | object | Sim | Esquema JSON de saída esperado do notebook / recipe |
input_schema | object | Sim | Esquema JSON de entrada esperado para o notebook / recipe. Manter simples; todos os tipos de campo de entrada devem ser string. |
workflow_code | string | Sim | Có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_parameters | object | Não | Valores padrão para os parâmetros obrigatórios do notebook / recipe |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar recipe
Seção intitulada “Executar recipe”COMPOSIO_EXECUTE_RECIPE
Executa um recipe.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe_id | string | Sim | ID do recipe a executar |
input_data | object | Sim | Objeto de entrada a ser passado para o recipe |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica 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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe_slug | string | Sim | Identificador 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. |
name | string | Sim | Nome do notebook / recipe. Manter curto (idealmente menos de cinco palavras). |
description | string | Sim | Descrição do notebook / recipe |
recipe_code | string | Sim | Có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. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter detalhes do recipe por slug
Seção intitulada “Obter detalhes do recipe por slug”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe_slug | string | Sim | Identificador slug do recipe (ex.: RECIPE_MY_WORKFLOW_C). Usar o slug exato retornado na criação. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter detalhes de recipe existente
Seção intitulada “Obter detalhes de recipe existente”COMPOSIO_GET_RECIPE_DETAILS
Obtém os detalhes de um recipe existente por ID.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe_id | string | Sim | ID do recipe |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Aguardar conexões (plural)
Seção intitulada “Aguardar conexões (plural)”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
toolkits | array | Sim | Lista de slugs de toolkits a aguardar |
mode | string ("any" | "all") | Não | Aguardar QUALQUER conexão ou TODAS chegarem ao estado ativo/com falha (padrão: any) |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter esquemas de ferramentas
Seção intitulada “Obter esquemas de ferramentas”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tool_slugs | array | Sim | Array de slugs de ferramentas para recuperar os esquemas. Passar slugs válidos; nunca inventar. |
include | array | Não | Campos do esquema a incluir. Padrão: ["input_schema"]. Incluir "output_schema" ao chamar ferramentas no workbench para validar a estrutura da resposta. |
session_id | string | Não | Passar o session_id recebido de uma chamada anterior a COMPOSIO_SEARCH_TOOLS |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |