Comparteix via

Conexión de herramientas del agente de IA a servicios externos

Important

Esta característica está en versión preliminar pública.

Obtenga información sobre cómo conectar herramientas de agente de IA a aplicaciones externas como Slack, Google Calendar o cualquier servicio con una API mediante solicitudes HTTP. Los agentes pueden usar herramientas conectadas externamente para automatizar tareas, enviar mensajes y recuperar datos de plataformas de terceros.

Requirements

  • Cree una conexión HTTP del catálogo de Unity para la aplicación externa. Las conexiones del catálogo de Unity proporcionan administración de credenciales seguras, controladas y admiten varios métodos de autenticación estándar, como la autenticación de usuario a máquina y máquina a máquina de OAuth 2.0.

Uso de herramientas de servidores MCP externos

Si el servicio externo al que desea conectarse tiene disponible un servidor MCP, la manera más fácil de conectar el agente es a través de servidores MCP externos. Este enfoque proporciona:

  • Detección automática de herramientas: el servidor MCP expone todas las herramientas disponibles mediante las API estándar.
  • Integración simplificada: conecte y ejecute herramientas mediante SDK estándar.
  • Mantenimiento reducido: el servidor MCP externo administra centralmente las definiciones de herramientas.

Consulte Uso de servidores MCP externos para obtener instrucciones detalladas.

Creación de una herramienta en el código del agente

Para enviar solicitudes HTTP a servicios externos con Python, use la función http_request de la databricks-sdk biblioteca. Esta función envía una solicitud HTTP a un servicio externo mediante una conexión de catálogo de Unity para autenticarse.

Permisos necesarios:USE CONNECTION en el objeto de conexión.

En el ejemplo siguiente se realiza una solicitud HTTP externa desde el código del agente.

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: objeto de conexión que especifica el host, el puerto, el base_path y las credenciales de acceso.
  • method: el método de solicitud HTTP que se usa para realizar la llamada. Por ejemplo: GET, POST, PUT, DELETE
  • path: la ruta a concatenar después de base_path para invocar el recurso de servicio.
  • json: el cuerpo JSON que se va a enviar con la solicitud.
  • headers: un mapa para especificar los encabezados de solicitud.

Creación de una herramienta de función de catálogo de Unity

Note

El acceso a SQL con http_request está bloqueado para el tipo de conexión Usuario a máquina por usuario individual. Use el SDK de Python Databricks en su lugar.

Después de crear la conexión HTTP y probar que funciona correctamente, cree una función de catálogo de Unity que use la conexión. En el ejemplo siguiente se crea una herramienta de función de catálogo de Unity que un agente puede usar para publicar un mensaje en 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

Consulte CREATE FUNCTION (SQL y Python).

Cuadernos de ejemplo

Conexión de un agente a Slack

Consulte Conexión de un agente de IA a Slack.

Conexión de un agente a Microsoft Teams

Consulte Conexión de un agente de IA a Microsoft Teams.

Herramientas de conexión externas

En los cuadernos siguientes se muestra cómo crear herramientas de agente de IA que se conectan a Slack, OpenAI y Azure AI Search.

Herramienta de agente de mensajería de Slack

Obtener el cuaderno

Herramienta de API de Microsoft Graph para agentes

Obtener el cuaderno

Herramienta de agente de búsqueda de Azure AI

Obtener el cuaderno

Limitaciones

  • Last updated on