查看 Application Integration 支持的连接器。

使用 Gemini Code Assist 构建集成

Gemini Code Assist 是 Google Cloud 中的 AI 赋能的协作工具，可为各种技能水平的用户提供帮助。在 Application Integration 中，Gemini Code Assist 可帮助您执行以下操作：

• 创建集成
• 在集成中配置连接器任务
• 在集成中配置“调用 REST API”任务
• 向集成添加边缘条件并附加其他任务
• 配置 JavaScript 任务（预览版）
• 生成集成说明

如需详细了解 Gemini for Google Cloud，请参阅 Gemini for Google Cloud 概览。

准备工作

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。
   

   转到 Application Integration

   下图显示了 Application Integration 页面：

   

   1. 在借助 AI 构建集成部分，点击探索。
   2. 在随即显示的 Gemini in Application Integration 窗格中，点击启用服务以启用 Gemini for Google Cloud API。

      如需了解如何在 Google Cloud 项目中启用 Gemini Code Assist，请参阅为项目设置 Gemini Code Assist。

2. 在 Google Cloud 项目中设置 Application Integration。如需了解详情，请参阅设置应用集成。
3. 如果您计划使用连接器创建集成，请务必在 Google Cloud 项目中配置所需的连接。
4. 如果您计划使用宿主项目中的 Apigee API Hub API 创建集成，请确保您已在项目中预配 API Hub，并且 Application Integration 服务账号拥有所需角色，以便访问其他项目中的 API。

注意：Gemini 会根据集成连接器中的已配置连接和 Apigee API Hub 中的 API，为您的集成提供基于连接器和 API Hub 的建议。如果您的项目中未配置任何连接或 API，Gemini 可能不会提供基于连接器和 API 的建议或提示。

所需的角色

• 如需获得使用 Gemini 所需的权限，请让管理员为您授予项目的 Gemini for Google Cloud User (roles/cloudaicompanion.user) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

  您也可以通过自定义角色或其他预定义角色来获取所需的权限。

• 如果您计划与 Apigee API Hub 集成，请确保您在包含 API 的项目上拥有 Cloud API Hub Viewer 角色 (roles/apigeeregistry.viewer)。
• 如果您计划使用集成连接器创建集成，请确保您拥有项目的 Connectors Viewer 角色 (roles/connectors.viewer)。

支持的任务和触发器

Gemini 可以帮助您添加以下任务和触发器：

触发器	Tasks
API 触发器 Cloud Pub/Sub 触发器 Salesforce 触发器 Jira Cloud ServiceNow Zendesk Cloud Scheduler 触发器	数据映射器任务 审批任务 暂停任务 JavaScript 任务 Cloud Run functions 计时器任务 发回作业 “发送电子邮件”任务 连接器任务 “调用 REST 端点”任务 Doc AI - 处理任务 Gemini 还可以帮助您创建以下控制流任务，但无法生成子集成： “针对每一个循环”任务 “针对每一项并行”任务 While 循环任务 “调用集成”任务

创建集成

Gemini 可帮助您使用自然语言语句（或提示）作为输入来创建和构建集成。这样，您就可以快速创建和构建简单到复杂的集成，并且只需进行最少的手动配置。

向 Gemini 提供您打算构建的集成流程的简短提示或说明，Gemini 将建议一个或多个集成流程，帮助您轻松上手。

如需使用 Gemini 构建集成，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 依次点击星火 帮我创作。随即会显示使用 Gemini 创建集成窗格。

   或者，在创建集成页面上创建新集成，然后在集成编辑器中点击 pen_spark 使用 Gemini 创建集成流程，以使用 Gemini。



1. 如果您想选择提示模板，请从提示模板示例中选择一个。否则，请输入提示，让 Gemini 生成集成。如需了解如何撰写更好的提示，请参阅撰写更好的提示。

   例如，假设您添加了以下提示：创建一个集成，用于提取 Jira 问题，然后创建 Zendesk 工单。

2. 点击生成。
   注意：Gemini 会建议一个或多个符合您提示的集成流程：

   • 如果您已启用 API Hub 和 Integration Connectors，并且满足所有前提条件，则建议将包含“调用 REST 端点”任务和“连接器”任务。
   • 如果您的集成需要进行数据映射，Gemini 还可以建议您执行数据映射任务。确认提示后，数据映射任务会被替换为 JavaScript 任务。

   下图显示了“使用 Gemini 创建集成”窗格，其中包含 Gemini 提供的建议：

   

   使用 上一步和 下一步按钮查看提供的建议。

3. 如果您想修改建议的集成名称，可以更新集成名称字段。
   注意：集成名称在 Google Cloud 项目中必须是唯一的。
4. 选择集成的区域。如果您的项目仅预配了一个区域，则区域字段会设置为该区域。
   注意：区域列表显示您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击启用区域。如需了解详情，请参阅启用新区域。
