Conectar ferramentas do agente de IA a serviços externos

Saiba como conectar ferramentas de agente de IA a aplicativos externos , como Slack, Google Calendar ou qualquer serviço com uma API usando solicitações HTTP. Os agentes podem usar ferramentas conectadas externamente para automatizar tarefas, enviar mensagens e recuperar dados de plataformas de terceiros.

Requirements

• Crie uma conexão HTTP do Catálogo do Unity para seu aplicativo externo. As conexões do Catálogo do Unity fornecem gerenciamento de credenciais seguro e controlado e dão suporte a vários métodos de autenticação padrão, incluindo autenticação OAuth 2.0 de usuário para computador e de máquina para máquina.

Usar ferramentas de servidores MCP externos

Se o serviço externo ao qual você deseja se conectar tiver um servidor MCP disponível, a maneira mais fácil de conectar seu agente é por meio de servidores MCP externos. Essa abordagem fornece:

• Descoberta automática de ferramentas: o servidor MCP expõe todas as ferramentas disponíveis usando APIs padrão.
• Integração simplificada: conecte e execute ferramentas usando SDKs padrão.
• Manutenção reduzida: as definições de ferramenta são gerenciadas centralmente pelo servidor MCP externo.

Consulte Usar servidores MCP externos para obter instruções detalhadas.

Criar uma ferramenta no código do agente

Para enviar solicitações HTTP para serviços externos com Python, use a função http_request da databricks-sdk biblioteca. Essa função envia uma solicitação HTTP para um serviço externo usando uma conexão do Catálogo do Unity para autenticar.

Permissões necessárias:USE CONNECTION no objeto de conexão.

O exemplo a seguir faz uma solicitação HTTP externa de dentro do código do 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: o objeto de conexão que especifica as credenciais de host, porta, base_path e acesso.
• method: o método de solicitação HTTP usado para fazer a chamada. Por exemplo: GET, POST, PUT e DELETE
• path: o caminho a ser concatenado após o base_path para invocar o recurso de serviço.
• json: o corpo JSON a ser enviado com a solicitação.
• headers: um mapa para especificar os cabeçalhos de solicitação.

Criar uma ferramenta de função do Catálogo do Unity

Depois de criar a conexão HTTP e testar se ela funciona corretamente, crie uma função do Catálogo do Unity que use a conexão. O seguinte exemplo cria uma ferramenta de função do Catálogo do Unity que um agente pode usar para postar uma mensagem no 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 e Python).

Exemplos de notebooks

Conectar um agente ao Slack

Consulte Conectar um agente de IA ao Slack.

Conectar um agente ao Microsoft Teams

Consulte Conectar um agente de IA ao Microsoft Teams.

Ferramentas de conexão externas

Os notebooks a seguir demonstram como criar ferramentas de agente de IA que se conectam ao Slack, ao OpenAI e à Pesquisa de IA do Azure.

Ferramenta do agente de mensagens do Slack

Obter laptop

Ferramenta de agente de API do Microsoft Graph

Obter laptop

Ferramenta do Assistente de Busca do Azure AI

Obter laptop

Limitações

• Não há suporte para conectividade privada com recursos em seu VPC usando o Link Privado para conexões MCP externas. Se os agentes de IA precisarem se conectar aos recursos em seu VPC, entre em contato com sua equipe de suporte.