Solicitudes

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.

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.

In the Prompt editor, the @ trigger inserts tools, contexts, escalations, and input arguments as inline pill references. Pills stay in sync automatically when a tool or argument is renamed. See Prompt editor for details.

Ejemplo de solicitud del sistema

Aquí tienes un ejemplo de solicitud bien estructurada:

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

1. Leer el correo electrónico del cliente. a. Comienza por leer atentamente el correo electrónico del cliente que solicita un reembolso.

2. Identifica el ID de orden: a. Busca un ID de orden en el correo electrónico. Los ID de orden suelen ser cadenas alfanuméricas, a menudo comienzan con "ORD" o "#" seguidas de números. b.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: a. Si se encuentra un ID de pedido, utiliza la herramienta "Buscar detalles del pedido" para determinar la cantidad para la que se solicita 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 verifica en la orden que la cantidad que se reembolsa es correcta. b. Reembolsos aprobados: si el importe del reembolso es inferior a 100 €, el reembolso se aprueba automáticamente y se considera correcto. c.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.Esto debe incluye: a. Un saludo educado. b.Una confirmación de que se ha procesado el reembolso para el ID de orden específico. c.El periodo estimado para que el reembolso aparezca en su cuenta (normalmente, 3-5 días hábiles). d.Les agradecemos su paciencia. e. El importe reembolsado. f. Incluye este mensaje dentro de etiquetas en tu respuesta. g. 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: a. 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>
   

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

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.

To incorporate dynamic input, insert input arguments as references directly in the prompt. In the prompt editor, type @ and select an argument from the picker — refer to Prompt editor for the full editing experience.

Input arguments are stored in the prompt as {{exampleInput}}. The prompt editor displays them as color-coded pills and converts existing {{ }} placeholders automatically when a prompt is opened.

Ejemplo de solicitud de usuario

The following example shows how three input arguments appear in a user prompt. Arguments are inserted via the @ picker and stored as {{argumentName}} in the underlying prompt format:

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.

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

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...")
• Qué no hacer:
  • Ejemplos: no proporciones entradas de muestra ni salidas esperadas, ya que esto ya se ha cubierto en los argumentos de entrada y salida.

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.

Argumentos

Arguments pass runtime information into and out of an agent, just as inputs and outputs do for activities or processes. A trigger in Orchestrator can supply argument values at runtime, and an agent's output arguments can drive downstream business processes.

The agent sees only arguments that are explicitly referenced in the user prompt. For instructions on creating arguments and referencing them in prompts, see Defining arguments.