Consulta los conectores compatibles para Application Integration.

Compila integraciones con Gemini Code Assist

Gemini Code Assist es un colaborador potenciado por IA en Google Cloud que brinda ayuda a los usuarios de todos los niveles de habilidad cuando la necesitan. En Application Integration, Gemini Code Assist puede ayudarte a hacer lo siguiente:

• Crea integraciones
• Cómo configurar tareas de conectores en una integración
• Cómo configurar tareas de la API de REST de llamadas en una integración
• Agrega condiciones perimetrales y agrega tareas adicionales a una integración
• Cómo configurar tareas de JavaScript
• Genera una descripción de la integración

Para obtener información detallada sobre Gemini para Google Cloud, consulta la descripción general de Gemini para Google Cloud .

Antes de comenzar

1. En la consola de Google Cloud, ve a la página Application Integration.
   

   Ir a Application Integration

   En la siguiente imagen, se muestra la página Integración de aplicaciones:

   

   1. En la sección Obtén AI para compilar tus integraciones, haz clic en Explorar.
   2. En el panel Gemini in Application Integration que aparece, haz clic en Enable Service para habilitar la API de Gemini para Google Cloud .

      Para obtener información sobre cómo activar Gemini Code Assist en un Google Cloud proyecto, consulta Configura Gemini Code Assist para un proyecto.

2. Configura la integración de aplicaciones en tu Google Cloud proyecto. Para obtener más información, consulta Cómo configurar la integración de aplicaciones.
3. Si planeas crear una integración con conectores, asegúrate de configurar las conexiones deseadas en tu Google Cloud proyecto.
4. Si planeas crear una integración con las APIs de Apigee API Hub que se encuentran en un proyecto host, asegúrate de aprovisionar el API Hub en tu proyecto y de que la cuenta de servicio de integración de aplicaciones tenga el rol requerido para acceder a las APIs del otro proyecto.

Nota: Gemini proporciona recomendaciones o sugerencias basadas en conectores y el centro de APIs para tus integraciones con las conexiones configuradas en Conectores de integración y las APIs en el centro de APIs de Apigee. Si no tienes ninguna conexión ni API configurada en tu proyecto, es posible que Gemini no proporcione recomendaciones ni sugerencias basadas en conectores y APIs.

Roles obligatorios

• Para obtener los permisos que necesitas para usar Gemini, pídele a tu administrador que te otorgue el rol de IAM de usuario de Gemini para Google Cloud (roles/cloudaicompanion.user) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

  También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

• Si planeas crear una integración con el centro de APIs de Apigee, asegúrate de tener el rol de Visualizador del centro de APIs de Cloud (roles/apigeeregistry.viewer) en el proyecto que contiene las APIs.
• Si planeas crear una integración con Integration Connectors, asegúrate de tener el rol de Visualizador de conectores (roles/connectors.viewer) en el proyecto.

Tareas y activadores compatibles

Gemini puede ayudarte a agregar las siguientes tareas y activadores:

Activadores

Tareas

Activador de API Activador de Cloud Pub/Sub Activador de Salesforce Jira Cloud ServiceNow Zendesk Activador de Cloud Scheduler

Tarea del asignador de datos Tarea Aprobación Tarea Suspender Tarea de JavaScript Cloud Run Functions Tarea Temporizador Tarea Mostrar Tarea de envío de correo electrónico Tarea de conectores Tarea de llamada a extremo de REST Tarea Doc AI - Process Gemini también te ayuda a crear las siguientes tareas de flujo de control, pero no puede generar integraciónes secundarias: Para cada tarea de bucle Tarea En paralelo Tarea de bucle while Tarea Integración de llamadas

Crea una integración

Gemini te ayuda a crear y compilar integraciones con tus instrucciones de lenguaje natural (o instrucciones) como entrada. Esto te permite crear y compilar integraciones simples o complejas con rapidez y con una configuración manual mínima.

Proporciona a Gemini una breve instrucción o descripción del flujo de integración que deseas compilar, y Gemini te sugerirá uno o más flujos de integración para ayudarte a comenzar.

Para compilar una integración con Gemini, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. Haz clic en spark Ayúdame a crear. Aparecerá el panel Crear integración con Gemini.

   Como alternativa, en la página Create Integration, crea una integración nueva y, luego, en el editor de integración, haz clic en pen_spark Create integration flows with Gemini para usar Gemini.



1. Si quieres seleccionar una plantilla de instrucción, elige una de las Plantillas de instrucciones de muestra. De lo contrario, ingresa una instrucción para que Gemini genere integraciones. Para aprender a escribir mejores instrucciones, consulta Escribe mejores instrucciones.

   Por ejemplo, supongamos que agregaste la siguiente instrucción: Crea una integración que recupere un problema de Jira y, luego, cree el ticket de Zendesk.

