Resumos de Uso de Ferramentas

O Qwen Code pode gerar um rótulo curto, no estilo de assunto de commit git, após cada lote de ferramentas ser concluído, resumindo o que foi realizado. O rótulo aparece inline no transcript e substitui o cabeçalho genérico Tool × N no modo compacto.

Isso é um auxílio de UX para chamadas paralelas de ferramentas: quando o modelo se ramifica em várias chamadas Read + Grep + Bash de uma só vez, o resumo mostra a intenção de relance, em vez de forçá-lo a escanear a lista de ferramentas.

O recurso está habilitado por padrão e é executado silenciosamente em segundo plano. Ele requer um modelo rápido configurado.

O que Você Vê

Modo completo (padrão)

O resumo aparece como uma linha de selo escurecida diretamente abaixo do grupo de ferramentas:

╭──────────────────────────────────────────────╮
│ ✓  ReadFile a.txt                            │
│ ✓  ReadFile b.txt                            │
│ ✓  ReadFile c.txt                            │
│ ✓  ReadFile d.txt                            │
╰──────────────────────────────────────────────╯

 ● Read 4 text files

Modo compacto (Ctrl+O ou ui.compactMode: true)

O rótulo substitui o cabeçalho genérico Tool × N no one-liner compacto:

╭──────────────────────────────────────────────╮
│✓  Read txt files  · 4 tools                  │
│Press Ctrl+O to show full tool output         │
╰──────────────────────────────────────────────╯

As chamadas individuais das ferramentas ainda estão a uma tecla de distância (Ctrl+O para alternar para o modo completo).

Como Funciona

Após um lote de ferramentas ser finalizado, o Qwen Code dispara uma chamada do tipo fire-and-forget para o modelo rápido configurado com:

• Os nomes das ferramentas, argumentos truncados e resultados truncados (cada um limitado a 300 caracteres).
• A saída de texto mais recente do assistente (primeiros 200 caracteres) como um prefixo de intenção.
• Um prompt de sistema instruindo o modelo a retornar um rótulo no passado, com 30 caracteres, no estilo de assunto de commit git.

A chamada é executada em paralelo com o streaming da API da próxima rodada, então sua latência de ~1s fica oculta atrás da resposta do modelo principal. Quando o rótulo é resolvido, ele é anexado ao transcript como uma entrada tool_use_summary.

Exemplos de rótulos: Searched in auth/, Fixed NPE in UserService, Created signup endpoint, Read config.json, Ran failing tests.

Quando Aparece

O resumo é gerado quando todas as condições a seguir são verdadeiras:

• experimental.emitToolUseSummaries é true (padrão).
• Um fastModel está configurado (via configurações ou /model --fast).
• Pelo menos uma ferramenta foi concluída no lote.
• A rodada não foi abortada antes da conclusão da ferramenta.
• O modelo rápido retornou uma resposta não vazia e sem erros.

Chamadas de ferramentas de subagentes não disparam a geração de resumo — apenas os lotes de ferramentas da sessão principal o fazem.

Quando Não Aparece

O resumo é silenciosamente ignorado (sem erro, sem alteração na interface) quando:

• Nenhum modelo rápido está configurado.
• A chamada do modelo rápido falha, expira ou retorna vazia.
• O modelo retornou uma string com aparência de mensagem de erro (ex.: Error: ..., I cannot ...) — filtrada pelo cliente para que a interface não mostre rótulos enganosos.
• A rodada foi abortada (Ctrl+C) antes da conclusão do modelo.

Em todos esses casos, o grupo de ferramentas é renderizado como sempre foi.

Modelo Rápido

O rótulo é gerado usando o modelo rápido — o mesmo modelo configurado para sugestões de prompt e execução especulativa. Configure-o via:

Via comando

/model --fast qwen3-coder-flash

Via settings.json

{
  "fastModel": "qwen3-coder-flash"
}

Quando nenhum modelo rápido está configurado, a geração de resumo é totalmente ignorada — o recurso não tem efeito até que você configure um.

Configuração

Estas configurações podem ser definidas em settings.json:

Sobrescrita de ambiente

QWEN_CODE_EMIT_TOOL_USE_SUMMARIES sobrescreve a configuração experimental.emitToolUseSummaries para a sessão atual:

• QWEN_CODE_EMIT_TOOL_USE_SUMMARIES=0 ou =false — força desligado.
• QWEN_CODE_EMIT_TOOL_USE_SUMMARIES=1 ou =true — força ligado.
• Não definido — usa a configuração experimental.emitToolUseSummaries.

Exemplo

{
  "fastModel": "qwen3-coder-flash",
  "experimental": {
    "emitToolUseSummaries": true
  }
}

Escopo e ciclo de vida

Três pontos que costumam confundir em uma primeira leitura deste recurso:

1. Uma geração por lote, compartilhada por ambos os modos de exibição. A chamada ao modelo rápido ocorre exatamente uma vez em handleCompletedTools quando um lote de ferramentas é finalizado. Alternar com Ctrl+O depois disso não dispara uma nova chamada — ambos os modos leem da mesma entrada de histórico tool_use_summary capturada na primeira vez. Você pode alternar o modo compacto livremente sem custo adicional.

