O que são conectores de dados?
Conectores de dados são integrações profundamente incorporadas que podem conectar seus dados externos em tempo real conosco. Uma ótima maneira de começar é pensar nas dúvidas comuns que sua equipe passa um tempo considerável respondendo, usando informações que atualmente não estão disponíveis em nossa plataforma. Podem ser perguntas em que seus clientes simplesmente desejam obter informações armazenadas em um sistema externo, como “Meu pedido foi entregue?”, ou atualizar informações, como “Reagendar uma entrega” ou “Processar um reembolso” no seu sistema externo.Criando um conector de dados
Primeiro, navegue até AI Agent > Conectores de dados. É aqui que você pode configurar conectores de dados para conectar seus dados externos. Você pode criar um clicando em Novo conector de dados. Você também pode pesquisar conectores de dados específicos por nome e status.
Open AI Agent > Data connectors, then select New data connector.
Nome e descrição
Dê ao seu conector de dados um nome que indique claramente sua função específica (por exemplo, “retrieve_order_id”). No campo de descrição, informe à sua equipe quando usar este conector e quais dados ele irá recuperar (por exemplo, “Busca detalhes do pedido para um ID de pedido fornecido”).
Describe the connector’s purpose in About before configuring its API request. This draft has not been saved.
Conexão de API
Requisição de API
Em seguida, preencha os detalhes da requisição. É aqui que você precisará inserir a URL HTTPS para o sistema de terceiros ao qual está se conectando. Você pode especificar qual conector de dados deseja que esta requisição utilize selecionando o método:- GET - Ler e armazenar informações do sistema de terceiros.
- POST - Criar ou adicionar informações no sistema de terceiros.
- PUT - Atualizar informações no sistema de terceiros.
- DELETE - Remover informações do sistema de terceiros.
- PATCH - Atualizar informações no sistema de terceiros.
Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.
Cabeçalhos HTTP
Você pode optar por adicionar parâmetros adicionais a esta requisição clicando em Adicionar cabeçalho e, em seguida, adicionar o Par chave-valor em Cabeçalhos HTTP:
Select Add header and enter each header as a key-value pair. This example has not been saved or sent.
Corpo da requisição
Se você estiver fazendo uma requisição POST ou PUT, terá a opção de fornecer um corpo de requisição para incluir quaisquer dados que queira enviar na requisição:
Enter valid JSON in Request Body. This fictional order example has not been sent.
Testar resposta
Em seguida, você precisará testar a resposta deste conector de dados para garantir que ele esteja buscando os dados corretos do sistema externo ao qual você está se conectando. Clique em Testar requisição para verificar se o conector de dados foi configurado corretamente.
Select Test Request to run the configured API call. No request has been run in this example.
Publicar
Depois de testar seu conector de dados com sucesso, você estará pronto para publicá-lo. Selecione Publicar no canto superior direito após o teste ser bem-sucedido. O exemplo não testado acima mantém este botão desativado.Definir como rascunho
Se você quiser descontinuar conectores de dados antigos que não são mais necessários, poderá movê-los para o estado de rascunho. Você pode clicar no conector de dados que deseja mover para rascunho e selecionar Definir como rascunho ou desativar o interruptor de status na lista.
Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.