5. 如果您想修改提示，请点击修改提示。
6. 如需接受集成流程建议，请点击确认。Application Integration 会显示创建集成的步骤的进度。使用 Gemini 创建的集成会替换所有现有的集成元素和变量。

   

情境化建议

您可以使用 Gemini 为现有集成提供情境化建议。Gemini 可以根据现有集成的逻辑流程，帮助您提供符合情境的连接器配置建议。如果集成中的某个连接包含 1, 000 个以上的实体，Gemini 将不会在建议中包含该连接器。如需了解更多限制，请参阅限制。

配置连接器任务

Gemini 可以根据现有集成的逻辑流程，帮助您提供符合情境的连接器配置建议。如果集成中的某个连接包含 1, 000 个以上的实体，Gemini 将不会在建议中包含该连接器。如需了解更多限制，请参阅限制。

您可以配置连接器配置，并使用 Gemini 推荐的替换项，也可以与 Gemini 互动（使用提示），并要求提供所需的配置建议。

如需使用 Gemini 在集成中配置连接器任务，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 选择现有集成，以便在集成编辑器中打开它。
4. 在导航栏中，点击新画布视图（预览版）切换开关，将其切换到开启位置。然后，使用画布创建集成工作流。
5. 对于连接器任务，请点击 更多操作，然后点击配置任务。

   系统会显示一个弹出式菜单（类似于下图），其中包含一组 Gemini 建议。

   注意：Gemini 可以为“调用 REST 端点”任务推荐连接器任务，反之亦然。

   

6. Gemini 会自动推荐一个或多个与集成逻辑流程相关的替换项或替代项。您可以使用提示输入与 Gemini 互动，并根据需要对建议的推荐内容进行微调或重新生成。

7. 选择任意一个推荐的替换或修改方案以接受。Gemini 会配置所选的连接器任务。

配置“调用 REST API”任务

如果您在项目中启用了 API Hub，那么 Application Integration 中的 Gemini 可以根据现有集成的逻辑流程，帮助您提供在上下文中合适的“调用 REST 端点”任务和任务配置建议。您可以利用这些建议直接替换或修改现有任务，而无需执行任何手动配置流程。

您可以直接使用 Gemini 推荐的替换项替换现有任务或任务配置，也可以与 Gemini 互动（使用提示）并请求所需的任务建议。

满足所有前提条件后，如需使用 Gemini 替换或修改集成中的现有任务，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 选择现有集成，以便在集成编辑器中打开它。
4. 在导航栏中，点击新画布视图（预览版）切换开关，将其切换到开启位置。然后，使用画布创建集成工作流。
5. 在集成编辑器画布中，选择要替换或修改的任务。
6. 点击 更多操作，然后点击配置任务。

   系统会显示一个弹出式菜单（类似于下图），其中包含一组 Gemini 建议。

   注意：Gemini 可以为“调用 REST 端点”任务推荐连接器任务，反之亦然。

   

7. Gemini 会自动推荐一个或多个与集成逻辑流程相关的替换项或替代项。您可以使用提示输入与 Gemini 互动，并根据需要对建议的推荐内容进行微调或重新生成。

8. 只需选择任意一个推荐的替换或修改项即可接受。

   Gemini 会直接替换或修改您选择的任务，而无需进行任何其他配置。

添加边缘条件并附加其他任务

您可以使用 Gemini 来附加新任务，并向现有集成流程添加边缘条件。

如需使用 Gemini 添加边缘条件或向集成附加新任务，请执行以下步骤：

1. 在 Google Cloud中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 选择现有集成，以便在集成编辑器中打开它。
4. 在导航栏中，点击新画布视图（预览版）切换开关，将其切换到开启位置。然后，使用画布创建集成工作流。
5. 在集成编辑器中，选择要为其添加边条件或要从中附加新任务的边。
6. 点击 更多操作，然后点击创建分支。

   系统会显示一个类似于下图的弹出式菜单，提示您提供输入内容。

   

7. 输入提示，指定要添加的边缘条件或要附加的其他任务。

   以下是您可以使用的提示示例：

         If order qty>100, send an email

   如需了解如何撰写更好的提示，请参阅撰写更好的提示。

8. 点击 pen_spark 创建。

Gemini 会自动插入符合条件的边缘条件，并根据您现有集成中选定的边缘配置其他任务。

9. 点击确认以接受建议的插页和添加内容。

   如果您不喜欢建议的插页或添加项，请点击取消。

配置 JavaScript 任务

预览版

此产品或功能需遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版产品和功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

您可以使用 Gemini 在集成中配置 JavaScript 任务。Gemini 可以根据现有集成的逻辑流程，帮助您提供符合情境的 JavaScript 任务配置建议。您可以利用这些建议直接替换或修改现有任务，而无需执行任何手动配置流程。

添加 JavaScript 任务

通过 JavaScript 任务，您可以为集成编写自定义 JavaScript 代码段。如需使用 Gemini 添加代码段，请按以下步骤操作：

