Tools
O que o Decopilot pode fazer e os dois tipos de tools a que ele tem acesso
Dois tipos de tools
O Decopilot tem acesso a dois tipos de tools:
Tools built-in — sempre disponíveis, usadas para gerenciar trabalho, delegar tarefas e ler contexto. As mesmas independentemente do escopo.
Scope tools — vêm das connections anexadas no seu escopo atual. No escopo de org, são as built-ins de toda a organização. No escopo de agent, são as tools anexadas ao agent aberto.
Tools built-in
Essas são as tools que o agent Decopilot usa internamente para gerenciar o próprio trabalho — não uma API HTTP pública que você chama de fora. Para a superfície externa, "traga seu próprio client" (endpoints MCP, a REST API de threads do Decopilot), veja a API Reference.
| Tool | Disponível em subtasks | O que faz |
|---|---|---|
subtask | Não | Inicia uma subtask com um agent clonado, outro agent, ou um agent efêmero restrito a uma connection MCP específica |
user_ask | Não | Pergunta a você quando precisa de input |
enable_tool | Sim | Ativa uma scope tool para que ela possa ser chamada no próximo passo |
read_resource | Sim | Lê documentação ou diretrizes do escopo atual |
read_prompt | Sim | Lê um template de prompt reutilizável |
read_tool_output | Sim | Relê um resultado grande de tool que foi descarregado para armazenamento |
web_search | Sim | Executa uma pesquisa web profunda e transmite o resultado (requer um modelo de pesquisa web) |
generate_image | Sim | Gera uma imagem com o modelo de imagem configurado |
propose_plan | Não | Propõe um plano para aprovação (registrada apenas no plan mode) |
Subtasks têm acesso restrito — não podem iniciar subtasks adicionais nem fazer perguntas a você, já que são feitas para executar e reportar de volta sem interrupção.
Agents apoiados por sandbox recebem VM tools
Quando um agent tem um sandbox (um repo do GitHub vinculado, veja Agents), o Decopilot também recebe seis VM tools que operam dentro desse sandbox:
| Tool | O que faz |
|---|---|
bash | Executa um comando de shell no sandbox |
read | Lê um arquivo do sandbox |
write | Escreve um arquivo no sandbox |
edit | Aplica uma edição direcionada a um arquivo existente |
grep | Pesquisa conteúdo de arquivos com ripgrep |
glob | Lista arquivos que correspondem a um padrão de caminho |
Essas tools são provisionadas de forma preguiçosa — o sandbox só inicia na primeira chamada de VM tool.
Scope tools
Scope tools são as capacidades específicas de domínio atreladas ao seu contexto atual. Abra um agent e você verá as tools anexadas a ele — tools Shopify se o agent tiver a connection Shopify, tools de envio se tiver ShipStation, e assim por diante.
Exemplo: um agent de fulfillment de pedidos pode expor:
GET_ORDERS— busca pedidos de clientesUPDATE_INVENTORY— atualiza níveis de estoqueCREATE_SHIPPING_LABEL— gera etiquetas de envioGET_PRODUCTS— lista o catálogo de produtos
Quais tools estão disponíveis depende das connections anexadas ao agent atual. Veja Agents para saber como organizar isso.
Como o Decopilot usa tools
O Decopilot começa cada tarefa apenas com suas tools built-in. Ele vê as scope tools listadas em suas instruções e as utiliza conforme necessário para completar sua solicitação.
Para trabalhos complexos, pode delegar a uma subtask (usando subtask) ou carregar contexto adicional primeiro (usando read_resource ou read_prompt) antes de agir.
A seguir: veja Contexto e tarefas para entender como o Decopilot gerencia memória.