Skip to content

Commit 13c1b48

Browse files
docs: fix decopilot overview tool names and scopes isolation claims (EN + PT-BR)
- Fix overview.mdx: agent_spawn → subtask, tools_search removed, resource_read/edit → read_resource, prompt_read/edit → read_prompt, add sandbox, read_tool_output, propose_plan, user_ask - Soften scopes.mdx isolation claims: subtasks inherit base prompt from parent context with agent instructions layered on top Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 2fa89a7 commit 13c1b48

4 files changed

Lines changed: 22 additions & 18 deletions

File tree

apps/docs/client/src/content/deco-studio/en/studio/decopilot/overview.mdx

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -92,14 +92,16 @@ This layered approach means you're never locked into a narrow view—org-level t
9292
## Built-in Tools
9393

9494
Decopilot comes with built-in tools that enable meta-level operations:
95-
- **`agent_spawn`**: Create child tasks with specialized agents
95+
- **`subtask`**: Create child tasks with specialized agents
9696
- **`agent_search`**: Discover available agents in your organization
97-
- **`tools_search`**: Find tools in the current scope's virtual MCP
98-
- **`tool_enable`**: Activate tools in the current scope before use
99-
- **`resource_read` / `resource_edit`**: Manage project documentation and resources
100-
- **`prompt_read` / `prompt_edit`**: Create reusable prompt templates
101-
102-
These built-in tools are always available and provide the foundation for working with virtual MCPs. Beyond these, you discover and enable tools from your connected MCP servers (Shopify, inventory systems, customer service platforms, etc.) as needed.
97+
- **`user_ask`**: Ask user for input or clarification
98+
- **`sandbox`**: Execute JavaScript code with access to MCP tools
99+
- **`read_resource`**: Read project documentation and resources
100+
- **`read_prompt`**: Read reusable prompt templates
101+
- **`read_tool_output`**: Filter large tool outputs using regex patterns
102+
- **`propose_plan`**: Propose execution plans for user approval
103+
104+
These built-in tools are always available and provide the foundation for working with virtual MCPs. Scope tools from your connected MCP servers (Shopify, inventory systems, customer service platforms, etc.) are available based on the connections in the current scope's Virtual MCP.
103105

104106
See [Tools](/en/studio/decopilot/tools) for complete specifications, usage patterns, and examples of coordinating tools across multiple services.
105107

apps/docs/client/src/content/deco-studio/en/studio/decopilot/scopes.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Scope is determined by **two simple factors**:
3939
- No agent selected → **Project scope**
4040
- Agent selected → **Agent scope**
4141

42-
Each scope is completely isolated—there's no inheritance between scopes. When you select an agent, you only have access to that agent's specific tools and resources.
42+
Scopes are largely isolated—when you select an agent, you primarily access that agent's specific tools and resources. Subtasks inherit a base prompt from the parent context, with agent-specific instructions layered on top.
4343

4444
## Scope and Subtasks
4545

@@ -75,7 +75,7 @@ When you switch, decopilot automatically adjusts available tools and context.
7575

7676
- **Scope adjusts automatically** based on which view you're in and whether an agent is selected
7777
- **Three scope types** provide different capabilities: organization, project, and agent
78-
- **Each scope is isolated** with its own tools and resources
78+
- **Each scope has its own tools and resources**, with subtasks inheriting base context
7979
- **Agents are focused** on specialized tasks to maintain clarity
8080

8181
Understanding scope helps you work effectively with decopilot—you'll know what's available and how to organize your work.

apps/docs/client/src/content/deco-studio/pt-br/studio/decopilot/overview.mdx

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -92,14 +92,16 @@ Esta abordagem em camadas significa que voce nunca fica preso a uma visao restri
9292
## Ferramentas Integradas
9393

9494
O decopilot vem com ferramentas integradas que habilitam operacoes em nivel meta:
95-
- **`agent_spawn`**: Criar tarefas filhas com agentes especializados
95+
- **`subtask`**: Criar tarefas filhas com agentes especializados
9696
- **`agent_search`**: Descobrir agentes disponiveis na sua organizacao
97-
- **`tools_search`**: Encontrar ferramentas no MCP virtual do escopo atual
98-
- **`tool_enable`**: Ativar ferramentas no escopo atual antes do uso
99-
- **`resource_read` / `resource_edit`**: Gerenciar documentacao e recursos do projeto
100-
- **`prompt_read` / `prompt_edit`**: Criar templates de prompt reutilizaveis
101-
102-
Estas ferramentas integradas estao sempre disponiveis e fornecem a base para trabalhar com MCPs virtuais. Alem delas, voce descobre e habilita ferramentas dos seus servidores MCP conectados (Shopify, sistemas de inventario, plataformas de atendimento ao cliente, etc.) conforme necessario.
97+
- **`user_ask`**: Pedir entrada ou esclarecimento ao usuario
98+
- **`sandbox`**: Executar codigo JavaScript com acesso a ferramentas MCP
99+
- **`read_resource`**: Ler documentacao e recursos do projeto
100+
- **`read_prompt`**: Ler templates de prompt reutilizaveis
101+
- **`read_tool_output`**: Filtrar saidas grandes de ferramentas usando padroes regex
102+
- **`propose_plan`**: Propor planos de execucao para aprovacao do usuario
103+
104+
Estas ferramentas integradas estao sempre disponiveis e fornecem a base para trabalhar com MCPs virtuais. As ferramentas de escopo dos seus servidores MCP conectados (Shopify, sistemas de inventario, plataformas de atendimento ao cliente, etc.) sao disponibilizadas com base nas conexoes do MCP Virtual do escopo atual.
103105

104106
Veja [Ferramentas](/pt-br/studio/decopilot/tools) para especificacoes completas, padroes de uso e exemplos de coordenacao de ferramentas entre multiplos servicos.
105107

apps/docs/client/src/content/deco-studio/pt-br/studio/decopilot/scopes.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ O escopo e determinado por **dois fatores simples**:
3939
- Nenhum agente selecionado -> **Escopo de projeto**
4040
- Agente selecionado -> **Escopo de agente**
4141

42-
Cada escopo e completamente isolado — nao ha heranca entre escopos. Quando voce seleciona um agente, voce tem acesso apenas as ferramentas e recursos especificos daquele agente.
42+
Escopos sao em grande parte isolados — quando voce seleciona um agente, voce acessa principalmente as ferramentas e recursos especificos daquele agente. Subtarefas herdam um prompt base do contexto pai, com instrucoes especificas do agente adicionadas por cima.
4343

4444
## Escopo e Subtarefas
4545

@@ -75,7 +75,7 @@ Quando voce alterna, o decopilot ajusta automaticamente as ferramentas e o conte
7575

7676
- **O escopo se ajusta automaticamente** com base na visao em que voce esta e se um agente esta selecionado
7777
- **Tres tipos de escopo** fornecem diferentes capacidades: organizacao, projeto e agente
78-
- **Cada escopo e isolado** com suas proprias ferramentas e recursos
78+
- **Cada escopo tem suas proprias ferramentas e recursos**, com subtarefas herdando contexto base
7979
- **Agentes sao focados** em tarefas especializadas para manter a clareza
8080

8181
Entender o escopo ajuda voce a trabalhar efetivamente com o decopilot — voce sabera o que esta disponivel e como organizar seu trabalho.

0 commit comments

Comments
 (0)