Creación de un conector personalizado a partir de una colección de Postman

Para crear un conector personalizado, describa la API a la que quiere conectarse para que el conector comprenda las acciones y las estructuras de datos de la API. En este artículo, creará un conector personalizado mediante una colección de Postman que describe la API de sentimiento de Text Analytics de Cognitive Services, que sirve como ejemplo en esta serie.

Para conocer otras formas de describir una API, vaya a los siguientes temas:

• Creación de un conector personalizado desde una definición de OpenAPI

• Creación de un conector personalizado desde cero

Requisitos previos

Compruebe los requisitos previos para asegurarse de que tiene todo lo que necesita para crear un conector personalizado. Necesita:

• Una colección Postman que describe la API de ejemplo. Siga las instrucciones de Creación de una colección de Postman para un conector personalizado.

• Una clave de API para la API de Texto Analytics de Cognitive Services.

• Una de las siguientes suscripciones:

  • Azure, si está utilizando Logic Apps
  • Power Automate
  • Power Apps

• Si usa Logic Apps, cree un conector personalizado de Azure Logic Apps en primer lugar.

Importar la colección de Postman

Ahora estás listo para usar la colección de Postman que creaste o descargaste. La colección tiene gran parte de la información necesaria. Puede revisar y actualizar esta información a medida que avance por el asistente de conectores personalizados. Empiece por importar la colección de Postman para Logic Apps o para Power Automate y Power Apps.

Importar la colección Postman para Logic Apps

1. Vaya a Azure Portal y abra el conector de Logic Apps que creó anteriormente en Creación de un conector personalizado de Azure Logic Apps.

2. En el menú de su conector, elija Conector de Logic Apps y elija Editar.

   

3. Bajo General, elija Cargar colección Postman V1 y luego navegue a la colección Postman que creó.

   

   El asistente importa la colección y después la convierte en una definición de OpenAPI denominada generatedApiDefinition.swagger.json.

Importar la colección de Postman para Power Automate y Power Apps

1. Vaya a make.powerapps.com o flow.microsoft.com.

2. En el panel de navegación, seleccione Más>Descubrir todo

3. En la sección Datos, seleccione Conectores personalizados.

4. Elija Nuevo conector personalizado y, a continuación, Importar una colección de Postman.

5. Escriba un nombre para el conector personalizado, navegue a la colección de Postman que ha descargado o creado y seleccione Continuar.

   

   Parámetro	valor
   Título de conector personalizado	"SentimentDemo"

   El asistente importa la colección y la convierte en una definición de OpenAPI denominada generatedApiDefinition.swagger.json.

Actualizar los detalles generales

Desde este punto, en este artículo se muestra la interfaz de usuario de Power Automate, pero los pasos son principalmente los mismos en las tres tecnologías. Las diferencias se resaltan según sea necesario.

1. En la página General, revise la información que se importó desde la colección de Postman, incluido el host y la dirección URL base de la API. El conector usa el host y la dirección URL base para determinar cómo llamar a la API.

   Nota

   Para obtener más información sobre cómo conectarse a las API locales, vea Conectar a las API locales utilizando la puerta de enlace de datos.

2. Actualice la descripción con algo descriptivo. Esta descripción aparece en los detalles del conector personalizado y ayuda a otros usuarios a comprender cómo resulta útil el conector.

   Parámetro	valor
   Descripción	"Usa la API Text Analytics Sentiment de Cognitive Services para determinar si el texto es positivo o negativo".

Especifique el tipo de autenticación

Los conectores personalizados admiten varias opciones de autenticación. Las Cognitive Services APIs usan la autenticación de clave de API.

1. En la página Seguridad, en Tipo de autenticación, elija Clave de API.

2. En Clave de API, especifique una etiqueta, el nombre y la ubicación del parámetro. Elija una etiqueta expresiva y significativa. Este texto se mostrará a los usuarios para ayudarles a establecer las conexiones mediante el conector personalizado. El nombre y la ubicación del parámetro deben coincidir con lo que espera la API (en este caso, el encabezado que ha especificado en Postman). Elija Conectar.

   

   Parámetro	valor
   Etiqueta de parámetro	"Clave de API"
   Nombre de parámetro	"Ocp-Apim-Subscription-Key"
   Ubicación del parámetro	"Encabezado"

3. En la parte superior del asistente, asegúrese de que el nombre se establece en "SentimentDemo" y, después, seleccione Crear conector.

Revisar y actualizar la definición del conector

El asistente para conectores personalizados ofrece muchas opciones para definir cómo funciona el conector y cómo se expone en aplicaciones lógicas, flujos, aplicaciones y agentes. En esta sección se explica la interfaz de usuario y se tratan algunas opciones, pero puede explorar más por su cuenta.

Revisar la interfaz de usuario y la definición

Antes de seguir los pasos de la página Definición , revise la interfaz de usuario.

