Passer au contenu principal
Définissez toolExecution.toolConcurrency pour que l’Agent SDK TypeScript exécute en même temps plusieurs appels d’outils indépendants d’un même tour de modèle, au lieu de les enchaîner. À la fin, vous avez un agent qui réunit en parallèle la documentation, l’état et le contexte des incidents, tout en enregistrant les résultats dans l’ordre où le modèle les a demandés. Les outils renvoient des données d’exemple fixes : le script est donc illustratif ; remplacez-les par vos propres recherches en lecture seule. Une version packagée se trouve dans packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.

Le construire

1

Installer

2

Écrire l’agent

parallel-agent.ts
3

L’exécuter

Vérifier que ça fonctionne

  • Quand le modèle demande les trois outils dans un même tour, les trois lignes tool.started s’affichent avant les lignes tool.completed correspondantes, avec des horodatages proches.
  • result.messages liste les résultats des outils dans l’ordre des appels d’outils du modèle, quel que soit l’ordre dans lequel ils se sont terminés.
  • L’exécution se termine avec un seul résumé dans result.output.

Ce qui s’exécute en même temps

tool.started et tool.completed sont toujours émis pour chaque appel, et l’exécution enregistre un point de reprise une fois la phase d’outils terminée.

Garder l’exécution sûre

N’utilisez la concurrence que pour des outils qui ne dépendent pas de la sortie des autres et ne modifient pas d’état partagé. Commencez à 2 ou 3, gardez des outils idempotents avec peu d’effets de bord et validez chaque argument avec inputSchema, comme ci-dessus. Ajoutez un accesseur state, comme dans la boucle durable, seulement si vous devez reprendre des exécutions. Avant de vous y fier, lancez vos tests qui couvrent les tours à plusieurs outils et vérifiez l’ordre des résultats.
Dernière modification le 5 novembre 2026