Passer au contenu principal
Créez un agent de tri TypeScript dont le modèle, le prompt et les règles de fournisseur viennent d’un préréglage du tableau de bord, pour que le code ne gère que le flux de travail. À la fin, il renvoie une décision de tri en JSON strict, met en pause les cas qui nécessitent une personne, relance les appels au modèle un nombre limité de fois et journalise les échecs du Gateway avec les identifiants nécessaires pour les retrouver. Le script est prêt pour la production une fois le préréglage créé et à condition de stocker les exécutions en pause, comme dans la boucle durable. Une version packagée se trouve dans packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts.

Le construire

1

Créer le préréglage

Dans Paramètres → Préréglages, créez support-triage avec le modèle routé, les préférences de fournisseur, le prompt système du support et des paramètres de décodage stables. Le modèle doit prendre en charge la sortie JSON Schema. Préréglages explique comment un préréglage se combine avec chaque requête.
2

Installer

3

Écrire l’agent

triage-agent.ts
4

L’exécuter

Pour terminer un cas en pause, continuez-le avec la décision du relecteur :

Vérifier que ça fonctionne

Exécutez un ticket courant et un ticket à risque, puis vérifiez que :
  • Dans Paramètres → Utilisation → Journaux, le modèle de la requête montre que le préréglage a été utilisé.
  • Le cas à risque se termine sur waiting_for_human, avec la décision dans pause.payload.
  • Un appel au modèle relancé est enregistré sur l’étape dans modelAttempts, et chaque nouvelle tentative journalise model.retrying.
  • Une requête bloquée est journalisée avec son requestId et sa reason, et la même requête dans les journaux en indique la raison.

Garder visibles les échecs du Gateway

N’absorbez pas les erreurs dans les callbacks de l’agent. Interceptez AgentGatewayError en bordure, journalisez ses identifiants et relancez l’erreur. Une fois qu’une exécution échoue, son état enregistré conserve les mêmes détails dans run.errorDetails et steps[n].errorDetails, pour qu’une tâche de reprise ultérieure puisse les lire une fois l’exception disparue. Ces échecs viennent de la politique du Gateway, pas de l’agent : c’est donc dans la requête des journaux qu’il faut regarder :
Dernière modification le 5 novembre 2026