Crear herramientas de agente efectivas

Los agentes utilizan herramientas de la siguiente manera:

1. Selección de herramientas: el agente selecciona una herramienta en función del nombre, la descripción y el contexto proporcionado en la solicitud del sistema.

2. Ejecución de la herramienta: el agente proporciona argumentos de entrada, utilizando el esquema de entrada definido de la herramienta y cualquier uso de ejemplo en la solicitud para inferir el formato y los valores.

3. Interpretación de la salida: después de la ejecución, el agente interpreta la salida utilizando el contexto y los ejemplos de la solicitud.

Si no se proporciona suficiente contexto, los agentes pueden inferir incorrectamente cómo proporcionar argumentos o interpretar los resultados de una herramienta. Puedes mejorar la fiabilidad aplicando varias estrategias de diseño en la configuración de herramientas, ejemplos de uso y barreras.

Convertir automatizaciones existentes para utilizarlas como herramientas

Puedes utilizar flujos de trabajo existentes como herramientas publicándolos como procesos o importándolos a tu solución de Studio Web. Revisa los argumentos de entrada y salida para asegurarte de que utilizan tipos admitidos. Los tipos de argumentos no admitidos pueden evitar que el agente llame al proceso.

Escribir descripciones de herramientas efectivas

Incluir los siguientes detalles en las descripciones de las herramientas puede ayudar tanto al agente como a otros desarrolladores a utilizar la herramienta de forma efectiva en los procesos agénticos:

1. ¿Qué hace la herramienta?

2. ¿Qué efectos secundarios tiene la herramienta?

3. ¿La herramienta modifica su entorno?

4. ¿Podría la herramienta realizar actualizaciones destructivas en un sistema de registro?

5. ¿Llamar a la herramienta repetidamente tiene algún efecto adicional?

6. ¿Llamar a la herramienta permite que el agente interactúe con otros agentes, usuarios o sistemas de forma no estructurada? Esto podría introducir un riesgo adicional y puede necesitar un aumento correspondiente de la supervisión.

Las descripciones deben seguir siendo concisas a la vez que informativas, redactadas en un lenguaje sencillo que admita el razonamiento del agente.

Proporcionar uso de ejemplo en una solicitud del sistema

Incluir un ejemplo en la solicitud del sistema que demuestre cómo utilizar la herramienta e interpretar su salida puede mejorar significativamente la precisión de la herramienta.

Por ejemplo, un agente quiere utilizar un flujo de trabajo de RPA para marcar el estado de una factura en un sistema interno. En la solicitud del sistema del agente, puedes dar el siguiente uso de ejemplo:

Example Usage of ValidateInvoiceStatus Tool

Input:
{
  "InvoiceNumber": "INV-2024-1837" // the unique invoice identifier
}

Output:
{
  "IsValid": true, // boolean indicating if the invoice exists
  "PaymentStatus": "Paid", // payment status of the invoice
  "DueDate": "2025-06-30" // when payment is due (if unpaid)
}

Interpreting the Results:
Result Condition	Agent Interpretation
IsValid = true, PaymentStatus = Paid	"Invoice INV-2024-1837 is valid and has already been paid."
IsValid = true, PaymentStatus = Unpaid	"Invoice INV-2024-1837 is valid but unpaid. It is due by June 30, 2025."
IsValid = false	"There's not a valid invoice with number INV-2024-1837 in the system."

Uso de barreras de protección para supervisión adicional

Las medidas de seguridad de la herramienta te permiten aplicar políticas en la entrada proporcionada y la salida recibida de las herramientas del agente, lo que permite que un humano revise el uso de la herramienta, bloqueándola por completo y más. Más información sobre las medidas de seguridad de las herramientas.

Uso de conectores en flujos de trabajo

Puedes añadir muchas actividades del conector de Integration Service directamente como herramienta para tu agente. Para utilizar conectores y actividades que aún no son compatibles directamente:

1. Crea un nuevo flujo de trabajo en Studio Web.

2. Añade la actividad del conector.

3. Define los argumentos de entrada y salida coincidentes.

4. Publica el flujo de trabajo como un proceso.

5. Añade el proceso como una herramienta y describe su uso en la solicitud.

Este método te permite exponer cualquier conector o llamada a la API al agente de una manera estructurada y fiable.