See the supported connectors for Application Integration.

Build integrations with Gemini Code Assist

Gemini Code Assist is an AI-powered collaborator in Google Cloud that provides help to users of all skill levels where they need it. In Application Integration, Gemini Code Assist can assist you to do the following:

• Create integrations
• Configure connector tasks in an integration
• Configure Call REST API tasks in an integration
• Add edge conditions and append additional tasks to an integration
• Generate integration description

For detailed information about Gemini for Google Cloud, see Gemini for Google Cloud overview.

Before you begin

1. In the Google Cloud console, go to the Application Integration page.
   

   Go to Application Integration

   The following image shows the Application Integration page:

   

   1. In the Get AI to build your integrations section, click Explore.
   2. In the Gemini in Application Integration pane that appears, click Enable Service to enable the Gemini for Google Cloud API.

      For information about activating Gemini Code Assist in a Google Cloud project, see Set up Gemini Code Assist for a project.

2. Set up Application Integration in your Google Cloud project. For more information, see Set up Application Integration.
3. If you plan to create an integration using connectors, ensure to configure the desired connections in your Google Cloud project.
4. If you plan to create an integration using Apigee API Hub APIs that are in a host project, ensure that you have provisioned the API Hub in your project and that the Application Integration service account has the required role to access the APIs in the other project.

Note: Gemini provides connector- and API Hub-based recommendations or suggestions for your integrations using the configured connections in Integration Connectors and APIs in Apigee API Hub. If you don't have any connections or APIs configured in your project, then Gemini might not provide connector- and API-based recommendations or suggestions.

Required roles

• To get the permissions that you need to use Gemini, ask your administrator to grant you the Gemini for Google Cloud User (roles/cloudaicompanion.user) IAM role on project. For more information about granting roles, see Manage access to projects, folders, and organizations.

  You might also be able to get the required permissions through custom roles or other predefined roles.

• If you plan to create an integration with Apigee API Hub, ensure that you have the Cloud API hub Viewer role (roles/apigeeregistry.viewer) on the project that contains the APIs.
• If you plan to create an integration with Integration Connectors, ensure that you have the Connectors Viewer role (roles/connectors.viewer) on the project.

Supported tasks and triggers

Gemini can assist you to add the following tasks and triggers:

Triggers	Tasks
API trigger Cloud Pub/Sub trigger Salesforce trigger Jira Cloud ServiceNow Zendesk Cloud Scheduler trigger	Data mapper task Approval task Suspend task Javascript task Cloud Run functions Timer task Return task Send email task Connectors task Call REST endpoint task Doc AI - Process task Gemini also assists you to create the following control flow tasks but can't generate sub-integrations: For Each Loop task For Each Parallel task While Loop task Call Integration task

Create an integration

Gemini assists you to create and build integrations using your natural language statements (or prompts) as input. This allows you to create and build simple to complex integrations quickly and with minimal manual configurations.

Provide Gemini a brief prompt or description of the integration flow that you intent to build and Gemini will suggest one or more integration flows to help you get started.

To build an integration using Gemini, perform the following steps:

1. In the Google Cloud console, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Click Create integration to create a new integration.

   The Create Integration page appears.

4. Click pen_spark Help me create. The Create Integration with Gemini pane appears.

   Alternatively, on the Create Integration page, create a new integration and then on the integration editor, click pen_spark Create integration flows with Gemini to use Gemini.



1. If you want to select a prompt template, select one from the Sample prompt templates. Otherwise, enter a prompt for Gemini to generate integrations. To learn how to write better prompts, see Write better prompts.
2. Click Generate.

   Gemini suggests one or more integration flows that qualifies your prompt. If you have enabled API Hub and Integration Connectors and met all prerequisites, then recommendations will contain Call REST Endpoint and Connectors tasks. Use the navigate_before Previous and navigate_next Next buttons to view the suggestions provided.

3. If you want to modify the suggested integration name, you can update the Integration name field.
   Note: Integration name must be unique in the Google Cloud project.
4. Select a region for the integration. If your project has a single provisioned region, then the Region field is set to that region.
   Note: The Region list shows the regions provisioned in your Google Cloud project. To provision a new region, Click Enable Region. See Enable new region for more information.
5. If you want to edit the prompt, click Edit Prompt.
6. To accept an integration flow suggestion, click Confirm.

   Integrations created using Gemini replaces any existing integration elements and variables.

Contextual recommendations

You can use Gemini to provide contextual recommendations for your existing integrations. Gemini can assist you to provide contextually appropriate connector configuration recommendations based on the logical flow of your existing integration. If a connection in your integration has more than 1000 entities, then that connector isn't included in the recommendations by Gemini. For more limitations, see Limitations.

Configure connector tasks

Gemini can assist you to provide contextually appropriate connector configuration recommendations based on the logical flow of your existing integration. If a connection in your integration has more than 1000 entities, then that connector isn't included in the recommendations by Gemini. For more limitations, see Limitations.

