本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AI 提示和 AI 代理的升级模型
<a name="upgrade-models-ai-prompts-agents"></a>

当您在 Amazon Connect 中自定义 AI 提示或 AI 代理时，与每个 AI 提示关联的模型将决定哪个大型语言模型 (LLM) 处理指令。随着时间的推移，更新、功能更强的型号问世。本主题介绍如何在几个常见场景中升级模型。
+ 您的自定义 AI 代理具有一个或多个使用已弃用模型的自定义 AI 提示
+ 你有一个没有提示覆盖的自定义 AI 代理
+ 您正在使用旧版本的系统 AI 代理。

## 先决条件
<a name="upgrade-models-prerequisites"></a>

在升级模型之前，请确保您具备以下条件：
+ 启用了 AI 代理设计器的 Amazon Connect 实例。
+ 管理员帐户，或在其安全配置文件中具有 AI 代理设计者权限的帐户。
+ 熟悉 [ AI 提示](create-ai-prompts.md)、[ AI 代理](create-ai-agents.md)以及[默认系统 AI 提示和代理](default-ai-system.md)。

## 何时升级
<a name="upgrade-models-when-to-upgrade"></a>

Amazon Connect 会在计划弃用模型时通知您。在任何模型过期后，Amazon Connect 会自动将 LLM 推断重定向到支持的模型，因此不会出现服务中断。但是，通过在弃用日期之前手动升级，您可以选择替代型号并在您的环境中对其进行测试。使用以下步骤来确定哪些场景适用于您。

**第 1 步：检查自定义 AI 代理。**在管理员网站中，导航到 * AI 代理设计*器 * AI 代理*。查看 “*类型*” 列。系统代理在类型名称*后面显示 *-系统（例如，“答案建议-系统”）。没有此后缀的代理是您创建的自定义代理。
+ 如果您的自定义 AI 代理分配了一个或多个自定义 AI 提示符 → 场景 1（如果您仅覆盖某些提示类型，则未设置的提示会自动升级；您只需要升级自定义提示即可）
+ 如果您有没有提示覆盖的自定义 AI 代理 → 场景 2（提示自动升级，无需操作）
+ 如果您没有任何自定义 AI 代理，请跳到步骤 2。

**步骤 2：检查默认 AI 代理配置。**在同一 * AI 代理*页面上，滚动到*默认 AI 代理配置*部分。如果将任何用例固定到特定版本（未设置为*最新*），则可以对其进行更新 → 场景 3。这适用于所有客户，即使您没有定制代理。

## 模型分辨率的工作原理
<a name="upgrade-models-how-model-resolution-works"></a>