1. En esta área se muestran las acciones, los desencadenadores (para Logic Apps y Power Automate), las referencias y las directivas que se definen para el conector. En este caso, se muestra la acción DetectSentiment de la colección Postman. No hay ningún desencadenador en este conector, pero puede obtener información acerca de los desencadenadores de conectores personalizados en Usar webhooks con Azure Logic Apps y Power Automate.

   

2. El área General muestra información acerca de la acción o el desencadenador seleccionado actualmente. Esta información procede de la colección de Postman. Puede editar la información aquí, incluida la propiedad Visibility, para las operaciones y los parámetros de una aplicación lógica o de un flujo:

   • Importante: se muestra siempre primero al usuario
   • Ninguna: normalmente se muestra en la aplicación lógica o el flujo
   • Avanzada: inicialmente está oculta en un menú adicional
   • interna: no se muestra al usuario

3. En el área Solicitud se muestra la información basada en la solicitud HTTP que se incluye en la colección de Postman. En este caso, verá que el verbo HTTP es POST y la dirección URL es "/text/analytics/v2.0/sentiment" (la dirección URL completa de la API es <https://westus.api.cognitive.microsoft.com//text/analytics/v2.0/sentiment>). Eche un vistazo más detenidamente al parámetro body en breve.

4. El área Respuesta muestra información basada en la respuesta HTTP que se incluye en la colección de Postman. En este caso, la única respuesta definida es para "200" (una respuesta correcta), pero puede definir respuestas adicionales.

5. En el área Validación se muestran los problemas detectados en la definición de la API. Asegúrese de comprobar esta área antes de guardar un conector.

Actualizar la definición

Ahora, cambie algunas opciones de configuración para facilitar el uso del conector en una aplicación lógica, Power Automate o Power Apps.

1. En el área General, actualice el resumen a "Devuelve una puntuación numérica que representa la opinión detectada".

2. En el área Solicitud, elija body y, después, Editar.

3. En el área Parámetro, ahora verá los tres parámetros que espera la API: id, language y text. Elija id y, después, Editar.

4. En el área Propiedad de esquema, actualice los valores del parámetro y, a continuación, elija Volver.

   

   Parámetro	valor
   Título	"Id."
   Descripción	"Un identificador para cada documento que se envía"
   Valor predeterminado	"1"
   Es obligatorio	"Sí"

5. En el área Parámetro, elija idioma y, después, Editar y repita el proceso que ha usado anteriormente con los valores siguientes.

   Parámetro	valor
   Título	"Language"
   Descripción	"El código de idioma de dos o cuatro caracteres para el texto"
   Valor predeterminado	"en"
   Es obligatorio	"Sí"

6. En el área Parámetro, elija texto, después Editar y repita el proceso que ha usado anteriormente con los valores siguientes.

   Parámetro	valor
   Título	"Texto"
   Descripción	"El texto para analizar las opiniones"
   Valor predeterminado	Nada
   Es obligatorio	"Sí"

7. En el área Parámetro, elija Volver para volver a la página de definición principal.

8. En la parte superior derecha del asistente, elija Actualizar conector.

Prueba del conector

Después de crear el conector, pruebelo para asegurarse de que funciona correctamente. Las pruebas solo están disponibles en Power Automate y Power Apps.

1. En la página Prueba, elija Nueva conexión.

2. Escriba la clave de API de Text Analytics API y, después, elija Crear conexión.

3. Vuelva a la página de prueba:

   • En Power Automate, le dirigirá de nuevo a la página Prueba. Elija el icono de actualización para asegurarse de que se actualiza la información de la conexión.
   • En Power Apps, accede a la lista de conexiones disponibles en el entorno actual. En la esquina superior derecha, elija el icono de engranaje y después Conectores personalizados. Elija el conector que ha creado y vuelva a la página Prueba.

4. En la página Prueba, escriba un valor para el campo text (los demás campos utilizan los valores predeterminados que estableció anteriormente) y, a continuación, elija Probar operación.

5. El conector llama a la API y puede revisar la respuesta, que incluye la puntuación de opinión.

   

Limitaciones

En Power Automate y Power Apps, si actualiza un conector personalizado existente mediante una colección de Postman, debe rehacer las personalizaciones anteriores antes de guardar el conector. Por ejemplo, debe volver a configurar el tipo de autenticación y los valores predeterminados de los parámetros de las acciones.

Pasos siguientes

Después de crear un conector personalizado y definir sus comportamientos, use el conector.

• Uso de un conector personalizado desde un flujo
• Usar un conector personalizado a partir de una aplicación
• Uso de un conector personalizado desde una aplicación lógica

También puede compartir un conector dentro de su organización o obtener la certificación del conector para que las personas ajenas a la organización puedan usarla.

• Compartir el conector
• Certificación del conector

Proporcionar comentarios

Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de funciones. Para enviar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione el tipo de comentario.