Pular para o conteúdo principal
Defina toolExecution.toolConcurrency para que o Agent SDK de TypeScript execute ao mesmo tempo várias chamadas de ferramentas independentes de um turno do modelo, em vez de uma após a outra. Ao final, você terá um agente que reúne em paralelo contexto de documentação, status e incidentes e ainda registra os resultados na ordem em que o modelo os pediu. As ferramentas retornam dados de exemplo fixos, então o script é ilustrativo; substitua-as pelas suas próprias consultas somente leitura. Uma versão empacotada está em packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.

Crie o agente

1

Instale

2

Escreva o agente

parallel-agent.ts
3

Execute

Verifique se funcionou

  • Quando o modelo pede as três ferramentas em um único turno, as três linhas tool.started são impressas antes das linhas tool.completed correspondentes, com timestamps próximos.
  • result.messages lista os resultados das ferramentas na ordem das chamadas feitas pelo modelo, seja qual for a ordem em que terminaram.
  • A execução termina com um único resumo em result.output.

O que é executado em conjunto

tool.started e tool.completed continuam sendo disparados para cada chamada, e a execução salva um checkpoint quando a fase de ferramentas termina.

Mantenha a segurança

Use concorrência apenas em ferramentas que não dependem da saída umas das outras e não alteram estado compartilhado. Comece com 2 ou 3, mantenha as ferramentas idempotentes e com poucos efeitos colaterais, e valide cada argumento com inputSchema, como acima. Adicione um acessor state, como no loop persistente, apenas quando precisar retomar execuções. Antes de depender disso, rode seus testes que cobrem turnos com várias ferramentas e confira a ordem dos resultados.
Última modificação em 5 de novembro de 2026