Iniciar sesión

Pasos de agente de IA en flujos de trabajo para formularios de WordPress

El paso de flujo de trabajo ai.agent es la acción de IA del backend que se usa dentro de los flujos de trabajo de Flow.

No envía directamente el correo electrónico final ni la solicitud de webhook. En su lugar, publica un evento ai.agent.requested en el sistema de flujos de trabajo del backend. El backend de IA procesa la solicitud y después emite:

  • ai.agent.completed
  • ai.agent.failed

Los flujos de trabajo posteriores pueden reaccionar a esos eventos de resultado, y las ramas activadas por pasos del mapa de procesos pueden limitar esos flujos posteriores al paso de IA exacto que los emitió.

Requisito previo de implementación​

Para que este paso funcione en producción, el backend de Flow por sí solo no es suficiente.

Necesita:

  • el backend de Flow implementado y sincronizando o ejecutando flujos de trabajo
  • el backend de AI Kit implementado, porque su AiAgentDispatcherFunction interna consume ai.agent.requested y emite ai.agent.completed o ai.agent.failed

Si el distribuidor del backend de AI Kit no está presente o no está configurado correctamente, el flujo de trabajo puede publicar el evento de solicitud de IA, pero nada lo procesará para producir un resultado de IA posterior.

Si espera respuestas o clasificaciones basadas en una base de conocimiento, el backend de AI Kit también necesita una configuración de modelo que funcione y una Knowledge Base configurada con contenido ingerido.

Finalidad de esta pantalla​

La pantalla de configuración del paso Agente de IA combina cuatro aspectos:

  1. la intención de la tarea mediante Mode
  2. el enrutamiento opcional propiedad de la plataforma mediante Internal routing
  3. las instrucciones mediante Prompt Text y Additional System Guidance
  4. la validación de la salida mediante Response Constraint

Si los mantiene separados, resulta mucho más fácil razonar sobre la configuración.

Mode​

Mode es la intención de alto nivel que se envía al backend de IA.

Valores actuales:

  • Answer
  • Summarize
  • Classify
  • Extract structured data

Uso recomendado:

  • elija Answer para la generación general o la redacción de respuestas
  • elija Summarize para resúmenes concisos
  • elija Classify para decisiones de enrutamiento y ramificación
  • elija Extract structured data cuando necesite una salida estructurada predecible

Mode determina los valores predeterminados, pero el comportamiento real sigue dependiendo de las instrucciones y del esquema.

Internal routing​

Internal routing controla si Flow inyecta un contrato de enrutamiento propiedad de la plataforma.

Preajustes actuales:

  • No internal routing
  • Route by category
  • Route by outcomes
  • Draft reply only

Uso recomendado:

  • No internal routing: úselo cuando no quiera el envoltorio de enrutamiento de Flow. Elimina el bloque de enrutamiento de la plataforma, pero cualquier esquema de respuesta personalizado que ya exista puede permanecer hasta que lo borre o sustituya.
  • Route by category: úselo cuando la IA deba elegir una categoría estable como support, sales o billing.
  • Route by outcomes: úselo cuando la IA deba devolver resultados procesables explícitos como invoke_webhook, invoke_workflow o send_email.
  • Draft reply only: úselo cuando el paso deba producir un borrador de respuesta estructurado y no necesite metadatos de enrutamiento.

Route Keys, Outcome Types y Signal Keys​

Cuando el enrutamiento está activado, estos campos determinan lo que la IA puede emitir.

Route Keys​

Use valores de categoría estables como:

  • support
  • sales
  • billing
  • crm_lead

Estos alimentan sugerencias de ramas del mapa de procesos como route:support.

Outcome Types​

Use familias de acciones reutilizables como:

  • invoke_webhook
  • invoke_workflow
  • send_email
  • set_status

Estas admiten claves de rama como outcome:invoke_webhook:create_ticket.

Signal Keys​

Use metadatos estructurados opcionales como:

  • priority
  • language
  • urgency

Estos admiten claves de rama como signal:priority:high.

Prácticas recomendadas:

  • use route para la rama empresarial principal
  • use outcomes para los siguientes pasos procesables
  • use signals solo para metadatos auxiliares

Campos de instrucciones​

Prompt Text​

Prompt Text es la instrucción principal de la tarea y el campo creado por el usuario más importante.

Las buenas instrucciones son concretas, operativas y explícitas sobre la decisión o el artefacto que desea.

Platform System Block​

Flow inyecta automáticamente Platform System Block cuando el preajuste de enrutamiento elegido lo requiere.

No se edita directamente. Su finalidad es aplicar el contrato de enrutamiento seleccionado.

Additional System Guidance​

Additional System Guidance es su propia instrucción de nivel de sistema, añadida después del bloque de la plataforma.

Úsala para restricciones de tono, política o comportamiento, como:

  • ser conciso
  • preferir pruebas de la base de conocimiento
  • evitar afirmaciones especulativas

Mantenga la tarea principal en Prompt Text.

Esquema de respuesta​

Response Schema Presets​

Esta acción genera un esquema inicial para el modo o el preajuste de enrutamiento actual.

Use Apply routing preset cuando quiera reconstruir el esquema del contrato de enrutamiento a partir de la configuración de enrutamiento actual.

Response Constraint (esquema JSON)​

Este es el contrato de esquema JSON en tiempo de ejecución para la salida de la IA.

Cuando el enrutamiento está activado, debe coincidir con el envoltorio de enrutamiento que espera Flow. En la práctica, suele ser un objeto raíz que contiene routing.route, routing.confidence, routing.reason y routing.outcomes, con routing.signals opcional.

Cuando Draft reply only está activado, el esquema debe coincidir con el contrato del borrador de respuesta.

Comportamiento relevante:

  • el JSON no válido permanece en el editor hasta que se corrige
  • el flujo de trabajo conserva el texto del borrador en lugar de descartarlo silenciosamente

Update Status on Dispatch​

Update Status on Dispatch cambie el estado del envío inmediatamente después de publicar ai.agent.requested.

No espera al resultado final de la IA.

Úselo para transiciones de visibilidad como new -> in-progress, no como sustituto del resultado empresarial final.

Primera configuración recomendada​

Para un primer flujo de trabajo con ramificación posterior, una configuración segura es:

  • Mode: Classify
  • Internal routing: Route by category
  • un conjunto pequeño de Route Keys
  • Signal Keys opcionales como priority
  • un esquema de enrutamiento generado por el preajuste
  • instrucciones concisas y orientadas a la tarea

Esto proporciona una ramificación predecible en el mapa de procesos sin obligarte a crear desde el primer día un gran modelo de salida personalizado.

Errores frecuentes​

  • elegir No internal routing y esperar que funcione la ramificación por rutas del mapa de procesos
  • dejar un esquema personalizado anterior mientras se supone que No internal routing convierte la salida en texto completamente libre
  • usar booleanos específicos de un inquilino en lugar de claves estables de ruta o resultado
  • tratar Update Status on Dispatch como la decisión final de la IA en vez de como una transición del estado de procesamiento