Saltar al contenido principal
Crea un agente de clasificación en TypeScript cuyo modelo, prompt y reglas de proveedor vienen de un preset del panel, de modo que el código solo gestiona el flujo de trabajo. Al terminar devuelve una decisión de clasificación en JSON estricto, detiene los casos que necesitan a una persona, reintenta las llamadas al modelo un número limitado de veces y registra los fallos del gateway con los ID que necesitas para encontrarlos. El script está listo para producción en cuanto exista el preset y guardes las ejecuciones en pausa, como en el bucle duradero. Hay una versión empaquetada en packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts.

Créalo

1

Crea el preset

En Ajustes → Preajustes, crea support-triage con el modelo enrutado, las preferencias de proveedor, el prompt de sistema de soporte y parámetros de decodificación estables. El modelo debe admitir salida con JSON Schema. Presets explica cómo se combina un preset con cada solicitud.
2

Instala

3

Escribe el agente

triage-agent.ts
4

Ejecútalo

Para terminar un caso en pausa, continúalo con la decisión del revisor:

Comprueba que funciona

Ejecuta un ticket rutinario y uno de riesgo, y después comprueba que:
  • En Ajustes → Uso → Registros, el modelo de la solicitud muestra que se usó el preset.
  • El caso de riesgo termina en waiting_for_human con la decisión en pause.payload.
  • Una llamada al modelo reintentada queda registrada en el paso como modelAttempts, y cada reintento registra model.retrying.
  • Una solicitud bloqueada se registra con su requestId y su reason, y la misma solicitud en los registros muestra el motivo.

Mantén visibles los fallos del gateway

No silencies los errores dentro de los callbacks del agente. Captura AgentGatewayError en el borde, registra sus ID y vuelve a lanzarlo. Cuando una ejecución falla, su estado guardado conserva los mismos detalles en run.errorDetails y steps[n].errorDetails, para que un trabajo de recuperación posterior pueda leerlos cuando la excepción ya no exista. Estos fallos vienen de la política del Gateway, no del agente, así que hay que mirar la solicitud en los registros:
Última modificación el 5 de noviembre de 2026