You can configure connector configuration with the Gemini recommended replacements, or you can interact with Gemini (using prompts) and ask for the desired configuration suggestions.

To configure a connector task in your integration using Gemini, perform the following steps:

1. In the Google Cloud console, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration to open it in the integration editor.
4. In the navigation bar, click the New canvas view (Preview) toggle to the on position. Then, use the canvas to create your integration workflow.
5. For a connector task, click more_horiz More actions and then click Configure task.

   A pop-up menu, similar to the following image, appears displaying a set of Gemini recommendations.

   Note: Gemini can recommend connectors task for Call REST endpoint tasks and vice-versa.

   

6. Gemini automatically recommends one or more replacements or alternatives relevant to the logical flow of your integration. You can use the prompt input to interact with Gemini and fine-tune or re-generated the suggested recommendations if desired.

7. Select any one of the recommended replacements or modifications to accept. Gemini configures the selected connector task.

Configure Call REST API tasks

If you have API Hub enabled in your project, then Gemini in Application Integration can assist you in providing contextually appropriate Call REST Endpoint task and task configuration recommendations based on the logical flow of your existing integration. You can leverage these recommendations to directly replace your existing tasks or modify them without the need of going through any manual configuration process.

You can either directly replace an existing task or a task configuration with the Gemini recommended replacements, or you can interact with Gemini (using prompts) and ask for the desired task suggestions.

After you have met all prerequisites, to replace or modify an existing task in your integration using Gemini, perform the following steps:

1. In the Google Cloud console, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration to open it in the integration editor.
4. In the navigation bar, click the New canvas view (Preview) toggle to the on position. Then, use the canvas to create your integration workflow.
5. In the integration editor canvas, select the task that you want to replace or modify.
6. Click more_horiz More actions and then click Configure task.

   A pop-up menu, similar to the following image, appears displaying a set of Gemini recommendations.

   Note: Gemini can recommend connectors task for Call REST endpoint tasks and vice-versa.

   

7. Gemini automatically recommends one or more replacements or alternatives relevant to the logical flow of your integration. You can use the prompt input to interact with Gemini and fine-tune or re-generated the suggested recommendations if desired.

8. Simply select any one of the recommended replacements or modifications to accept.

   Gemini directly replaces your selected task or modifies it without any additional configurations.

Add edge conditions and append additional tasks

You can use Gemini to append new tasks and to add edge conditions to your existing integration flow.

To add an edge condition or to append new tasks to your integration using Gemini, perform the following steps:

1. In the Google Cloud, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration to open it in the integration editor.
4. In the navigation bar, click the New canvas view (Preview) toggle to the on position. Then, use the canvas to create your integration workflow.
5. In the integration editor, select the edge for which you want to add the edge condition or from which you want to append a new task.
6. Click more_horiz More actions and then click Create branch.

   A pop-up menu, similar to the following image, appears prompting you to provide an input.

   

7. Enter your prompt specifying the edge condition that you want to add or the additional task that you want to append.

   Here is a sample prompt that you can use:

         If order qty>100, send an email

   To learn how to write better prompts, see Write better prompts.

8. Click pen_spark Create.

Gemini automatically inserts the qualified edge conditions and configures the additional tasks from the selected edge in your existing integration.

9. Click Confirm to accept the sugessted insertions and additions.

   If you din't like the suggested inserts or additions, click Cancel .

Generate integration description

The integration description feature available in Gemini in Application Integration provides a description summary of the integration that you've created in your integration editor. The integration description summary is generated in plain language and can help you in understanding the overall integration use case, underlying orchestration, and business context which might be difficult to assess due to the structure or complexity of an integration.

To generate an integration description summary of your integration using Gemini, perform the following steps:

1. In the Google Cloud console, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration to open it in the integration editor.
4. In the integration editor toolbar, and click (Integration summary). The integration details page appears.
5. In the integration details page, click Help me with description.

   Gemini parses through the integration in your integration editor and generates a detailed summary description similar to the following image.

   

6. Click Done to accept the generated integration description.

   Verify and validate the integration (including the variables) before running it.

Quotas and limits

For information about quotas and limits, see Quotas and limits.

Limitations

Gemini in Application Integration is subject to the following limitations:

• If the connection in your integration has more than 1000 entities, then that connector isn't included in the recommendations by Gemini.
• Application Integration supports data residency. Integrations that are built using Gemini support data residency. We don't store any data such as prompts and Gemini responses. Only data in use and transit for generation using Gemini doesn't support data residency.

Provide feedback

You can get support or provide contextual feedback while using Gemini for building integration. This information helps us improve Gemini.

What's next

• Learn how to write better prompts.
• Learn how to test and publish an integration.
• Learn how Gemini for Google Cloud uses your data.
• Learn about Gemini for Google Cloud overview.