Actividades

Añade actividades de Integration Service como herramientas en Agents para realizar directamente llamadas gobernadas a las API de aplicaciones empresariales de destino a través de conexiones seguras.

Agents puede usar actividades de Integration Service como herramientas.

A través de conexiones seguras y gobernadas de Integration Service y las configuraciones de campo descritas en las siguientes secciones, un agente puede realizar llamadas a la API directamente a una aplicación empresarial de destino.

Nota:

Antes de usar las actividades de Integration Service como herramientas del agente, debes instalar conectores y configurar las conexiones en Integration Service. Para más información, consulta Conectores.

Configurar actividades para que actúen como herramientas

1. En la pestaña Diseño, en la sección Herramientas, selecciona Añadir herramienta.
2. En el cuadro de herramientas:
   • Buscar una actividad utilizando la barra de búsqueda, o
   • Selecciona Actividad y explora por conector. Al seleccionar un conector se revela la lista de actividades compatibles.
3. Una vez que añades una actividad como herramienta, puedes:
   1. Edita el nombre y la descripción de la herramienta.
   2. Seleccionar una conexión preexistente de Integration Service o crear una nueva.
   3. Configura los campos de entrada para enseñar a tu agente cómo utilizar la actividad.

Cada actividad viene con una descripción predeterminada, que puedes personalizar para guiar mejor a tu agente durante el runtime. Aunque es opcional, este paso mejora la calidad de salida y ayuda al agente a comprender cómo utilizar la herramienta para casos de uso específicos.

Definir métodos de entrada de actividades

Los agentes pueden inferir automáticamente la información necesaria para ejecutar una actividad correctamente, por lo que normalmente no es necesario definir valores de entrada o salida manualmente. De forma predeterminada, los agentes determinan los valores de campo adecuados en runtime en función de la descripción y el contexto de la herramienta.

Sin embargo, puedes anular este comportamiento para cualquier campo seleccionando un método de entrada diferente utilizando el menú de contexto. Los métodos de entrada disponibles son:

• Solicitud (predeterminado): el agente infiere el valor del campo en runtime utilizando la descripción de la herramienta y otra información relevante.
• Argumento: el campo se rellena utilizando un argumento de entrada de agente. Debes definir el argumento de antemano. Esta opción es útil para pasar datos de un flujo de trabajo anterior al agente a través de la actividad Ejecutar agente.
• Valor estático – el campo se establece como un valor fijo que permanece igual cada vez que se ejecuta el agente.

Nota:

Los campos en cascada no se pueden establecer como método de entrada de solicitud. Estos son campos en los que la selección de un valor específico (por ejemplo, un tipo de incidencia en Jira) cambia la estructura de los campos restantes en la actividad. Dado que el esquema de la herramienta no puede ajustarse dinámicamente en runtime, los agentes no pueden inferir valores para dichos campos. Otros campos adoptan el valor predeterminado de Solicitud y el LLM los puede inferir en runtime. Sin embargo, debes asegurarte de que el agente tenga acceso al contexto necesario (por ejemplo, mediante herramientas anteriores, solicitudes o argumentos) para inferir esos valores correctamente.

Limitaciones

• Las herramientas de actividad de Integration Service no son compatibles cuando se utilizan modelos de Gemini. Al seleccionar un modelo de Gemini, las herramientas de actividad del agente están deshabilitadas.
• The GenAI web activities (Web Search, Web Reader, and Web Summary) are not available in Automation Suite, so agents cannot use them as tools. For details, refer to GenAI Activities feature availability.