2. Haz clic en Generar.
   Nota: Gemini sugiere uno o más flujos de integración que califican tu instrucción:

   • Si habilitaste API Hub y los conectores de integración, y cumples con todos los requisitos previos, las recomendaciones contendrán tareas de Llamar a extremo de REST y Conectores.
   • Si tienes un requisito de asignación de datos en tu integración, Gemini también puede sugerir una tarea de asignación de datos. Cuando confirmas la instrucción, la tarea de asignación de datos se reemplaza por una tarea de JavaScript.

   En el siguiente diagrama, se muestra el panel Create an integration with Gemini con las sugerencias que proporciona Gemini:

   

   Usa los botones Anterior y Siguiente para ver las sugerencias proporcionadas.

3. Si quieres modificar el nombre de la integración sugerido, puedes actualizar el campo Nombre de la integración.
   Nota: El nombre de la integración debe ser único en el proyecto Google Cloud .
4. Selecciona una región para la integración. Si tu proyecto tiene una sola región aprovisionada, el campo Región se establece en esa región.
   Nota: En la lista Región, se muestran las regiones aprovisionadas en tu Google Cloud proyecto. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
5. Si quieres editar la instrucción, haz clic en Editar instrucción.
6. Para aceptar una sugerencia de flujo de integración, haz clic en Confirmar. Application Integration muestra el progreso de los pasos para crear la integración. Las integraciones creadas con Gemini reemplazan cualquier elemento y variable de integración existentes.

   

Recomendaciones contextuales

Puedes usar Gemini para proporcionar recomendaciones contextuales para tus integraciones existentes. Gemini puede ayudarte a proporcionar recomendaciones de configuración de conectores contextualmente adecuadas según el flujo lógico de tu integración existente. Si una conexión de tu integración tiene más de 1,000 entidades, ese conector no se incluirá en las recomendaciones de Gemini. Para conocer más limitaciones, consulta Limitaciones.

Configura tareas de conectores

Gemini puede ayudarte a proporcionar recomendaciones de configuración de conectores contextualmente adecuadas según el flujo lógico de tu integración existente. Si una conexión de tu integración tiene más de 1,000 entidades, ese conector no se incluirá en las recomendaciones de Gemini. Para conocer más limitaciones, consulta Limitaciones.

Puedes configurar el conector con los reemplazos recomendados de Gemini o interactuar con Gemini (con sugerencias) y solicitar las sugerencias de configuración deseadas.

Para configurar una tarea de conector en tu integración con Gemini, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el Google Cloud proyecto.

3. Selecciona una integración existente para abrirla en el editor de integración.
4. En la barra de navegación, haz clic en el botón de activación Nueva vista de lienzo (versión preliminar) para ponerlo en la posición de activado. Luego, usa el lienzo para crear tu flujo de trabajo de integración.
5. Para una tarea de conector, haz clic en Más acciones y, luego, en Configurar tarea.

   Aparecerá un menú emergente, similar a la siguiente imagen, que mostrará un conjunto de recomendaciones de Gemini.

   Nota: Gemini puede recomendar tareas de conectores para tareas de Llamar a extremo de REST y viceversa.

   

6. Gemini recomienda automáticamente uno o más reemplazos o alternativas relevantes para el flujo lógico de tu integración. Puedes usar la entrada de instrucciones para interactuar con Gemini y ajustar o volver a generar las recomendaciones sugeridas si lo deseas.

7. Selecciona cualquiera de los reemplazos o las modificaciones recomendados para aceptarlos. Gemini configura la tarea de conector seleccionada.

Configura tareas de la API de REST de Call

Si tienes habilitado API Hub en tu proyecto, Gemini en la integración de aplicaciones puede ayudarte a proporcionar una tarea de llamada a extremo de REST y recomendaciones de configuración de tareas contextualmente apropiadas según el flujo lógico de tu integración existente. Puedes aprovechar estas recomendaciones para reemplazar directamente tus tareas existentes o modificarlas sin necesidad de realizar ningún proceso de configuración manual.

Puedes reemplazar directamente una tarea existente o una configuración de tarea con los reemplazos recomendados de Gemini, o bien interactuar con Gemini (con sugerencias) y solicitar las sugerencias de tareas deseadas.

