Conecte ferramentas de agente de IA a serviços externos

Saiba como conectar ferramentas de agente de IA a aplicativos externos como Slack, Google Agenda 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 Unity Catalog para seu aplicativo externo. As conexões do Catálogo Unity fornecem gerenciamento de credenciais seguro e controlado e suportam vários métodos de autenticação padrão, incluindo autenticação OAuth 2.0 de usuário para máquina 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. Esta abordagem prevê:

• 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 ferramentas 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. Esta função envia uma solicitação HTTP para um serviço externo usando uma conexão Unity Catalog 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, DELETE
• path: O caminho a concatenar após o base_path para invocar o recurso do serviço.
• json: O corpo JSON a ser enviado com a requisição.
• headers: Um mapa para especificar os cabeçalhos de solicitação.

Criação de uma ferramenta para funções do Unity Catalog

Depois de criar a conexão HTTP e testar se ela funciona corretamente, crie uma função Unity Catalog que use a conexão. O exemplo a seguir cria uma ferramenta de função Unity Catalog 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 cadernos

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 externa

Os blocos de anotações a seguir demonstram a criação de ferramentas de agentes de IA que se conectam ao Slack, OpenAI e à pesquisa de IA da Azure.

Ferramenta de agente de mensagens do Slack

Obter caderno

Ferramenta de agente da API do Microsoft Graph

Obter caderno

Ferramenta de agente de pesquisa do Azure AI

Obter caderno

Limitações

• A conectividade privada com recursos em sua VPC usando Private Link não é suportada para conexões MCP externas. Se seus agentes de IA precisarem se conectar a recursos em sua VPC, entre em contato com sua equipe de suporte.