Criar um conector personalizado a partir de um conector personalizado

Nota

Este tópico faz parte de uma série de tutoriais sobre como criar e usar conectores personalizados para Microsoft Copilot Studio Aplicativos Lógicos Microsoft Power Automate do Azure e Microsoft Power Apps. Certifique-se de ler a visão geral do conector personalizado para entender o processo.

O Postman é um aplicativo para fazer solicitações HTTP, e as coleções do Postman ajudam você a organizar e agrupar solicitações de API relacionadas. As coleções podem tornar o desenvolvimento dos conectores personalizados mais rápido e mais fácil se ainda não tiver uma definição de OpenAPI para a API.

Neste artigo, é criada uma coleção que inclui um pedido e resposta da API de análise de texto dos Serviços Cognitivos do Azure. Em um tópico relacionado, você cria um conector usando esta coleção.

Pré-requisitos

• A aplicação Postman
• Uma chave de API para a API de Análise de Texto dos Serviços Cognitivos

Criar um pedido HTTP para a API

1. No Postman, na guia Construtor , selecione o método HTTP, insira a URL da solicitação para o ponto de extremidade da API e selecione um protocolo de autorização, se houver.

   

   Parâmetro	valor
   Método HTTP	POST
   URL do Pedido	https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment
   Autorização	Sem Autorização (especifica uma chave de API no passo seguinte)

2. Introduza pares chave-valor para o cabeçalho do pedido. Para cabeçalhos HTTP comuns, pode selecionar na lista pendente.

   

   Key	valor
   Ocp-Apim-Subscription-Key	Your-API-subscription-key, que pode encontrar na sua conta dos Serviços Cognitivos
   Content-Type	application/json

3. Introduza o conteúdo que pretende enviar no corpo do pedido. Para verificar se a solicitação funciona obtendo uma resposta de volta, selecione Enviar.

   

   {
       "documents": [{
           "language": "en-us",
           "id": "1", 
           "text": "I enjoyed the new movie after a long day."
       }]
   }
   

   O campo de resposta contém a resposta completa da API, que inclui o resultado ou um erro, caso tenha algum.

   

Guardar a coleção

1. Selecione Guardar.

   

2. Na caixa de diálogo Salvar solicitação , insira um nome e uma descrição da solicitação. O conector personalizado utiliza estes valores para o resumo e a descrição da operação da API.

   

   Parâmetro	valor
   Nome do pedido	DetectSentiment
   Descrição do pedido	A API devolve uma pontuação numérica entre 0 e 1. As pontuações próximas de 1 indicam um sentimento positivo, enquanto as pontuações próximas de 0 indicam um sentimento negativo.

3. Selecione + Criar coleção e insira o nome da coleção. O conector personalizado utiliza este valor quando chamar a API. Selecione a marca de seleção (✓), que cria uma pasta de coleção e, em seguida, selecione Salvar em SentimentDemo.

   

   Parâmetro	valor
   Nome da coleção	SentimentDemo

Guardar a resposta do pedido

Agora que guardou o pedido, pode guardar a resposta. Desta forma, a resposta aparecerá como um exemplo quando carregar o pedido mais tarde.

1. Acima da janela de resposta, selecione Salvar resposta.

   

   Os conectores personalizados só suportam uma resposta por pedido. Se guardar várias respostas por pedido, apenas a primeira será utilizada.

2. Na parte superior da aplicação, introduza um nome para a sua resposta de exemplo e, em seguida, selecione Guardar Exemplo.

   

Se a sua API tem funcionalidades adicionais, pode continuar a criar a coleção do Postman com quaisquer pedidos e respostas adicionais.

Exportar a coleção do Postman

Pode exportar a coleção como um ficheiro JSON, que irá importar com o assistente do conector personalizado. Antes de exportar a coleção, remova o tipo de conteúdo e os cabeçalhos de segurança — eles eram necessários para fazer solicitações de API, mas são tratados de forma diferente no conector personalizado.

1. Na guia Cabeçalhos , passe o rato sobre cada cabeçalho e selecione o X ao lado do cabeçalho para removê-lo. Selecione Salvar para salvar a coleção novamente.

   

2. Selecione as reticências (...) junto à coleção e, em seguida, selecione Exportar.

   

3. Selecione o formato de exportação Collection v1 , selecione Exportar e navegue até o local onde deseja salvar o arquivo JSON.

   

   Nota

   Atualmente, só pode utilizar coleções v1 para conectores personalizados.

Passos seguintes

Está pronto para definir um conector personalizado com base na coleção Postman criada:

• Criar um conector personalizado a partir de uma coleção Postman

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para fornecer comentários, vá para Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.