Pular para o conteúdo principal

Conecte as ferramentas do agente AI ao serviço externo

info

Visualização

Esse recurso está em Public Preview.

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

Requisitos​

  • Crie uma conexão HTTP Unity Catalog para seu aplicativo externo. As conexões do Unity Catalog fornecem gerenciamento de credenciais seguro e controlado, além de suporte a múltiplos padrões. Métodos de autenticação, incluindo autenticação OAuth 2.0 de usuário para máquina e de máquina para máquina.

Utilizar 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 proporciona:

  • 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 das ferramentas são gerenciadas centralmente pelo servidor MCP externo.

Consulte a seção "Usar servidores MCP externos" para obter instruções detalhadas.

Crie uma ferramenta no código do agente​

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

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

O exemplo a seguir faz uma solicitação HTTP externa a partir do código interno do agente.

Python
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 o host, a porta, o base_path e as credenciais de acesso.
  • method: o método de solicitação HTTP usado para fazer a chamada. Por exemplo: GET, POST, PUT, 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 da solicitação.

Criar uma ferramenta de função do Unity Catalog​

nota

O acesso SQL com http_request está bloqueado para o tipo de conexão Usuário para máquina por usuário. Utilize o SDK Python Databricks em seu lugar.

Depois de criar a conexão HTTP e testar se ela funciona corretamente, crie uma função do Unity Catalog que use a conexão. O exemplo a seguir cria uma ferramenta de função do Unity Catalog que um agente pode usar para publicar uma mensagem no Slack:

SQL
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).

Exemplo de notebook​

Conectar um agente ao Slack​

Consulte Conectar um agente do AI ao Slack.

Ferramentas de conexão externa​

O seguinte Notebook demonstra a criação de ferramentas do agente AI que se conectam ao Slack, OpenAI e Azure AI search.

Ferramenta de agente de mensagens do Slack

Open notebook in new tab

Microsoft gráfico API ferramenta de agente

Open notebook in new tab

Ferramenta de agente do Azure AI Search

Open notebook in new tab

Limitações​

Última atualização em