Herramientas

Las herramientas ofrecen a los agentes tanto acceso al contexto crítico a partir de los datos almacenados en aplicaciones empresariales como la capacidad de ejecutar acciones según los objetivos establecidos en la solicitud.Las herramientas son la forma en la que el razonamiento y la planificación del agente pueden convertirse en acción.

Sin proporcionar acceso explícito a un agente a una herramienta, el agente no puede ejecutar funciones (fuera de Contextualización y Escaladas, que son componentes independientes de un agente). Al añadir una herramienta para tu agente, proporciona una descripción específica de su propósito y capacidades, junto con una explicación de cuándo utilizarla en la solicitud del sistema/usuario. Esto garantiza que el agente comprenda la funcionalidad de la herramienta y pueda utilizarla de forma efectiva en los escenarios adecuados.

Actividades

Los agentes utilizan actividades basadas en Integration Service desde conectores como Box, Coupa, Microsoft Teams, Salesforce, Slack, y Zoom. Utilizando conexiones de Integration Service seguras y controladas 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. Ten en cuenta que no todas las actividades de Integration Service están disponibles en Agentes.

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. Busca actividades utilizando la barra de búsqueda o selecciona un conector de la lista para ver qué actividades están disponibles.
3. Una vez que añades una actividad como herramienta, puedes:
   1. Actualizar su descripción.
   2. Seleccionar una conexión preexistente de Integration Service o crear una nueva.
   3. Configura las opciones de entrada de campo para ayudar a tu agente a aprender a utilizar la actividad.

      Las conexiones de Integration Service se pueden añadir y gestionar como en Studio. Estas conexiones seguras y gobernables son supervisadas por Integration Service, que notifica a los usuarios cualquier interrupción o invalidación.

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.

Los agentes conocen de forma inherente la información necesaria para una ejecución correcta de la actividad, eliminando la necesidad de especificaciones explícitas de entrada o salida. De forma predeterminada, los agentes infieren los valores de campo necesarios. Sin embargo, puedes modificar el método de entrada a Valor estático o Argumento para utilizar datos específicos o recuperar datos de los argumentos de entrada del agente.

Definir métodos de entrada de actividades

Para los campos de actividad, puedes seleccionar uno de los siguientes métodos de entrada:

• Agente (predeterminado): al seleccionar esta opción, el agente infiere el valor del campo en runtime utilizando el campo Descripción y razonamientos adicionales del agente pertinentes para determinar el uso de la herramienta.
• Argumento: al seleccionar esta opción, estableces el campo como un argumento de entrada del agente. Primero debes definir el argumento. Utiliza argumentos para pasar valores de runtime de un flujo de trabajo que precede a la actividad Ejecutar trabajo.
• Valor estático: al seleccionar esta opción, configuras el campo con un valor estático específico cada vez que el agente se ejecuta.

Dependiendo de la actividad, ciertos campos pueden requerir valores estáticos. Por ejemplo, un usuario específico de Slack que desees establecer en el campo Enviar como. Otros campos serán los inferirá el agente de forma predeterminada.

Recuperar contexto de la web

La Búsqueda web y el Lector web son dos herramientas de primera parte que puedes añadir a tus agentes para proporcionar contexto actualizado desde la web o un dominio público.Puedes utilizar las actividades para preguntas sobre datos en tiempo real, como los precios de las acciones, la hora, las previsiones meteorológicas o los datos disponibles en una URL específica en un momento dado.

La herramienta de búsqueda web ejecuta una búsqueda en la web utilizando el lenguaje natural. Al igual que otras herramientas, el campo Buscar puede inferirse de las instrucciones contenidas en la solicitud del sistema y del usuario. Por ejemplo, puedes decirle a tu agente que obtenga detalles sobre las tendencias del sector y las actividades de la competencia que se utilizarían para realizar un informe de pronóstico. Al ofrecer las instrucciones en tu solicitud y añadir la herramienta de Búsqueda web, el agente sabe que necesita utilizar la herramienta para acceder a este contexto crítico y actualizado.

La búsqueda web ejecuta un resumen completo y se lo proporciona al agente basándose en los resultados principales. La salida incluye las URL de donde se origina la información.

La herramienta Lector Web te ofrece la posibilidad de extraer texto de una URL específica y añadirlo como contexto para tu agente. Por ejemplo, tienes un proveedor de piezas específico y quieres ir a su página web y extraer los precios actuales de esas piezas. Al proporcionar la URL directamente o a través de la solicitud, se garantiza que solo se utiliza la información de esa URL concreta para mostrar los precios del proveedor para partes específicas (o cualquier otra información contenida en esa URL).

Al combinar tanto la Búsqueda web como el Lector web, ofreces al agente la capacidad de ejecutar búsqueda en el dominio público y luego utilizar las fuentes y URL citadas para extraer detalles específicos.

Procesos

Un agente puede ejecutar procesos seleccionados publicados en tu tenant. Esto se realiza de forma individual para cada proceso.

1. En la pestaña Diseño, en la sección Herramientas, selecciona Añadir herramienta.
2. Selecciona la pestaña Proceso y busca procesos utilizando la barra de búsqueda o selecciona uno de la lista disponible.

   Para acceder a un proceso como herramienta, primero tienes que publicarlo e implementarlo en una carpeta compartida de Orchestrator a la que tengas acceso. El proceso también debe cumplir con los tipos de entrada y salida admitidos.

Una vez añadido un proceso como herramienta, utiliza el indicador del sistema para describir su función y cuándo debe utilizarse.Para cualquier argumento, puedes proporcionar una descripción para ayudar al agente a utilizarlo de forma efectiva.

Los siguientes tipos de argumentos de entrada y salida son compatibles con los procesos. Si no se respetan estas limitaciones, los procesos podrían ser inaccesibles o fallar.

"System.String" ​"System.Object" "System.Array" "System.Char"​ "System.Byte",​ "System.SByte",​ "System.UInt16",​ "System.Int16",​ "System.UInt32",​ "System.UInt64",​ "System.Int64"​ "System.Double",​ "System.Single",​ "System.Decimal",​ "System.Boolean"

Agentes

Un agente puede ejecutar otros agentes publicados en tu tenant.

1. En el panel Definición, en la sección Herramientas, selecciona Añadir herramienta.
2. Selecciona la pestaña Agentes y busca agentes utilizando la barra de búsqueda o selecciona uno de la lista disponible.

   Para acceder a un agente como herramienta, primero debes publicarlo e implementarlo como proceso en una carpeta compartida de Orchestrator.

3. Una vez que hayas añadido un agente como herramienta, utiliza la solicitud del sistema para describir su función y cuándo debe utilizarse.