Saltar para o conteúdo principal
Os conectores de dados fornecem aos Agentes de IA acesso a ferramentas de serviços externos. Configure uma conexão uma vez e, em seguida, adicione as ferramentas específicas de que um Agente precisa às suas Habilidades. Abra Agente de IA > Conectores de dados para visualizar e gerenciar suas conexões.
Página de conectores de dados mostrando as abas Integrações, MCP e API personalizada, além das integrações disponíveis.

Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.

Escolha um tipo de conector

A página de conectores de dados oferece três maneiras de conectar um serviço externo: Selecione a aba correspondente para pesquisar conexões existentes ou configurar uma nova.

Adicione ferramentas do conector a uma Habilidade do Agente de IA

Conectar um serviço não adiciona automaticamente todas as ferramentas disponíveis a todos os Agentes de IA. Escolha as ferramentas que cada Agente pode usar em suas Habilidades.
  1. Abra o Agente de IA que deseja configurar.
  2. Em Perfil, localize Habilidades e selecione Gerenciar.
  3. Crie uma Habilidade ou abra uma existente.
  4. Em Instruções passo a passo, digite /.
  5. Expanda o grupo relevante de Integração, MCP ou Conectores de dados e, em seguida, selecione a ferramenta que deseja inserir.
  6. Explique quando usar a ferramenta, quais informações coletar e o que fazer com o resultado.
  7. Salve a Habilidade, teste-a na Pré-visualização e publique o Agente de IA quando estiver pronto.
Editor de Habilidades do Agente de IA mostrando o menu de comando de barra com as ferramentas do Shopify Admin.

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.

Defina para cada etapa do conector um caminho de sucesso claro, um caminho para resultado vazio e um caminho de falha. Não peça ao Agente de IA para deduzir informações que a ferramenta não retorna.
Para obter mais orientações sobre gatilhos, instruções e testes, consulte Habilidades de IA.

Exemplo: Consultar um pedido do Shopify

Este exemplo cria uma Habilidade que pode responder a perguntas sobre o pedido e o envio de um cliente no Shopify.

1. Conectar o Shopify Admin

  1. Acesse Agente de IA > Conectores de dados.
  2. Na aba Integrações , abra Shopify Admin e conclua o fluxo de autorização.
  3. Confirme se a integração exibe Conectado.
O Shopify Admin fornece ferramentas somente leitura, como:
  • find_orders para encontrar um pedido a partir das informações fornecidas pelo cliente
  • get_order para recuperar o pedido selecionado
  • get_order_fulfillments para recuperar detalhes de envio e processamento
  • get_fulfillment_events para recuperar eventos de rastreamento de envio
  • get_order_returns e get_return para recuperar detalhes de devolução
  • get_order_refunds e get_refund para recuperar detalhes de reembolso

2. Criar a Habilidade

No Perfil do Agente de IA, selecione Gerenciar em Habilidades e crie uma Habilidade com a seguinte configuração. Nome
Consultar um pedido do Shopify
Gatilho de início
Use esta Habilidade quando um cliente perguntar sobre o status de um pedido, envio, devolução ou reembolso do Shopify. Não a utilize para recomendações de produtos, dúvidas sobre checkout ou solicitações de alteração de pedido.
Instruções passo a passo
  1. Peça ao cliente as informações necessárias para identificar o pedido.
  2. Digite / e insira find_orders de Integração · Shopify Admin. Use-a para encontrar o pedido correspondente.
  3. Se nenhum pedido ou mais de um pedido corresponder, solicite ao cliente informações de identificação adicionais. Não tente adivinhar a qual pedido ele se refere.
  4. Insira e use get_order para o pedido correspondente.
  5. Se o cliente perguntar sobre o envio, insira e use get_order_fulfillments. Use get_fulfillment_events quando detalhes de eventos de rastreamento forem necessários.
  6. Se o cliente perguntar sobre devolução ou reembolso, insira a ferramenta de devolução ou reembolso correspondente.
  7. Resuma apenas as informações retornadas pelas ferramentas. Se uma ferramenta falhar ou as informações solicitadas não estiverem disponíveis, explique que não é possível confirmar o resultado e faça o transbordo quando apropriado.
Os nomes das ferramentas acima aparecem no menu de comando / após a conexão do Shopify Admin. Selecione os comandos nesse menu em vez de inserir seus nomes como texto simples.

3. Testar antes de publicar

Na Pré-visualização, teste pelo menos os seguintes casos:
  • Um pedido corresponde às informações do cliente
  • Nenhum pedido corresponde
  • Vários pedidos correspondem
  • Os detalhes de processamento ou rastreamento não estão disponíveis
  • A ferramenta do Shopify retorna um erro
  • O cliente pede ao agente para alterar um pedido, o que a integração somente leitura do Shopify Admin não pode fazer

Criar um conector de API personalizada

Use um conector de API personalizada quando quiser que uma habilidade de agente de IA chame sua própria API HTTPS. Na guia Custom API , selecione New data connector. Você também pode pesquisar conectores de API personalizada existentes por nome e filtrá-los por status.
Página completa de conectores de dados com pesquisa, filtros de status, conectores existentes e Novo conector de dados.

Open AI Agent > Data connectors, then select New data connector.

Nome e descrição

Dê ao conector um nome que descreva sua função, como retrieve_order. Na descrição, explique quando o conector deve ser usado e o que ele retorna.
Etapa Sobre do conector de dados com os campos de nome e descrição destacados.

Describe the connector's purpose in About before configuring its API request. This draft has not been saved.

Configurar a solicitação de API

Insira o endpoint HTTPS e selecione o método de solicitação:
  • GET lê informações.
  • POST cria informações.
  • PUT substitui ou atualiza informações.
  • PATCH atualiza parte de um recurso.
  • DELETE remove informações.
Etapa de conexão da API do conector de dados com o método HTTP e a URL destacados.

Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.

Cabeçalhos HTTP

Selecione Add header e, em seguida, insira cada cabeçalho obrigatório como um par chave-valor.
Formulário completo de conexão de API mostrando os cabeçalhos de solicitação Content-Type e Accept.

Select Add header and enter each header as a key-value pair. This example has not been saved or sent.

Corpo da solicitação

Para solicitações que enviam dados, insira um corpo de solicitação JSON válido contendo os campos exigidos pela sua API.
Página completa do conector de dados rolada até o corpo da solicitação JSON do POST.

Enter valid JSON in Request Body. This fictional order example has not been sent.

Testar a resposta

Selecione Test request para verificar se o conector retorna a resposta esperada.
O teste envia uma solicitação de API real. Uma solicitação POST, PUT, PATCH ou DELETE pode criar, alterar ou remover dados. Quando possível, teste em um ambiente seguro ou comece com uma solicitação GET somente leitura.
Etapa de teste de resposta com Test Request e um botão Set live desativado.

Select Test Request to run the configured API call. No request has been run in this example.

Ativar o conector

Após um teste bem-sucedido, selecione Set live. Conectores de API personalizada ativos podem ser selecionados no menu de comandos / nas instruções da habilidade. Para parar de usar um conector de API personalizada, abra-o e selecione Set to draft, ou desative seu status na lista de conectores. Revise e resolva todas as dependências listadas antes de movê-lo para rascunho.
Lista completa de conectores de dados com os interruptores de status para conectores ativos existentes.

Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.