Saltar para o conteúdo principal
Os conectores de dados permitem que os AI Agents usem ferramentas de serviços externos. Configure uma conexão uma vez e adicione às Skills as ferramentas específicas de que cada Agent precisa. Abra AI Agent > Data connectors para visualizar e gerenciar suas conexões.
Página Data connectors mostrando as abas Integrations, MCP e Custom API e as integrações disponíveis.

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

​
Escolher um tipo de conector

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

​
Adicionar ferramentas de conectores a uma Skill do AI Agent

Conectar um serviço não adiciona automaticamente todas as ferramentas disponíveis a todos os AI Agents. Escolha nas Skills as ferramentas que cada Agent pode usar.
  1. Abra o AI Agent que você deseja configurar.
  2. Em Profile, localize Skills e selecione Manage.
  3. Crie uma Skill ou abra uma existente.
  4. Em Step-by-Step instructions, digite /.
  5. Expanda o grupo relevante de Integration, MCP ou Data connectors e 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 Skill, teste-a no Preview e publique o AI Agent quando estiver pronto.
Editor de Skill do AI Agent mostrando o menu de comandos 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 claro para sucesso, resultado vazio e falha. Não peça ao AI Agent que deduza informações que a ferramenta não retorna.
Para saber mais sobre gatilhos, instruções e testes, consulte AI Skills.

​
Exemplo: Consultar um pedido da Shopify

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

​
1. Conectar o Shopify Admin

  1. Acesse AI Agent > Data connectors.
  2. Na aba Integrations, abra Shopify Admin e conclua o fluxo de autorização.
  3. Confirme se a integração mostra Connected.
O Shopify Admin fornece ferramentas somente leitura, como:
  • find_orders para encontrar um pedido com base nas informações fornecidas pelo cliente
  • get_order para recuperar o pedido selecionado
  • get_order_fulfillments para recuperar detalhes de envio e atendimento do pedido
  • get_fulfillment_events para recuperar eventos de rastreamento do 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 Skill

Em Profile do AI Agent, selecione Manage em Skills e crie uma Skill com a configuração a seguir. Name
Consultar um pedido da Shopify
Start trigger
Use esta Skill quando um cliente perguntar sobre o status de um pedido, envio, devolução ou reembolso da Shopify. Não a use para recomendações de produtos, dúvidas sobre checkout ou solicitações para alterar um pedido.
Step-by-Step instructions
  1. Peça ao cliente as informações necessárias para identificar o pedido.
  2. Digite / e insira find_orders em Integration · Shopify Admin. Use essa ferramenta para encontrar o pedido correspondente.
  3. Se nenhum pedido ou mais de um pedido corresponder, peça ao cliente informações adicionais de identificação. 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 precisar dos detalhes dos eventos de rastreamento.
  6. Se o cliente perguntar sobre uma devolução ou um reembolso, insira a ferramenta correspondente.
  7. Resuma somente as informações retornadas pelas ferramentas. Se uma ferramenta falhar ou a informação solicitada não estiver disponível, explique que não é possível confirmar o resultado e transfira a conversa quando apropriado.
Os nomes das ferramentas acima aparecem no menu de comandos / depois que o Shopify Admin é conectado. Selecione os comandos nesse menu em vez de inserir os nomes como texto simples.

​
3. Testar antes de publicar

No Preview, teste pelo menos estes casos:
  • Um pedido corresponde às informações do cliente
  • Nenhum pedido corresponde
  • Vários pedidos correspondem
  • Os detalhes de atendimento ou rastreamento não estão disponíveis
  • A ferramenta da Shopify retorna um erro
  • O cliente pede ao Agent para alterar um pedido, o que a integração somente leitura do Shopify Admin não pode fazer

​
Criar um conector Custom API

Use um conector Custom API quando quiser que uma Skill do AI Agent chame sua própria API HTTPS. Na aba Custom API, selecione New data connector. Você também pode pesquisar conectores Custom API existentes por nome e filtrá-los por status.
Página completa Data connectors com pesquisa, filtros de status, conectores existentes e New data connector.

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 About 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 da 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 de 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 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 JSON válido contendo os campos exigidos pela sua API.
Página do conector de dados rolada até o corpo JSON da solicitação 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. Sempre que possível, teste em um ambiente seguro ou comece com uma solicitação GET somente leitura.
Etapa Test response 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. Os conectores Custom API ativos podem ser selecionados no menu de comandos / das instruções da Skill. Para deixar de usar um conector Custom API, abra-o e selecione Set to draft, ou desative o status na lista de conectores. Revise e resolva todas as dependências listadas antes de movê-lo para rascunho.
Lista completa de Data connectors com os botões Status dos 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.