1. 在 Google Cloud中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 创建集成或选择现有集成，以在集成编辑器中打开该集成。
4. 点击 JavaScript 元素，并将其放入集成编辑器中。
5. 点击画布上的 JavaScript 元素以查看 JavaScript 任务配置窗格。
6. 点击 spark 使用 Gemini 生成脚本。系统会打开 Gemini 脚本窗格。然后，执行以下操作：
   1. 如果您想选择提示模板，请从提示模板示例中选择一个。否则，请输入提示，让 Gemini 生成 JavaScript 代码。如需了解如何撰写更好的提示，请参阅撰写更好的提示。

      假设您要处理客户订单。您的集成包含 customer 和 item 变量。如需创建订单，您可以输入如下所示的提示：

      Create order using customer and items.
      

      

   2. 点击生成。

      Gemini 会建议一个或多个符合您提示的代码段。使用 上一步和 下一步按钮查看提供的建议。

   3. 如需将建议的代码段添加到 JavaScript 任务，请点击确认。 代码段会显示在 JavaScript 编辑器字段中。

修改 JavaScript 任务

通过 JavaScript 任务，您可以为集成编写自定义 JavaScript 代码段。如需使用 Gemini 添加代码段，请按以下步骤操作：

1. 在 Google Cloud中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 选择包含 JavaScript 任务的集成。
4. 点击 JavaScript 元素，并将其放入集成编辑器中。
5. 点击画布上的 JavaScript 元素以查看 JavaScript 任务配置窗格。
6. 点击打开脚本编辑器。系统会显示 JavaScript 任务编辑器页面。
7. 依次点击 spark 使用 Gemini 编辑和理解脚本 > 修改脚本。系统随即会显示使用 Gemini 修改脚本窗格。然后，执行以下操作：
   1. 如果您想选择提示模板，请从提示模板示例中选择一个。否则，请输入提示，让 Gemini 生成 JavaScript 代码。如需了解如何撰写更好的提示，请参阅撰写更好的提示。

      假设您希望在订单费用大于 100 时按顺序记录。然后，您可以输入类似于以下内容的提示：

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

      

   2. 点击生成。

      Gemini 会建议一个或多个符合您提示的代码段。使用 上一步和 下一步按钮查看提供的建议。

   3. 如需将建议的代码段更新添加到 JavaScript 任务中，请点击确认。更新后的代码段会显示在 JavaScript 编辑器字段中。

了解 JavaScript 任务

Gemini 可以帮助您理解 JavaScript 任务中的代码段。为此，请按以下步骤操作：

1. 在集成中，点击画布上的 JavaScript 元素以查看 JavaScript 任务配置窗格。
2. 在任务配置窗格中，点击打开脚本编辑器。系统随即会显示脚本编辑器窗格。然后，执行以下操作：
   1. 依次点击 spark > info_spark 帮我理解。

      如果您想了解代码的某个部分，可以选择代码段中要了解的部分，然后依次点击星火图标 > 星火信息图标 帮我理解。

      系统随即会显示 Gemini 窗格：

      

   2. 在 Gemini 窗格中，输入提示，让 Gemini 理解代码段。如需了解如何撰写更好的提示，请参阅撰写更好的提示。

生成集成说明

Application Integration 中的 Gemini 提供的集成说明功能可提供您在集成编辑器中创建的集成的说明摘要。集成说明摘要以简单易懂的语言生成，有助于您了解整体集成应用场景、底层编排和业务上下文，这些内容可能因集成结构或复杂性而难以评估。

如需使用 Gemini 生成集成的集成说明摘要，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。

3. 选择现有集成，以便在集成编辑器中打开它。
4. 在集成编辑器工具栏中，点击 （集成摘要）。系统会显示集成详情页面。
5. 在集成详情页面中，点击帮我撰写说明。

   Gemini 会在集成编辑器中解析集成，并生成详细的摘要说明，类似于下图。

   

6. 点击完成以接受生成的集成说明。

   在运行集成之前，请先验证并确认集成（包括变量）。

配额和限制

如需了解配额和限制，请参阅配额和限制。

限制

Gemini in Application Integration 存在以下限制：

• 如果集成中的连接包含 1, 000 个以上的实体，则 Gemini 的建议中不会包含该连接器。
• Application Integration 支持数据驻留。使用 Gemini 构建的集成支持数据驻留。我们不会存储任何数据，例如提示和 Gemini 回答。仅在使用和传输过程中用于通过 Gemini 生成内容的数据不支持数据留存。

提供反馈

在使用 Gemini 构建集成时，您可以获取支持或提供情境反馈。这些信息有助于我们改进 Gemini。

后续步骤

• 了解如何撰写更好的提示。
• 了解如何测试和发布集成。
• 了解 Gemini for Google Cloud 如何使用您的数据。
• 了解 Gemini for Google Cloud 概览。