Funciones

Funciones codificadas como herramientas de agente, lo que permite a un agente ejecutar código Python personalizado como una herramienta determinista basada en procesos junto con automatizaciones y flujos de trabajo de API.

La herramienta de función codificada permite a un agente ejecutar código Python personalizado como herramienta. Una función encapsula la lógica determinista (transformaciones de datos, cálculos o llamadas a sistemas externos) que el agente invoca cuando su razonamiento lo requiere y luego razona sobre el resultado devuelto.

Una función codificada se comporta como las otras herramientas basadas en procesos disponibles para un agente, como los flujos de trabajo de API, las automatizaciones o las herramientas de agente. El agente pasa los argumentos de entrada a la función, la función ejecuta su código Python y el agente recibe la salida estructurada.

Las funciones se crean en Studio Web. Para obtener más información sobre las funciones de escritura, empaquetado y publicación, consulta la Guía del usuario de funciones.

Cómo utilizan los agentes las funciones

Una vez que una función está disponible en tu solución, aparece como una herramienta seleccionable dentro de la sección Herramientas de una definición de agente en Studio Web. Cada herramienta lleva una descripción que ayuda al agente a comprender su propósito y cuándo utilizarla.

En runtime, el agente pasa parámetros de entrada a la función, la función ejecuta su lógica de Python y el resultado vuelve al agente como salida estructurada para el siguiente paso de su plan. Debido a que la lógica es código determinista, una función devuelve la misma salida para la misma entrada, lo que la hace adecuada para operaciones precisas que el modelo de lenguaje no debe realizar solo mediante el razonamiento.

Al igual que otros tipos de herramientas, las funciones codificadas admiten los controles de gobernanza de la plataforma. Puedes configurar barreras de seguridad para controlar cuándo y cómo se invoca una función, y simulaciones de herramientas para probar el razonamiento del agente sin ejecutar el código real.

Añadir una función como herramienta

Puedes añadir una función existente a partir de tus recursos disponibles o crear una nueva sin salir del agente.

1. En el panel Definición, en la sección Herramientas, selecciona Añadir herramienta.
2. Selecciona Función.
3. Añade la función:
   • Para utilizar una función existente, búscala o selecciónala de los recursos disponibles.
   • Para crear una nueva función, selecciona Crear nueva. El asistente de creación de funciones se abre dentro de la solución.
4. Utiliza la solicitud del sistema para describir el propósito de la función y cuándo debe utilizarla el agente. Para cualquier argumento, proporciona una descripción para ayudar al agente a utilizarlos de forma efectiva.

Ejecución de la función de supervisión

Cuando un agente ejecuta una herramienta de función codificada, puedes inspeccionar la ejecución en dos lugares:

• Seguimiento de agente : después de una ejecución de depuración, el seguimiento de ejecución incluye una llamada de herramienta para la función, que muestra los argumentos de entrada que se le han pasado y la salida que devolvió.
• Orchestrator : la función se ejecuta como un proceso. En Supervisión > Trabajos en Orchestrator, la función aparece como un trabajo, junto con las otras ejecuciones de trabajo del agente.