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

# 聊天代理上下文来源和最佳实践
<a name="agent-knowledge-sources-best-practices"></a>

在 Amazon Quick 中创建自定义聊天代理时，您可以通过多种选项来影响聊天代理行为和框架聊天代理工作流程。配置聊天代理上下文和说明的方式会显著影响聊天代理的表现和对用户交互的响应。了解何时使用说明、参考文档和空间，对于创建有效的聊天代理以满足您的特定业务需求并提供一致、可靠的结果至关重要。以下各节概述了如何最好地将聊天代理上下文和知识用于您的用例。

**Topics**
+ [代理上下文的类型](#knowledge-source-types)

## 代理上下文的类型
<a name="knowledge-source-types"></a>

Amazon Quick 提供了三种不同的方法来配置聊天代理行为，每种方法在聊天代理开发中都有不同的用途。了解每种方法如何处理内容以及何时使用它们构成了有效的聊天代理配置的基础。

Amazon Quick 中提供的三种上下文类型是：
+ **角色说明** — Amazon Quick 使用生成式增强的高级指导 AI
+ **参考文档** — 提供准确说明并在聊天代理记忆中保持活跃状态的文档
+ **空间** — 可搜索的 Amazon Quick 资源和文档的集合，聊天代理可以从中检索信息来回答问题

下一节将详细介绍这些内容以及使用它们的最佳实践。

**Topics**
+ [聊天代理角色说明](#agent-instructions)
+ [聊天代理参考文档](#in-context-files)
+ [聊天代理和聊天室](#spaces)

### 聊天代理角色说明
<a name="agent-instructions"></a>

创建自定义聊天代理时，您可以在**角色说明**字段中提供聊天代理角色说明。这些角色说明使用生成式 AI 进行完善，以确保它适用于为聊天代理配置的所有聊天功能和资源。当你想让系统建立在你的基本方向上时，这种方法是理想的选择。当您使用角色说明时，Amazon Quick 使用生成式AI在后端解释和扩展您的角色指令，通过其他背景和功能来增强简单指导，优化提示以提高聊天代理性能，并通过AI以此为导向的改进来提高效率。

**使用角色说明来：**
+ 提供有关行为和目标的高级指导，Amazon Quick AI 增强了这些指导以自定义代理响应
+ 指导如何利用参考文档进行详细互动
+ 在回复中提供有关使用空格和动作连接器的一般指导

这种方法最适合通用聊天代理和探索性用例，在这些用例中，您希望从聊天代理设计AI方面的帮助中受益。

**注意**  
AI增强过程可能会修改您的原始措辞和结构，以提高聊天代理的性能。必须保持不变的关键指导方针应改为放在参考文件中。

### 聊天代理参考文档
<a name="in-context-files"></a>

参考文档提供了聊天代理需要遵循的特定流程和响应模板。这些参考文档是聊天代理永久上下文的一部分，并 hand-in-hand附有角色说明和响应风格，为其整体行为提供信息。

参考文档通过完全按照书面内容保留您的内容，从而完全控制聊天代理的行为。当精度和一致性至关重要时，这种方法是必不可少的。当您上传参考文档时，Amazon Quick 会保留精确的措辞和具体说明，保持精确的格式和结构，直接控制聊天代理行为，并确保所有互动的一致性。

**需要时使用参考文档：**
+ 精确控制必须保留精确措辞和具体说明的地方
+ 品牌与特定语气、术语或回应格式的一致性
+ 复杂的工作流程，包含多步流程，必须遵循精确的顺序
+ 行为可预测，在所有互动中都具有一致的响应

**支持的文件格式：**
+ `.pdf`, `.txt``.html`, `.md` — 说明、模板和指南
+ `.csv`— 参考数据、查询表和示例
+ `.doc`，`.docx`— 详细的流程文档

您最多可以附加 10 个总大小为 50 MB 的文件作为参考文档。Amazon Quick 从这些文档中提取文本，并在处理后应用 10 万个字符的限制。

**文件优先级和行为**  
即使用户附加了替代内容，行为框架和文件中的参考数据仍处于活动状态。
如果用户提供的格式说明相互冲突，则可以临时调整响应模板。

参考文档充当聊天代理的操作手册，提供了在用户与聊天代理的所有交互中保持不变的行为框架。

### 聊天代理和聊天室
<a name="spaces"></a>

Spaces 提供动态、可搜索的知识库，聊天代理可在对话期间查询以检索特定信息。当您将聊天室链接到聊天代理时，Amazon Quick 聊天代理会在空间中寻找答案以生成回复。Spaces 擅长管理随着时间的推移而演变的组织知识，允许多个团队成员贡献和更新信息，同时通过 Amazon Quick 的权限系统保持适当的安全边界。

使用带有聊天代理的空间用于：
+ 使聊天代理能够搜索和检索当前的业务数据
+ 为聊天代理提供对组织知识库的访问权限
+ 允许聊天代理尊重现有的权限边界
+ 将聊天代理连接到协作文档集
+ 允许聊天代理访问定期更新的信息
+ 允许聊天代理查询实时仪表板和数据集

空间充当聊天代理的动态知识层，允许实时访问组织信息，同时保持安全边界和协作工作流程。