2. Sem preenchimento retroativo ao alternar ou ao retomar sessão. Um tool_group que foi concluído antes de o recurso ser ativado (ou antes de você ativar a configuração, ou em uma sessão retomada — o ChatRecordingService não persiste entradas de resumo) nunca receberá um rótulo. Não há uma varredura de histórico existente. Se você ativar esta configuração no meio de uma sessão, apenas lotes futuros mostrarão um rótulo; grupos mais antigos mantêm a renderização padrão sem indicador de que um rótulo está faltando.

3. Apenas lotes do agente principal. O gatilho reside no loop de rodadas da sessão principal (useGeminiStream), então:

   • ✅ Shell, MCP, operações de arquivo e a própria chamada da ferramenta Task / subagente (conforme aparece no lote principal) são resumidos.
   • ❌ Os lotes de ferramentas internos de um subagente (executados por meio de packages/core/src/agents/runtime/) não são resumidos.

   Um lote externo que contém uma ferramenta Task ainda será rotulado, mas o modelo rápido vê apenas a chamada da ferramenta subagente e sua saída agregada — não as chamadas individuais dentro do subagente. Espere rótulos como Ran research-agent ou Delegated file search em vez de Searched 14 files. Isso é intencional — resumir os internos do subagente multiplicaria o custo do modelo rápido e traria ruído que nunca aparece na interface primária.

Emparelhamento recomendado: ativar modo compacto

Para lotes de 3 ou mais chamadas paralelas de ferramentas, emparelhar este recurso com ui.compactMode: true produz o transcript mais limpo. A visualização compacta dobra todo o lote em uma única linha rotulada (✓ Read txt files · 4 tools) em vez de mostrar cada linha de ferramenta mais o resumo final. Os detalhes permanecem a uma tecla de distância via Ctrl+O.

{
  "fastModel": "qwen3-coder-flash",
  "ui": {
    "compactMode": true
  },
  "experimental": {
    "emitToolUseSummaries": true
  }
}

No modo completo (padrão), o resumo é renderizado como uma linha ● <rótulo> abaixo do grupo de ferramentas — útil para lotes grandes ou heterogêneos, mas para lotes pequenos do mesmo tipo (ex.: Read × 3) o rótulo pode parecer uma repetição das linhas visíveis. Se isso corresponde ao seu fluxo de trabalho usual, ative o modo compacto como acima ou desative o resumo completamente via experimental.emitToolUseSummaries: false.

Monitoramento

O uso do modelo de resumo aparece na saída de /stats sob os totais de tokens do modelo rápido, com o prompt_id tool_use_summary_generation para que possa ser distinguido das sugestões de prompt e outras tarefas em segundo plano.

Fluxo de dados e privacidade

A chamada de resumo envia o nome, args truncado e resultado truncado de cada ferramenta bem-sucedida (cada campo limitado a 300 caracteres) para o modelo rápido, além dos primeiros 200 caracteres do texto mais recente do assistente como um prefixo de intenção.

Se o seu modelo rápido estiver configurado para o mesmo provedor/auth que o modelo da sessão principal, os dados fluem pelos mesmos limites que sua sessão principal já usa — sem alteração no escopo de confiança. Se você configurou um modelo rápido de um provedor diferente, as entradas e saídas das ferramentas (potencialmente incluindo conteúdos de arquivos lidos por read_file, saídas de comandos de chamadas shell ou valores expostos por ferramentas MCP) serão enviadas a esse outro provedor como parte do prompt de sumarização. Isso é um escopo de compartilhamento de dados estritamente maior do que apenas a sessão principal.

Se isso for relevante para seu fluxo de trabalho, você tem duas opções claras:

• Configure fastModel para um modelo sob o mesmo provedor da sessão principal, para que a chamada de resumo não cruze nenhum novo limite de auth/dados.
• Desative o recurso completamente com experimental.emitToolUseSummaries: false (ou QWEN_CODE_EMIT_TOOL_USE_SUMMARIES=0).

O limite de 300 caracteres por campo reduz a exposição, mas não a elimina — segredos descobertos na saída das ferramentas durante a janela de limite ainda podem ser enviados. Trate o limite de dados do modelo rápido da mesma forma que trata o do modelo principal.

Custo

Uma chamada ao modelo rápido por lote qualificado. A entrada é um pequeno prompt de sistema fixo mais as entradas/saídas truncadas das ferramentas (cada campo limitado a 300 caracteres). A saída é uma única linha curta (limitada a 100 caracteres, tipicamente 20 tokens ou menos). Em um modelo rápido típico, isso custa aproximadamente $0,001 por lote.

Se você não quiser o custo extra, desative o recurso via experimental.emitToolUseSummaries: false ou QWEN_CODE_EMIT_TOOL_USE_SUMMARIES=0.

Relacionados

• Modo Compacto — alterne com Ctrl+O; o resumo substitui o cabeçalho genérico do grupo de ferramentas quando o modo compacto está ativo.
• Sugestões de Acompanhamento — outro aprimoramento de UX acionado pelo modelo rápido que compartilha a mesma configuração fastModel.