Connecter des outils d’agent IA à des services externes

Essentiel

Cette fonctionnalité est en préversion publique.

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.

Exigences

• Créez une connexion HTTP au catalogue Unity. Consultez Se connecter aux services HTTP externes.

Créer un outil de fonction 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).

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 bibliothèque databricks-sdk. 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 pour spécifier les en-têtes de requête.

Exemples de notebooks

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 le notebook

Outil de l’agent d’API Microsoft Graph

Obtenir le notebook

Outil d’assistant Recherche Azure AI

Obtenir le notebook