文档AEM GuidesAEM Guides 文档

配置AI助手

Last update: Thu Sep 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户

管理员可以在Experience Manager Guides中配置AI助手功能。 AI助手由基于Adobe IMS身份验证的身份验证保护。 将您的环境与Adobe基于令牌的安全身份验证工作流集成并开始使用AI助手功能。 以下配置可帮助您将​ AI配置 ​选项卡添加到文件夹配置文件。 添加后，您可以使用Experience Manager Guides中的AI助手功能。

执行以下步骤以配置AI助手：

  1. 在Adobe Developer Console中创建IMS配置。
  2. 将IMS配置添加到环境
  3. 在环境中启用AI标记
  4. 在环境中添加GUIDES_AI_SITE_ID变量
  5. 将更改应用到环境
  6. 在文件夹配置文件中启用AI助手
  7. 在文件夹配置文件中配置智能建议

在Adobe Developer Console中创建IMS配置

执行以下步骤可在Adobe Developer Console中创建IMS配置：

NOTE
如果您已经创建了OAuth项目来配置基于微服务的发布，则可以跳过以下步骤来创建项目。

  1. 启动Adobe Developer Console。

  2. 成功登录到Developer Console后，您将看到​ 主页 ​屏幕。 在​ 主页 ​屏幕上，您可以轻松地查找信息和快速链接，包括指向项目和下载的顶部导航链接。

  3. 要创建新的空项目，请从​ 快速入门 ​链接中选择​ 新建项目。
    快速入门链接 {width="550"}
    创建新项目。

  4. 从​ 项目 ​屏幕中选择​ 添加API。 出现​ 添加API ​屏幕。 此屏幕可显示Adobe产品和技术的所有可用API、事件和服务，您可以使用这些产品和技术开发应用程序。

  5. 选择​ I/O管理API ​以将其添加到您的项目中。
    IO管理API
    将I/O管理API添加到您的项目中。

  6. 创建新的​ OAuth凭据 ​并保存它。

    配置API中的 OAuth凭据磁贴

    为你的API配置OAuth凭据。

  7. 在​ 项目 ​选项卡中，选择​ OAuth服务器到服务器 ​选项，然后选择新创建的凭据。

  8. 选择​ OAuth服务器到服务器 ​链接以查看项目的凭据详细信息。

    已连接的凭据 {width="800"}

    连接到项目以查看凭据详细信息。

  9. 返回​ 项目 ​选项卡，然后在左侧选择​ 项目概述。

    项目概述 {width="500"}

    开始新项目。

  10. 选择顶部的​ 下载 ​按钮以下载服务JSON。

    下载json {width="500"}

    下载JSON服务详细信息。

您已配置OAuth身份验证详细信息并下载JSON服务详细信息。 根据下一节中的要求，随时准备此文件。

将IMS配置添加到环境

执行以下步骤以将IMS配置添加到环境：

  1. 打开Experience Manager，然后选择包含要配置的环境的程序。

  2. 切换到​ 环境 ​选项卡。

  3. 选择要配置的环境名称。 这应该会将您导航到​ 环境信息 ​页面。

  4. 切换到​ 配置 ​选项卡。

  5. 将JSON服务详细信息（在上一部分中下载）粘贴到与​ 对应的 ​值SERVICE_ACCOUNT_DETAILS字段中。 请确保您使用以下屏幕快照中给出的相同名称和配置。

    ims服务帐户配置 {width="800"}

在环境中启用AI标记

要在Experience Manager Guides UI上启用AI助手功能，请在环境中添加ENABLE_GUIDES_AI标志。

确保您使用的名称和配置与以下屏幕快照中给出的名称和配置相同。

{width="800"}

将该标志设置为​ true ​可启用该功能，将其设置为​ false ​可禁用该功能。

在环境中添加GUIDES_AI_SITE_ID变量

在环境(Cloud Manager)中添加GUIDES_AI_SITE_ID变量并将值设置为id_f651abc807c84f52b425737bb93f87ba以启用它。

确保您使用的名称和配置与以下屏幕快照中给出的名称和配置相同。

{width="800"}

将更改应用到环境

添加IMS配置并向环境启用AI Assistant标记后，执行以下步骤以使用OSGi将这些资产与AEM Guides链接：

  1. 在您的Cloud Manager Git项目代码中，添加以下给定两个文件（对于文件内容，请查看附录）。

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json

  2. 确保filter.xml涵盖新添加的文件。

  3. 提交并推送您的Git更改。

  4. 运行管道以在环境中应用更改。

在文件夹配置文件中启用AI助手

应用配置更改后，为所需的文件夹配置文件启用AI助手功能。

有关详细信息，请查看了解编辑器功能。

{width="300"}

在文件夹配置文件中配置智能建议

启用AI助手功能后，在文件夹配置文件中配置智能建议功能。

有关详细信息，请参阅在文件夹配置文件中配置智能建议。

附录 appendix

文件：
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

内容：

{
 "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]"
}

文件： com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json

内容：

{
  "conref.inline.threshold":0.6,
  "conref.block.threshold":0.7,
  "related.link.threshold":0.5,
  "emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
  "instance.type":"prod",
  "chat.url":"https://aem-guides-ai-v2.adobe.io"
  }

AI助手配置详细信息

键
描述
允许的值
默认值
conref.inline.threshold
控制为用户当前键入的标记获取的建议精确度/回调度的阈值。
从–1.0到1.0的任何值。
0.6
conref.block.threshold
控制在整个文件中为标记获取的建议精确度/回调度的阈值。
从–1.0到1.0的任何值。
0.7
emerald.url
智能建议矢量数据库的端点
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
chat.url
AI助手服务的端点
https://aem-guides-ai-v2.adobe.io
https://aem-guides-ai-v2.adobe.io
instance.type
AEM实例的类型。 请确保对于已配置智能建议的每个AEM实例而言，此变量都是唯一的。 用例是在暂存环境中使用“instance.type”=“stage”测试该功能，与此同时，该功能也在“prod”上配置。
标识环境的任意唯一键。 仅允许​ 个字母数字 ​值。 “dev”/“stage”/“prod”/“test1”/“stage2”
"prod"

配置完毕后，AI助手图标将显示在Experience Manager Guides的主页和编辑器中。 有关更多详细信息，请查看《Experience Manager用户指南》中的AI助手部分。

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178