Una vez que cumplas con todos los requisitos previos, para reemplazar o modificar una tarea existente en tu integración con Gemini, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente para abrirla en el editor de integración.
4. En la barra de navegación, haz clic en el botón de activación Nueva vista de lienzo (versión preliminar) para ponerlo en la posición de activado. Luego, usa el lienzo para crear tu flujo de trabajo de integración.
5. En el lienzo del editor de integración, selecciona la tarea que deseas reemplazar o modificar.
6. Haz clic en Más acciones y, luego, en Configurar tarea.

   Aparecerá un menú emergente, similar a la siguiente imagen, que mostrará un conjunto de recomendaciones de Gemini.

   Nota: Gemini puede recomendar tareas de conectores para tareas de Llamar a extremo de REST y viceversa.

   

7. Gemini recomienda automáticamente uno o más reemplazos o alternativas relevantes para el flujo lógico de tu integración. Puedes usar la entrada de instrucciones para interactuar con Gemini y ajustar o volver a generar las recomendaciones sugeridas si lo deseas.

8. Simplemente selecciona cualquiera de los reemplazos o modificaciones recomendados para aceptarlos.

   Gemini reemplaza directamente la tarea seleccionada o la modifica sin ninguna configuración adicional.

Agrega condiciones perimetrales y tareas adicionales

Puedes usar Gemini para agregar tareas nuevas y condiciones de borde a tu flujo de integración existente.

Para agregar una condición de borde o adjuntar tareas nuevas a tu integración con Gemini, sigue estos pasos:

1. En Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el Google Cloud proyecto.

3. Selecciona una integración existente para abrirla en el editor de integración.
4. En la barra de navegación, haz clic en el botón de activación Nueva vista de lienzo (versión preliminar) para ponerlo en la posición de activado. Luego, usa el lienzo para crear tu flujo de trabajo de integración.
5. En el editor de integración, selecciona el borde para el que deseas agregar la condición de borde o desde el que deseas agregar una tarea nueva.
6. Haz clic en Más acciones y, luego, en Crear rama.

   Aparecerá un menú emergente, similar a la siguiente imagen, que te pedirá que proporciones una entrada.

   

7. Ingresa la instrucción en la que especifiques la condición de borde que deseas agregar o la tarea adicional que deseas adjuntar.

   Esta es una instrucción de muestra que puedes usar:

         If order qty>100, send an email

   Para aprender a escribir mejores instrucciones, consulta Escribe mejores instrucciones.

8. Haz clic en pen_spark Crear.

Gemini inserta automáticamente las condiciones perimetrales calificadas y configura las tareas adicionales del perímetro seleccionado en tu integración existente.

9. Haz clic en Confirmar para aceptar las inserciones y las incorporaciones sugeridas.

   Si no te gustan las inserciones o incorporaciones sugeridas, haz clic en Cancelar .

Configura tareas de JavaScript

Puedes usar Gemini para configurar tareas de JavaScript en tu integración. Gemini puede ayudarte a proporcionar recomendaciones de configuración de tareas de JavaScript contextualmente apropiadas según el flujo lógico de tu integración existente. Puedes aprovechar estas recomendaciones para reemplazar directamente tus tareas existentes o modificarlas sin necesidad de realizar ningún proceso de configuración manual.

Agrega una tarea de JavaScript

La tarea de JavaScript te permite escribir fragmentos de código de JavaScript personalizados para tu integración. Para agregar los fragmentos de código con Gemini, sigue estos pasos:

1. En Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el Google Cloud proyecto.

3. Crea una integración o selecciona una existente para abrirla en el editor de integración.
4. Haz clic y coloca el elemento JavaScript en el editor de integración.
5. Haz clic en el elemento JavaScript en el lienzo para ver el panel de configuración de tareas de JavaScript.
6. Haz clic en spark Secuencias de comandos con Gemini. Se abrirá el panel Secuencia de comandos con Gemini. A continuación, sigue estos pasos:
   1. Si quieres seleccionar una plantilla de instrucción, elige una de las Plantillas de instrucciones de muestra. De lo contrario, ingresa una instrucción para que Gemini genere el código JavaScript. Para aprender a escribir mejores instrucciones, consulta Escribe mejores instrucciones.

      Supongamos que quieres procesar un pedido de un cliente. Tu integración contiene las variables customer y item. Para crear un pedido, puedes ingresar un mensaje similar al siguiente:

      Create order using customer and items.
      

      

   2. Haz clic en Generar.

      Gemini sugiere uno o más fragmentos de código que califican tu instrucción. Usa los botones Anterior y Siguiente para ver las sugerencias proporcionadas.

   3. Para agregar el fragmento de código sugerido a la tarea de JavaScript, haz clic en Confirmar. El fragmento de código aparece en el campo Editor de JavaScript.

Edita una tarea de JavaScript

