
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: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.- Abra o Agente de IA que deseja configurar.
- Em Perfil, localize Habilidades e selecione Gerenciar.
- Crie uma Habilidade ou abra uma existente.
- Em Instruções passo a passo, digite /.
- Expanda o grupo relevante de Integração, MCP ou Conectores de dados e, em seguida, selecione a ferramenta que deseja inserir.
- Explique quando usar a ferramenta, quais informações coletar e o que fazer com o resultado.
- Salve a Habilidade, teste-a na Pré-visualização e publique o Agente de IA quando estiver pronto.

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.
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
- Acesse Agente de IA > Conectores de dados.
- Na aba Integrações , abra Shopify Admin e conclua o fluxo de autorização.
- Confirme se a integração exibe Conectado.
find_orderspara encontrar um pedido a partir das informações fornecidas pelo clienteget_orderpara recuperar o pedido selecionadoget_order_fulfillmentspara recuperar detalhes de envio e processamentoget_fulfillment_eventspara recuperar eventos de rastreamento de envioget_order_returnseget_returnpara recuperar detalhes de devoluçãoget_order_refundseget_refundpara 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. NomeConsultar um pedido do ShopifyGatilho 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
- Peça ao cliente as informações necessárias para identificar o pedido.
- Digite / e insira
find_ordersde Integração · Shopify Admin. Use-a para encontrar o pedido correspondente. - 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.
- Insira e use
get_orderpara o pedido correspondente. - Se o cliente perguntar sobre o envio, insira e use
get_order_fulfillments. Useget_fulfillment_eventsquando detalhes de eventos de rastreamento forem necessários. - Se o cliente perguntar sobre devolução ou reembolso, insira a ferramenta de devolução ou reembolso correspondente.
- 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.
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.Open AI Agent > Data connectors, then select New data connector.
Nome e descrição
Dê ao conector um nome que descreva sua função, comoretrieve_order. Na descrição, explique quando o conector deve ser usado e o que ele retorna.
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.
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.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.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.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.Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.

