Outils

Ces outils permettent aux agents d'accéder au contexte critique provenant des données stockées dans les applications métier et d'exécuter des actions en fonction des objectifs définis dans la requête. Les outils permettent à l'agent de transformer son raisonnement et sa planification en action.

Si vous ne donnez pas à un agent un accès explicite à un outil, il ne peut pas exécuter de fonctions (en dehors de l'ancrage dans le contexte et des escalades qui sont des composants distincts d'un agent). Lorsque vous ajoutez un outil à votre agent, fournissez une description précise de son objectif et de ses fonctionnalités, ainsi qu'une explication indiquant quand l'utiliser dans la requête système ou utilisateur. Cela garantit que l'agent comprend les fonctionnalités de l'outil et peut l'utiliser efficacement dans les scénarios appropriés.

Activités (Activities)

Les agents utilisent des activités basées sur le service d'intégration Integration Service à partir de connecteurs tels que Box, Coupa, Microsoft Teams, Salesforce, Slack et Zoom. Les connexions sécurisées et régies par le service d'intégration, et les configurations de champs décrites dans les sections suivantes permettent à un agent d'effectuer des appels d'API directement vers une application métier cible. Notez que les activités du service d'intégration ne sont pas toutes disponibles dans Agents.

Configurer des activités pour les utiliser comme outils

1. Dans l'onglet Conception, sous la section Outils, sélectionnez Ajouter un outil.
2. Recherchez des activités à l'aide de la barre de recherche ou sélectionnez un connecteur dans la liste pour voir quelles activités sont disponibles.
3. Une fois que vous avez ajouté une activité en tant qu'outil, vous pouvez :
   1. Mettez à jour sa description.
   2. Sélectionnez une connexion Integration Service préexistante ou créez-en une nouvelle.
   3. Configurez les options d'entrée des champs pour aider votre agent à apprendre à utiliser l'activité.

      Les connexions d'Integration Service peuvent être ajoutées et gérées comme dans Studio. Ces connexions sécurisées et gérables sont surveillées par Integration Service, qui avise les utilisateurs de toute rupture ou invalidation.

Chaque activité s'accompagne d'une description par défaut, que vous pouvez personnaliser pour mieux guider votre agent pendant l'exécution. Bien que cette étape soit facultative, elle améliore la qualité de la sortie et aide l'agent à comprendre comment utiliser l'outil dans des cas d'utilisation spécifiques.

Les agents connaissent intrinsèquement les informations nécessaires pour exécuter une activité correctement, ce qui élimine la nécessité de spécifier explicitement les entrées ou les sorties. Par défaut, les agents déduisent les valeurs des champs nécessaires. Toutefois, vous pouvez remplacer la méthode d'entrée par Static Value (Valeur statique) ou Argument pour utiliser des données spécifiques ou pour extraire des données des arguments d'entrée de l'agent.

Définir les méthodes d'entrée des activités

Pour les champs d'activité, vous pouvez choisir une des méthodes d'entrée suivantes :

• Agent (par défaut) : lorsque vous sélectionnez cette option, l'agent déduit la valeur du champ au moment de l'exécution en utilisant le champ Description et d'autres raisonnements pertinents pour déterminer l'utilisation de l'outil.
• Argument : lorsque vous sélectionnez cette option, vous définissez le champ comme un argument d'entrée d'agent. Vous devez d'abord définir l'argument. Utilisez des arguments pour transmettre des valeurs d'exécution provenant d'un workflow qui précède l'activité Run Job (Exécuter la tâche).
• Valeur statique : lorsque vous sélectionnez cette option, vous définissez le champ sur une valeur statique spécifique chaque fois que l'agent est exécuté.

Certains champs peuvent nécessiter des valeurs statiques, en fonction de l'activité. Par exemple, un utilisateur de Slack spécifique que vous souhaitez définir dans le champ Send as (Envoyer en tant que). Les autres champs sont déduits par défaut par l'agent.

Récupérer le contexte depuis le web

Web Search et Web Reader sont deux outils développés en interne que vous pouvez ajouter à vos agents pour leur fournir un contexte actualisé provenant du Web ou du domaine public. Vous pouvez utiliser ces activités pour répondre à des questions concernant des données en temps réel, telles que le cours des actions, l'heure, les prévisions météorologiques ou les données disponibles sur une URL spécifique à un moment donné.

L'outil Web Search effectue une recherche sur le Web en utilisant le langage naturel. Comme dans les autres outils, le champ Recherche peut être déduit des instructions de la requête système et utilisateur. Par exemple, vous pouvez demander à votre agent d'obtenir des informations sur les tendances du secteur et les activités des concurrents qui seraient utilisées pour élaborer un bilan prévisionnel. L'instruction fournie dans votre requête et l'ajout de l'outil Web Search indiquent à l'agent qu'il doit utiliser cet outil pour accéder à ce contexte critique et actualisé.

Web Search dresse un résumé complet et le fournit à l'agent en fonction des résultats les plus pertinents. La sortie inclut les URL d'où proviennent les informations.

L'outil Web Reader vous permet d'extraire du texte d'une URL spécifique et de l'ajouter comme contexte pour votre agent. Par exemple, vous avez un fournisseur de pièces spécifique et vous voulez accéder à sa page Web et extraire le prix actuel de certaines pièces. En fournissant l'URL directement ou par le biais de la requête, vous vous assurez que seules les informations provenant de cette URL individuelle sont utilisées pour mettre en surface le prix des pièces spécifiques indiqué par le fournisseur (ou toute autre information contenue dans cette URL).

En combinant Web Search et Web Reader, vous donnez à votre agent la possibilité d'effectuer des recherches dans le domaine public, puis d'utiliser les sources et les URL citées pour extraire des détails spécifiques.

Processus (Processes)

Un agent peut exécuter certains processus publiés dans votre espace locataire. Cela se fait en fonction de chaque processus.

1. Dans l'onglet Conception, sous la section Outils, sélectionnez Ajouter un outil.
2. Sélectionnez l'onglet Processus et recherchez des processus à l'aide de la barre de recherche ou sélectionnez-en un dans la liste disponible.

   Pour accéder à un processus en tant qu'outil, vous devez d'abord le publier et le déployer dans un dossier Orchestrator partagé auquel vous avez accès. Le processus doit également être conforme aux types d'entrée et de sortie pris en charge.

Une fois que vous avez ajouté un processus en tant qu'outil, utilisez la requête système pour décrire sa fonction et quand il doit être utilisé. Vous pouvez fournir la description de chaque argument afin d'aider l'agent à l'utiliser efficacement.

Les processus prennent en charge les types d'arguments d'entrée et de sortie suivants. Il est possible que les processus soient inaccessibles ou échouent si ces limites ne sont pas respectées.

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

Agents

Un agent peut exécuter d'autres agents publiés dans votre locataire.

1. Dans le panneau Definition (Définition), sous la section Tools (Outils), sélectionnez Add tool (Ajouter un outil).
2. Sélectionnez l'onglet Agents et recherchez des agents à l'aide de la barre de recherche ou sélectionnez-en un dans la liste disponible.

   Pour accéder à un agent en tant qu'outil, vous devez tout d'abord le publier et le déployer en tant que processus dans un dossier Orchestrator partagé.

3. Une fois que vous avez ajouté un agent en tant qu'outil, utilisez la requête système pour décrire sa fonction et quand il doit être utilisé.