La tarea de JavaScript te permite escribir fragmentos de código de JavaScript personalizados para tu integración. Para agregar los fragmentos de código con Gemini, sigue estos pasos:

1. En Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el Google Cloud proyecto.

3. Selecciona una integración que contenga la tarea JavaScript.
4. Haz clic y coloca el elemento JavaScript en el editor de integración.
5. Haz clic en el elemento JavaScript en el lienzo para ver el panel de configuración de tareas de JavaScript.
6. Haz clic en Abrir editor de secuencia de comandos. Aparecerá la página Editor de tareas de JavaScript.
7. Haz clic en spark Use Gemini to edit and understand the script > Edit script. Aparecerá el panel Editar secuencia de comandos con Gemini. Luego, sigue estos pasos:
   1. Si quieres seleccionar una plantilla de instrucción, elige una de las Plantillas de instrucciones de muestra. De lo contrario, ingresa una instrucción para que Gemini genere código JavaScript. Para aprender a escribir mejores instrucciones, consulta Escribe mejores instrucciones.

      Supongamos que quieres registrar el pedido cuando el costo sea superior a 100. Luego, puedes ingresar un mensaje similar al siguiente:

            Log in the order when the cost is greater than 100.
            

      

   2. Haz clic en Generar.

      Gemini sugiere uno o más fragmentos de código que califican tu instrucción. Usa los botones Anterior y Siguiente para ver las sugerencias proporcionadas.

   3. Para agregar las actualizaciones sugeridas al fragmento de código en la tarea JavaScript, haz clic en Confirmar. El fragmento de código actualizado aparecerá en el campo Editor de JavaScript.

Comprende la tarea de JavaScript

Gemini puede ayudarte a comprender el fragmento de código en la tarea de JavaScript. Para hacerlo, sigue estos pasos:

1. En la integración, haz clic en el elemento JavaScript en el lienzo para ver el panel de configuración de tareas de JavaScript.
2. En el panel de configuración de la tarea, haz clic en Abrir editor de secuencia de comandos. Aparecerá el panel Editor de secuencia de comandos. Luego, sigue estos pasos:
   1. Haz clic en spark > info_spark Ayúdame a entender.

      Si quieres comprender una parte del código, puedes seleccionar la parte del fragmento que quieres comprender y hacer clic en spark > info_spark Help me understand.

      Aparecerá el panel Gemini:

      

   2. En el panel de Gemini, ingresa una instrucción para que Gemini comprenda el fragmento de código. Para aprender a escribir mejores instrucciones, consulta Escribe mejores instrucciones.

Genera una descripción de la integración

La función de descripción de integración disponible en Gemini en la integración de aplicaciones proporciona un resumen de la integración que creaste en tu editor de integraciones. El resumen de la descripción de la integración se genera en lenguaje sencillo y puede ayudarte a comprender el caso de uso general de la integración, la orquestación subyacente y el contexto empresarial, que pueden ser difíciles de evaluar debido a la estructura o complejidad de una integración.

Para generar un resumen de la descripción de tu integración con Gemini, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se enumerarán todas las integraciones disponibles en el Google Cloud proyecto.

3. Selecciona una integración existente para abrirla en el editor de integración.
4. En la barra de herramientas del editor de integración, haz clic en (Resumen de integración). Aparecerá la página de detalles de la integración.
5. En la página de detalles de la integración, haz clic en Ayúdame con la descripción.

   Gemini analiza la integración en tu editor de integración y genera una descripción de resumen detallada similar a la siguiente imagen.

   

6. Haz clic en Listo para aceptar la descripción de la integración generada.

   Verifica y valida la integración (incluidas las variables) antes de ejecutarla.

Cuotas y límites

Para obtener más información sobre las cuotas y los límites, consulta Cuotas y límites.

Limitaciones

Gemini en Application Integration está sujeto a las siguientes limitaciones:

• Si la conexión de tu integración tiene más de 1,000 entidades, ese conector no se incluye en las recomendaciones de Gemini.
• Application Integration admite la residencia de datos. Las integraciones que se compilan con Gemini admiten la residencia de datos. No almacenamos ningún dato, como instrucciones ni respuestas de Gemini. Solo los datos en uso y en tránsito para la generación con Gemini no admiten la residencia de datos.

Proporcionar comentarios

Puedes obtener asistencia o proporcionar comentarios contextuales mientras usas Gemini para compilar integración. Esta información nos ayuda a mejorar Gemini.

¿Qué sigue?

• Obtén más información para escribir mejores instrucciones.
• Obtén información para probar y publicar una integración.
• Descubre cómo Gemini para Google Cloud usa tus datos.
• Obtén información sobre la descripción general de Gemini para Google Cloud .