Connecter des outils d’agent IA à des services externes

Découvrez comment connecter des outils d’agent IA à des applications externes telles que Slack, Google Calendar ou n’importe quel service avec une API à l’aide de requêtes HTTP. Les agents peuvent utiliser des outils connectés en externe pour automatiser les tâches, envoyer des messages et récupérer des données à partir de plateformes tierces.

Requirements

• Créez une connexion HTTP de catalogue Unity pour votre application externe. Les connexions de catalogue Unity fournissent une gestion des informations d’identification sécurisée, régie et prennent en charge plusieurs méthodes d’authentification standard, notamment l’authentification utilisateur à machine OAuth 2.0 et l’authentification machine à machine.

Utiliser des outils à partir de serveurs MCP externes

Si le service externe auquel vous souhaitez vous connecter dispose d’un serveur MCP disponible, le moyen le plus simple de connecter votre agent consiste à utiliser des serveurs MCP externes. Cette approche fournit les éléments suivants :

• Détection automatique des outils : le serveur MCP expose tous les outils disponibles à l’aide d’API standard.
• Intégration simplifiée : Connectez et exécutez des outils à l’aide de kits SDK standard.
• Maintenance réduite : les définitions d’outils sont gérées de manière centralisée par le serveur MCP externe.

Pour obtenir des instructions détaillées, consultez Utiliser des serveurs MCP externes .

Créer un outil dans le code de l’agent

Pour envoyer des requêtes HTTP à des services externes avec Python, utilisez la fonction http_request à partir de la databricks-sdk bibliothèque. Cette fonction envoie une requête HTTP à un service externe à l’aide d’une connexion de catalogue Unity pour l’authentification.

Autorisations requises :USE CONNECTION sur l’objet de connexion.

L’exemple suivant effectue une requête HTTP externe à partir du code de l’agent.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.serving import ExternalFunctionRequestHttpMethod

WorkspaceClient().serving_endpoints.http_request(
  conn="connection_name",
  method=ExternalFunctionRequestHttpMethod.POST,
  path="/api/v1/resource",
  json={"key": "value"},
  headers={"extra_header_key": "extra_header_value"},
)

• conn: objet de connexion qui spécifie l’hôte, le port, le base_path et les informations d’identification d’accès.
• method: méthode de requête HTTP utilisée pour effectuer l’appel. Par exemple : GET, POST, PUT, DELETE
• path : chemin d’accès à concaténer après base_path pour appeler la ressource du service.
• json: corps JSON à envoyer avec la requête.
• headers : mappage qui spécifie les en-têtes de requête.

Créer un outil de fonction d’Unity Catalog

Après avoir créé la connexion HTTP et testé qu’elle fonctionne correctement, créez une fonction de catalogue Unity qui utilise la connexion. L’exemple suivant crée un outil de fonction Catalogue Unity qu’un agent peut utiliser pour publier un message sur Slack :

CREATE OR REPLACE FUNCTION main.default.slack_post_message(
  text STRING COMMENT 'message content'
)
RETURNS STRING
COMMENT 'Sends a Slack message by passing in the message and returns the response received from the external service.'
RETURN (http_request(
  conn => 'test_sql_slack',
  method => 'POST',
  path => '/api/chat.postMessage',
  json => to_json(named_struct(
    'channel', "C032G2DAH3",
    'text', text
  ))
)).text

Consultez CREATE FUNCTION (SQL et Python).

Exemples de notebooks

Connecter un agent à Slack

Consultez Connecter un agent IA à Slack.

Connecter un agent à Microsoft Teams

Consultez Connecter un agent IA à Microsoft Teams.

Outils de connexion externe

Les notebooks suivants montrent comment créer des outils d’assistant IA qui se connectent à Slack, OpenAI et à Recherche Azure AI.

Outil d’agent de messagerie Slack

Obtenir un ordinateur portable

Outil de l’agent d’API Microsoft Graph

Obtenir un ordinateur portable

Outil de l’agent Recherche Azure AI

Obtenir un ordinateur portable

Limites

• La connectivité privée aux ressources de votre VPC à l’aide de Private Link n’est pas prise en charge pour les connexions MCP externes. Si vos agents IA doivent se connecter aux ressources de votre VPC, contactez votre équipe de support technique.