Saltar al contenido principal
Configura toolExecution.toolConcurrency para que el Agent SDK de TypeScript ejecute a la vez varias llamadas a herramientas independientes de un mismo turno del modelo, en lugar de una tras otra. Al terminar tendrás un agente que reúne en paralelo contexto de documentación, estado e incidentes, y aun así registra los resultados en el orden en que el modelo los pidió. Las herramientas devuelven datos de ejemplo fijos, así que el script es ilustrativo; sustitúyelas por tus propias consultas de solo lectura. Hay una versión empaquetada en packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.

Créalo

1

Instala

2

Escribe el agente

parallel-agent.ts
3

Ejecútalo

Comprueba que funciona

  • Cuando el modelo pide las tres herramientas en un mismo turno, las tres líneas tool.started se imprimen antes que las líneas tool.completed correspondientes, con marcas de tiempo cercanas.
  • result.messages enumera los resultados de las herramientas en el orden de las llamadas del modelo, sea cual sea el orden en que terminaron.
  • La ejecución termina con un único resumen en result.output.

Qué se ejecuta a la vez

tool.started y tool.completed se siguen emitiendo para cada llamada, y la ejecución guarda un punto de control cuando termina la fase de herramientas.

Mantenlo seguro

Usa la concurrencia solo con herramientas que no dependan de la salida de las demás ni modifiquen estado compartido. Empieza con 2 o 3, mantén las herramientas idempotentes y con pocos efectos secundarios, y valida cada argumento con inputSchema como arriba. Añade un accesor state, como en el bucle duradero, solo cuando necesites reanudar ejecuciones. Antes de confiar en ello, ejecuta tus pruebas que cubren turnos con varias herramientas y comprueba el orden de los resultados.
Última modificación el 5 de noviembre de 2026