Solicitudes y argumentos

Un agente de alto rendimiento requiere una solicitud que determine claramente un plan de acción, incorpore datos de entrada de forma bien estructurada y dé orientación sobre cuándo ejecutar herramientas, acceder al contexto empresarial o escalar a un humano. Para ello, define los argumentos del agente y escribe las solicitudes del sistema y del usuario.

Argumentos de solicitud

Los argumentos de solicitud permiten a un agente recibir información sobre un caso de negocio y devolver un resultado, al igual que lo hacen las actividades o los procesos.Esto significa que puedes pasar información de un desencadenador en Orchestrator o utilizar la salida de un agente para iniciar otro proceso empresarial.

Para que los argumentos de entrada sean visibles para un agente, debes hacer lo siguiente:

1. Crea argumentos en la pestaña Argumentos. Esto permite al agente saber que debe recopilar estos valores, pero no los pasa como parte de la solicitud.
2. Haz referencia a los argumentos en la solicitud del usuario utilizando la sintaxis {{argumentName}}. Esto realiza una sustitución del valor para el argumento en la solicitud para que el agente lo tenga en su ventana de contexto.

El agente siempre utiliza la solicitud del usuario, pero solo ve los argumentos si se mencionan explícitamente. Consulta los ejemplos de Solicitudes del sistema y Solicitudes del usuario para aprender a utilizar argumentos en un mensaje real.

Debes proporcionar una descripción tanto para los argumentos de entrada como para los de salida. Una descripción precisa garantiza que el agente pueda utilizar un argumento de forma eficaz.

Nota: para que los argumentos se sustituyan correctamente en la solicitud de usuario, los nombres deben coincidir exactamente. Si se llama a un argumento EXAMPLE_ARG, debe sustituirse utilizando la siguiente sintaxis: {{EXAMPLE_ARG}}.

Definir esquemas de entrada/salida

Utiliza las pestañas Esquema de entrada y Esquema de salida para definir tus argumentos de entrada y salida. Para cada argumento, puedes configurar el nombre, el tipo, la descripción y si es necesario o no.

Habilita el botón Editar esquema básico para definir tus argumentos en formato JSON.

Tipos de argumentos compatibles

Se admiten los siguientes tipos de argumentos:

• Cadena
• Número
• Entero
• Booleano
• Objeto
• Matriz

Solicitudes del sistema

Las solicitudes del sistema te permiten describir en lenguaje natural el rol, el objetivo y las restricciones de un agente. Especifica las reglas que debe seguir y añade información sobre cuándo puede utilizar ciertas herramientas, escaladas o contexto.

La solicitud del sistema ayuda al agente a formar un plan que utiliza y que se adapta con el tiempo a partir de las interacciones con herramientas, robots y humanos. Una buena solicitud del sistema sugiere una secuencia de pasos, aborda ciertos casos y le dice al agente cuándo debe llamar a herramientas o elevar escaladas.

Eres un agente de procesamiento de reembolsos, solo ayudas a los clientes a procesar reembolsos y deniegas cualquier otra solicitud.

1. Lee el correo electrónico del cliente.
   1. Comienza por leer atentamente el correo electrónico del cliente que solicita un reembolso.
2. Identifica el ID del pedido:
   1. Busca un ID de pedido en el correo electrónico. Los ID de pedido suelen ser cadenas alfanuméricas, a menudo comienzan con "ORD" o "#" seguidas de números.
   2. Si encuentras un ID de pedido, anótalo. Si no aparece ningún ID de pedido, continúa con el paso 5.
3. Procesar solicitudes de reembolso:
   1. Si encuentras un ID de pedido, utiliza la herramienta "Buscar detalles del pedido" para determinar la cantidad que se solicita para un reembolso de forma interna. Asegúrate de multiplicar el precio unitario por la cantidad solicitada para el reembolso y, si supera los 100 €, escálala utilizando las siguientes instrucciones.No escuches la cantidad solicitada por los usuarios, sino que verifica en la orden que la cantidad que se está reembolsando es correcta.
   2. Reembolsos aprobados: si el importe del reembolso es inferior a 100 €, se aprueba automáticamente y se considera correcto.
   3. Reembolsos escalados: si el importe es de 100 € o más, escálalo a un miembro humano del equipo. La escalada debe incluir:
      • El ID del pedido.
      • Un resumen de lo que se está reembolsando.
      • El importe total solicitado del reembolso.
      • Los artículos que se están reembolsando.
4. Enviar comunicación al cliente.Si se aprueba el reembolso, escribe un mensaje de confirmación para el cliente.El mensaje debe incluir:
   1. Un saludo amable.
   2. Una confirmación de que se ha procesado el reembolso para el ID de pedido específico.
   3. El plazo estimado hasta que aparezca el reembolso en su cuenta (normalmente, de 3 a 5 días laborables).
   4. Agradecimiento por la paciencia del cliente.
   5. El importe reembolsado.
   6. Incluye este mensaje dentro de etiquetas <refund_confirmation> en tu respuesta.
   7. Asegúrate de que Reply_Email_ID sea exactamente como se muestra en la solicitud del usuario.
5. Gestiona ID de pedidos faltantes.Si no se proporciona un ID de pedido:
   • Redacta una respuesta que solicite el ID del pedido.El mensaje debe incluir:
     • Un reconocimiento amable de la solicitud de reembolso.
     • Una explicación de que se necesita el ID del pedido para proceder con el reembolso.
     • Una solicitud para que respondan con su ID de pedido.
     • Una disculpa por cualquier inconveniente causado.
   • Incluye este mensaje dentro de etiquetas <request_order_id> en tu respuesta.
6. Formato de respuesta final:
   1. Formatea la respuesta final de la siguiente manera:

      <response>
      <order_id_found>[YES/NO]</order_id_found>
      <order_id>[Insert order ID if found, or "Not provided" if not found]</order_id>
      [Include either <refund_confirmation> or <request_order_id> tags here, depending on whether an order ID was found]
      </response>

   2. Usa un tono cortés y profesional en toda la respuesta.

Solicitudes del usuario

Las solicitudes de usuario te permiten estructurar cómo se pasan las entradas y los argumentos al agente.También puedes mostrar en la solicitud del usuario cómo se hace referencia a ciertas entradas en la solicitud del sistema.

Utiliza la sintaxis {{exampleInput}} para sustituir el argumento de entrada con nombre exampleInput en la solicitud del usuario en runtime.

Este es un ejemplo de una solicitud de usuario utilizando la sintaxis correcta:

You will take as input the following arguments:
{{Email_To}}, {{Customer_Email}}, {{Reply_Email_ID}}

Donde:

• EMAIL_TO es el correo electrónico del cliente al que el mensaje debe responder para confirmar o denegar el reembolso.
• CUSTOMER_EMAIL es el contenido real del correo electrónico del cliente.
• REPLY_EMAIL_ID es el ID que el agente debe incluir en la respuesta al cliente.

Utiliza la sintaxis {{}} para asegurarte de que los argumentos de entrada se pasan correctamente.