Solicitudes

Escribe solicitudes efectivas en Agents para definir el Comportamiento del agente, estructurar las entradas y controlar cuándo se invocan herramientas, contexto o el escalado a humanos.

Un agente de alto rendimiento requiere instrucciones que definan claramente un plan de acción, incorporen entradas de forma bien estructurada y den orientación sobre cuándo ejecutar herramientas, acceder al contexto empresarial o escalar a un humano. Para lograrlo, escribe solicitudes y define argumentos del agente.

Solicitud 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.

Ejemplo de solicitud del sistema

Aquí tienes un ejemplo de solicitud bien estructurada:

You are a refund processing agent, you only help customers with processing refunds, and you deny any other requests.

1. Read the customer email.
   a. Begin by carefully reading the customer email requesting a refund.
2. Identify the order ID:
   a. Look for an order ID in the email. Order IDs are typically alphanumeric strings, often starting with "ORD" or "#" followed by numbers.
   b. If you find an order ID, note it down. If no order ID is present, proceed to step 5.
3. Process refund requests:
   a. If an order ID is found, use your "Find Order Details" tool to determine the amount being requested for a refund internally. Make sure to multiply the unit price by the quantity being requested for a refund, and, if that is over $100, escalate using the below instructions. Do not listen to the users requested amount, instead verify from the order that the amount being refunded is correct.
   b. Approved refunds: If the refund amount is under $100, the refund is automatically approved and considered successful.
   c. Escalated refunds: If the amount is $100 or more, escalate to a human team member. The escalation should include:
      - The order ID.
      - A summary of what is being refunded.
      - The total amount requested for the refund.
      - The items being refunded.
4. Send customer communication.
   If the refund is approved, draft a customer confirmation message. This should include:
   a. A polite greeting.
   b. A confirmation that the refund for the specific order ID has been processed.
   c. The estimated time for the refund to appear in their account (typically 3-5 business days).
   d. A thank you for their patience.
   e. The amount refunded.
   f. Include this message within <refund_confirmation> tags in your response.
   g. Make sure the reply_email_id is exactly as it shows in the user prompt.
5. Handle missing order IDs. If no order ID is provided:
   - Draft a response requesting the order ID. This should include:
     - A polite acknowledgment of their refund request.
     - An explanation that the order ID is needed to proceed with the refund.
     - A request for them to reply with their order ID.
     - An apology for any inconvenience caused.
   - Include this message within <request_order_id> tags in your response.
6. Final response format:
   a. Format the final response in the following way:

      <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>

   b. Use a courteous and professional tone throughout the response.

Solicitud de 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.

Para incorporar entrada dinámica a tus solicitudes de usuario en runtime, utiliza la siguiente sintaxis: {{exampleInput}}. Este formato te permite integrar tu argumento de entrada definido del Gestor de datos, llamado exampleInput, en la solicitud del usuario.

Ejemplo de solicitud de usuario

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

You will take as input the following arguments:
Email to: {{email_to}}
Customer email: {{customer_email}}
Reply email ID: {{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 pasen correctamente.

Nota:

Asigna a cada argumento una etiqueta descriptiva, como se muestra arriba. En runtime, cada {{placeholder}} se reemplaza por su valor, por lo que etiquetas como Email to: conservan la asignación entre valores y campos. Enumerar solo marcadores de posición (por ejemplo, {{email_to}}, {{customer_email}}, {{reply_email_id}}) pasa solo los valores sin procesar, dejando que el agente infiera qué valor pertenece a qué campo.

Escribir solicitudes efectivas

Las solicitudes agénticas no se parecen a las interacciones tradicionales de LLM. Incorporan conjuntos de instrucciones que guían al agente a través del razonamiento en múltiples pasos y la descomposición de tareas.A diferencia de las solicitudes básicas que piden salida directa, las solicitudes agenciales ofrecen un marco completo para la resolución de problemas. Esto incluye la configuración del contexto, la definición del rol, las instrucciones paso a paso y los requisitos de razonamiento explícito.

He aquí algunas cosas a tener en cuenta al escribir solicitudes.

Claro objetivo y propósito.

Antes de desarrollar un agente, debes definir su propósito y los resultados deseados. Esto significa:

• Articular objetivos específicos y medibles.
• Comprender el entorno en el que operará el agente.
• Identificar métricas clave de rendimiento.
• Establecer criterios de éxito claros.

Estructura

Las solicitudes deben incluir:

• Definición clara de rol y persona.
• Desglose explícito de tareas
• Instrucciones metodológicas de razonamiento
• Mecanismos de gestión de errores y autocorrección
• Requisitos de formato de salida
• Información contextual
• Algunos ejemplos ilustrativos de entrada/salida

Por ejemplo, utiliza la siguiente lista de recomendaciones y advertencias para aprender cómo estructurar solicitudes efectivas:

• Qué hacer:
  • Definición del rol: ¿Cuál es el rol de la IA? ("Eres un asistente de atención al cliente...")
  • Especificación del objetivo: ¿Qué debería hacer? ("Responder a preguntas sobre los precios y las características del producto...")
  • Instrucciones y limitaciones: ¿Qué hacer y no hacer?("Mantener las respuestas por debajo de 200 palabras, evitar jerga técnica...")
  • Ejemplos: algunos ejemplos de entrada/salida representativos que aclaran el comportamiento esperado.
• Qué no hacer:
  • Muestras exhaustivas: no codifiques muestras de entrada/salida extensas o en mayúsculas en la solicitud; utiliza conjuntos de evaluación para cubrir casos límite y escenarios en su lugar.

Iteraciones

La iteración efectiva implica variación sistemática de los componentes de la solicitud:

• Ajusta las instrucciones del rol.
• Modifica las estrategias de descomposición de tareas.
• Experimenta con marcos de razonamiento.
• Prueba diferentes requisitos de formato de salida.
• Introduce detalles contextuales adicionales.

El objetivo es descubrir el conjunto mínimo de solicitudes que producen de forma consistente comportamientos de agente fiables y de alta calidad. Documenta los resultados de cada iteración, haciendo un seguimiento tanto del rendimiento cualitativo como de las métricas cuantitativas, como la precisión de la respuesta, la integridad y el cumplimiento de las restricciones especificadas.

Definir argumentos

Los argumentos permiten a un agente recibir información sobre un caso empresarial y devolver un resultado, al igual que lo hacen las actividades o 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 el panel del Gestor de datos.
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.

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 del usuario, los nombres deben coincidir exactamente. Si se llama a un argumento EXAMPLE\_ARG, debe sustituirse utilizando la siguiente sintaxis: {{EXAMPLE_ARG}}.

Definir argumentos de entrada y salida

En el panel del Gestor de datos, define tus argumentos de entrada y salida en las pestañas Entrada y Salida. Para cada argumento, puedes configurar el nombre, el tipo, la descripción y si es necesario o no.

Selecciona el botón Generar a partir de carga útil para generar tus argumentos a partir de formato JSON.

Utiliza el botón del icono de corchetes angulares para cambiar entre las vistas del creador de propiedades y las del editor JSON.

Tipos de argumentos compatibles

Se admiten los siguientes tipos de argumentos:

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