配置单个 AI 代理时，您可以选择让 Connect 为每个提示选择使用哪个 LLM，选择您希望每个提示使用的模型，或者选择这两个选项的组合。
+ 每个 AI 提示符都有一个模型属性，用于指定要使用哪个 LLM。
+ 每个 AI 代理都会引用一个或多个 AI 提示版本。版本是提示的不可变快照，包括其模型选择。
+ 当您创建自定义 AI 代理并仅覆盖与该代理相关的部分提示时，其余类型将在运行时使用系统默认值填充。您明确设置的提示将固定到您选择的版本。系统填写的提示使用最新的系统默认值。这种按提示类型的解决方案适用于非代理 AI 代理类型，例如答案推荐、手动搜索和自助服务。 Non-Agentic 
+ 可用模型取决于您的 Amazon Connect 实例的 AWS 区域。有关每个区域支持的型号列表，请参阅[支持 system/custom 的提示型号](create-ai-prompts.md#cli-create-aiprompt)。

## 场景 1：带有自定义 AI 提示的自定义 AI 代理
<a name="upgrade-models-scenario-1"></a>

在这种情况下，您创建了一个自定义 AI 代理并为其分配了一个或多个自定义 AI 提示。自定义提示将固定到您在发布时选择的模型上。

自定义提示不会自动接收模型升级。您必须手动更新模型、发布新的提示版本并更新 AI 代理。

### 如果你只覆盖了某些提示类型
<a name="upgrade-models-scenario-1-partial-overrides"></a>

某些 AI 代理类型支持多种提示类型。例如，答案推荐 AI 代理支持三种提示类型：意图标签生成、查询重拟和答案生成。如果您仅将其中一些设置为自定义提示而其余提示未设置，则适用以下内容：
+ 您明确设置的提示类型（通过管理员网站或 CLI）将固定到您选择的特定提示版本。除非你更新它们，否则它们不会改变。针对每个自定义提示按照以下升级步骤操作。
+ 您未设置的提示类型不会存储在 AI 代理配置中。在运行时，Amazon Connect 会根据当前的系统默认值解析这些问题。这些类型始终使用最新的系统提示版本，包括任何模型升级。对于未设置的提示类型，无需执行任何操作。

### 使用管理员网站升级
<a name="upgrade-models-scenario-1-admin-website"></a>

**第 1 步：使用更新后的模型创建新的提示版本 **

1. 登录 Amazon Connect 管理员网站。

1. 在导航菜单中，选择 * AI 代理设计器*，*AI 提示*。

1. 从提*示*列表中，选择要升级的自定义 AI 提示。

1. 在 AI 提示生成器中选择 * “编辑”*（右上角）。

1. 右上角的下拉列表显示 “*最新：草稿*”。这是你要修改的工作副本。

1. 在*模型*部分中，使用下拉列表选择新模型。

1. 选择*发布*。这将使用新模型创建新版本的提示符。

1. 向下滚动到同一页面上的 “*版本” * 部分。您可以确认新版本已创建。

1. 要验证新版本，请导航回到 * AI 代理设计器*，A * I 会提示您*。从列表中选择提示，然后使用版本下拉列表（右上角）选择新版本。*概述*部分显示更新后的模型 ID。

**第 2 步：更新 AI 代理以使用新的提示版本 **

1. 导航到 * AI 代理设计器*、* AI 代理*。

1. 选择引用此提示的自定义 AI 代理。

1. 在 AI 代理生成器中选择 “*编辑” * 以打开代理生成器页面。

1. 选择 “*添加提示” *。出现一个弹出窗口，其中包含可用的提示。

1. 选择新的提示版本，然后选择 “*添加” *。弹出窗口关闭，提示将添加到代理中。

1. 选择*发布*。这将使用自定义提示符和更新后的模型创建新的 AI 代理版本。

1. 向下滚动到*版本*部分以确认出现新的 AI 代理版本。

1. （可选）从右上角的下拉列表中选择最新版本。提*示*部分显示新的提示版本。

**步骤 3：将新的 AI 代理版本设置为默认版本 **

1. 导航到 * AI 代理设计器*、* AI 代理*。

1. 在*默认 AI 代理配置*部分中，找到使用自定义 AI 代理的用例并将其更新到新版本。

1. 选择复选标记图标 (✓) 进行保存。

1. 为避免每次都手动更新版本，请*从版本下拉列表中选择 “*最新”。这会自动使用最近发布的 AI 代理版本。

### 使用 AWS CLI 升级
<a name="upgrade-models-scenario-1-cli"></a>

使用新模型更新 AI 提示符：

```
aws qconnect update-ai-prompt \
  --assistant-id {{assistant-id}} \
  --ai-prompt-id {{custom-prompt-id}} \
  --model-id {{new-model-id}}
```

发布提示符的新版本：

```
aws qconnect create-ai-prompt-version \
  --assistant-id {{assistant-id}} \
  --ai-prompt-id {{custom-prompt-id}}
```

更新 AI 代理以引用新的提示版本：

```
aws qconnect update-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-id {{custom-agent-id}} \
  --configuration '{
    "{{agentTypeConfiguration}}": {
      "{{promptTypeAIPromptId}}": "{{custom-prompt-id}}:{{new-version-number}}"
    }
  }'
```

发布新版本的 AI 代理：

```
aws qconnect create-ai-agent-version \
  --assistant-id {{assistant-id}} \
  --ai-agent-id {{custom-agent-id}}
```

将新的 AI 代理版本设置为默认版本：

```
aws qconnect update-assistant-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-type {{AGENT_TYPE}} \
  --configuration '{
    "aiAgentId": "{{custom-agent-id}}:{{new-version-number}}"
  }'
```

## 场景 2：没有提示覆盖的自定义 AI 代理
<a name="upgrade-models-scenario-2"></a>

在这种情况下，您创建了自定义 AI 代理来自定义设置，例如区域设置或知识库配置，但您没有覆盖任何提示类型。所有提示均按系统默认值解析。

### 自动升级
<a name="upgrade-models-scenario-2-automatic"></a>

当 Amazon Connect 发布新的系统 AI 代理和带有升级模型的提示版本时，您的自定义 AI 代理会自动获取最新的系统提示版本。无需采取行动。

这是因为未设置的提示类型是在运行时从当前系统默认值解析出来的，这些默认值始终指向最新的系统提示符版本。

### 在系统升级之前强制使用特定型号
<a name="upgrade-models-scenario-2-force-model"></a>

如果您想在 Amazon Connect 将其作为系统默认值推出之前使用较新的型号：

1. 通过复制要升级的系统提示来创建自定义 AI 提示。

1. 将模型更改为所需的新型号。

1. 发布自定义提示音。

1. 编辑您的自定义 AI 代理并将自定义提示添加到所需类型。

1. 发布 AI 代理。

这会将该提示类型转换为场景 1 的配置。

## 场景 3：更新默认 AI 代理配置
<a name="upgrade-models-scenario-3"></a>

AI 代理*概述页面上的*默认 * AI 代理配置*部分控制每个用例（答案建议、手动搜索、自助服务）中哪个 AI 代理版本处于活动状态。

创建 Amazon Connect 实例时，每个用例都会自动使用特定的系统 AI 代理版本进行配置。这些版本是固定的，当 Amazon Connect 发布新的系统 AI 代理版本或您发布新的自定义 AI 代理版本时，它们不会自动更新。必须手动选择新版本。

### 使用管理员网站升级
<a name="upgrade-models-scenario-3-admin-website"></a>

1. 导航到 * AI 代理设计器*、* AI 代理*。

1. 在*默认 AI 代理配置*部分中，找到要更新的用例（例如，答案建议）。

1. 从版本下拉列表中，选择新的 AI 代理版本。

1. 选择*保存*。

1. 为避免每次都手动更新版本，请*从版本下拉列表中选择 “*最新”。这会自动使用最近发布的 AI 代理版本。

### 使用 AWS CLI 升级
<a name="upgrade-models-scenario-3-cli"></a>

```
aws qconnect update-assistant-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-type {{AGENT_TYPE}} \
  --configuration '{
    "aiAgentId": "{{ai-agent-id}}:{{new-version-number}}"
  }'
```

替换为{{AGENT\_TYPE}}用例类型（例如`ANSWER_RECOMMENDATION`、`MANUAL_SEARCH`、`SELF_SERVICE`）。

## Summary
<a name="upgrade-models-summary"></a>


| \# | 场景 | Auto-upgrades? | 所需操作 | 
| --- | --- | --- | --- | 
| 1 | 带有自定义 AI 提示的自定义 AI 代理 | 自定义提示：否。取消提示音：是 | 编辑提示、更改模型、发布提示、更新代理、发布代理。未设置提示自动升级。 | 
| 2 | 自定义 AI 代理，无需提示覆盖 | 是 | 无需采取任何行动 | 
| 3 | 更新默认 AI 代理配置 | 未设置用例：是。明确设置：否 | 明确固定的版本：选择新版本并保存 | 

## 重要注意事项
<a name="upgrade-models-important-considerations"></a>
+ ****测试：在广泛推出变更之前，在非生产环境中测试模型升级。使用 `update-session` API 为特定会话设置 AI 代理版本。
+ **基础设施即代码：**如果您通过 CloudFormation 或管理 AI 提示和 AI 代理 AWS CDK，请更新模板中的资源属性（例如，`ModelId`打开`AWS::Wisdom::AIPrompt`）并部署堆栈。本主题中描述的提示类型行为同样适用，即在运行时将`AWS::Wisdom::AIAgent`解析中的提示类型从系统默认值中取消设置。
+ **区域可用性：**型号的可用性因 AWS 区域而异。在选择型号之前，请查看支持的型号表。有关更多信息，请参阅 [支持 system/custom 的提示型号](create-ai-prompts.md#cli-create-aiprompt)。
+ **Session-level 覆盖：在会话上设置的 ** AI 代理版本优先于助理级别的默认值，后者优先于系统默认值。如果您在会话级别设置 AI 代理版本，则还必须更新这些引用。
+ **恢复为系统默认值：**要使用管理员网站将用例切换回系统 AI 代理，请导航到 * AI 代理设计器 * A * I 代理*。在*默认 AI 代理配置*部分中，找到用例，从代理下拉列表中选择系统 AI 代理，选择所需的版本或*最新*，然后选择*保存*。使用 CLI 运行`list-ai-agents --origin SYSTEM`以查找用例类型的系统 AI 代理 ID，然后使用进行设置`update-assistant-ai-agent`。