Adición de la extensión al borrador de entorno

Para añadir una extensión personalizada al asistente, siga estos pasos:

1. En la página Integraciones, desplácese hasta la sección Extensiones y busque el recuadro correspondiente a la extensión personalizada que desea añadir.

2. Pulse Añadir. Revise la visión general de la extensión y pulse Confirmar para configurarla para su asistente.

   Cuando añade por primera vez una extensión a un asistente, los valores de configuración que especifique se aplican solo al borrador de entorno. Debe completar la configuración para el borrador de entorno antes de poder añadir la extensión al entorno activo.

3. Lea la información del paso Cómo empezar y, a continuación, pulse Siguiente.

4. En el paso Autenticación, especifique la autenticación y la información del servidor que desea que su asistente utilice cuando llame al servicio.

   • En el campo Tipo de autenticación, seleccione el tipo de autenticación a utilizar (o Sin autenticación si la API no está autenticada). Los tipos de autenticación disponibles están determinados por los esquemas de seguridad definidos en el documento OpenAPI.

   • Especifique la información adicional necesaria para el tipo de autenticación que ha seleccionado (por ejemplo, el nombre de usuario y la contraseña, la clave de API, la señal portadora o los detalles de OAuth 2.0 ).

     Para obtener más información sobre cómo configurar la autenticación OAuth 2.0, consulte Autenticación OAuth 2.0.

   • En el campo Servidores, seleccione el URL del servidor que desea utilizar.

     Si el URL seleccionado contiene alguna variable, especifique también los valores a utilizar. En función de cómo se defina cada variable en el documento de OpenAPI, puede seleccionar entre una lista de valores válidos o escribir el valor que desea utilizar en el campo.

     El mensaje URL generada muestra la URL completa que utiliza el asistente, incluidos los valores de las variables.

   Pulse Siguiente.

5. En el paso Gestionar extensión, puede revisar y sustituir el documento OpenAPI importado si es necesario. Para obtener más información sobre cómo sustituir el documento OpenAPI, consulte Sustitución del documento OpenAPI.

6. En la pestaña Autenticación, verá información sobre los métodos de autenticación definidos en el documento OpenAPI. Tabla. Los campos de la pestaña Autenticación proporcionan detalles sobre los campos de la pestaña Autenticación:

   Nombre de campo	Descripción	Valores
   Tipo de autenticación	El tipo de autenticación configurado en el script OpenAPI.	- OAuth 2.0 - Basic Auth - API key auth - Bearer auth
   Nombre de usuario	La credencial de nombre de usuario en el script OpenAPI.	Por ejemplo, user
   Contraseña	La credencial de contraseña configurada en el script OpenAPI.	Por ejemplo, Password@123
   Servidores	El enlace al servidor que está definido en el documento de Open API para conectarse. a la extensión de API.	Por ejemplo, https://custom-extension-server.xyz

7. La tabla Revisar operaciones muestra las operaciones que el asistente puede llamar desde un paso de acción. Una operación es una solicitud mediante un método HTTP determinado, como GET o POST, sobre un recurso concreto.

   

   Para cada operación, una fila de la tabla muestra la siguiente información:

   • Operación: descripción de la operación, que se deriva de summary (si está presente) o de description en el archivo OpenAPI.
   • Método: el método HTTP utilizado para enviar la solicitud de API para la operación.
   • Recurso: la vía de acceso al recurso sobre el que actúa la operación.

   Para ver más información sobre una operación, pulse el icono situado junto a su fila de la tabla. Se muestran los siguientes detalles:

   • Parámetros de solicitud: la lista de parámetros de entrada definidos para la operación, junto con el tipo de cada parámetro y si el parámetro es necesario u opcional.
   • Propiedades de la respuesta: Las propiedades del cuerpo de la respuesta que se asignan a variables a las que puede acceder el asistente.

8. Pulse Finalizar.

9. Pulse Cerrar para volver a la página Integraciones.

La extensión está ahora conectada al asistente y está disponible para las acciones en el borrador de entorno.

Configuración de la extensión para el entorno activo

Para configurar la extensión para el entorno activo, siga estos pasos:

1. En la página Integraciones, desplácese hasta la sección Extensiones y busque el recuadro correspondiente a la extensión personalizada que desea añadir.

2. Pulse Abrir. Se abre la ventana Abrir extensión personalizada.

3. En el campo Entorno, seleccione Activo. Pulse Confirmar.

4. Repita el proceso de configuración, especificando los valores que desea utilizar para el entorno en vivo.

   Si está utilizando varios entornos, siga los mismos pasos para configurar la extensión para cada entorno. Para obtener más información, consulte Adición y utilización de varios entornos.

La extensión ya está disponible en los entornos que configuró, y puede llamarse desde el asistente. Para obtener más información sobre cómo llamar a una extensión de una acción, consulte Llamar a una extensión personalizada.

Límites de plan

El número de extensiones personalizadas que puede añadir a un asistente depende de su plan. Si ya ha añadido el número máximo de extensiones al asistente, debe eliminar una para poder añadir una nueva.