Activités

Agents peuvent utiliser les activités Integration Service comme outils.

Grâce à des connexions Integration Service sécurisées et gouvernées et aux configurations de champs décrites dans les sections suivantes, un agent est capable d'effectuer des appels d'API directement vers une application métier cible.

Remarque :

Pour utiliser les activités Integration Service en tant qu'outils d'agent, vous devez d'abord installer des connecteurs et configurer des connexions dans Integration Service. Pour plus d'informations, reportez-vous à Connecteurs.

Configurer des activités pour les utiliser comme outils

1. Dans l'onglet Conception, sous la section Outils, sélectionnez Ajouter un outil.
2. Dans la Boîte à outils :
   • Recherchez une activité à l'aide de la barre de recherche, ou
   • Sélectionnez une Activité et parcourez par connecteur. La sélection d'un connecteur affiche la liste des activités prises en charge.
3. Une fois que vous avez ajouté une activité en tant qu'outil, vous pouvez :
   1. Modifiez le nom et la description de l'outil.
   2. Sélectionnez une connexion Integration Service préexistante ou créez-en une nouvelle.
   3. Configurez les champs d'entrée pour apprendre à votre agent à utiliser l'activité.

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.

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

Agents peuvent automatiquement déduire les informations nécessaires pour exécuter une activité avec succès. Vous n'avez donc généralement pas besoin de définir manuellement les valeurs d'entrée ou de sortie. Par défaut, les agents déterminent les valeurs des champs appropriées au moment de l'exécution en fonction de la description et du contexte de l'outil.

Cependant, vous pouvez remplacer ce comportement pour n'importe quel champ en sélectionnant une méthode d'entrée différente à l'aide du menu contextuel. Les méthodes d'entrée disponibles sont :

• Requête (par défaut) – L'agent infère la valeur du champ au moment de l'exécution à l'aide de la description de l'outil et d'autres informations pertinentes.
• Argument : Le champ est rempli à l'aide d'un argument d'entrée d'agent. Vous devez définir l'argument au préalable. Cette option est utile pour transmettre les données d'un workflow précédent à l'agent via l'activité Exécuter l'agent.
• Valeur statique – Le champ est défini sur une valeur fixe qui reste la même à chaque exécution de l'agent.

Remarque :

Les champs en cascade ne peuvent pas utiliser la méthode d’entrée par Prompt. Ce sont des champs où la sélection d’une valeur spécifique (par exemple, un type de Problème dans Jira) modifie la structure des champs restants dans l’activité. Étant donné que le schéma de l’outil ne peut pas s’ajuster dynamiquement lors du Runtime, les Agents ne peuvent pas déduire des valeurs pour ces champs.Les autres champs sont par défaut Prompt et peuvent être déduits par LLM pendant l'exécution. Cependant, vous devez vous assurer que l’agent a accès au contexte nécessaire (par exemple, via des outils antérieurs, la formulation d’une invite ou des arguments) pour déduire correctement ces valeurs.

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 les activités pour des questions concernant les données en temps réel telles que les prix des actions, l’heure, les prévisions météorologiques ou les données disponibles sur une URL spécifique à un moment donné.

Recherche Web

The Web Search tool executes a web search using natural language. Like other tools, the Search field can be inferred from instructions in the system and user prompt. For instance, you can tell your agent to get details on industry trends and competitor activities which would be used to construct a forecasting report.

By offering the instruction in your prompt and adding the Web Search tool, the agent knows it needs to use the tool to access this critical, up-to-date context.

La recherche Web exécute un résumé complet et le fournit à l’agent en fonction des principaux résultats.La sortie inclut les URL d'où proviennent les informations.

Lecteur Web

The Web Reader tool gives you the ability to extract text from a specific URL and add that as context for your agent. For instance, you have a specific parts supplier and you want to go to their web page and extract current prices for those parts.

By supplying the URL directly or through the prompt, you ensure that only information from that individual URL is used for surfacing the supplier's prices for specific parts (or any other information contained in that 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.

Limitations

Les activités Integration Service ne sont actuellement pas prises en charge en tant qu'outils d'agent lors de l'utilisation de modèles Gemini.