--- schema_version: "1" id: 086d68eba7dd6676f2d30e5d4a6045f477c7daad9b29e200a051102f57d4214f title: 意图 - 可读性 collection: architect version: next locale: zh-cn portal_url: https://docs.salesforce.com/architect/next/zh-cn/well-architected-tools/guides/easy-readability.md canonical_url: https://staging.architect.salesforce.com/docs/architect/zh-cn/well-architected-tools/guide/easy-readability.html source_site: staging.architect.salesforce.com content_type: documentation content_hash: cddd3d3ad92a96f02d82aee73c889bcbb807221fa1a349862968a77bf86a2e3e products: - 设计良好的工具 - Architect Site Content Repo --- # 意图 - 可读性 ### 设计标准模式 了解有关结构良好的[易用性](/docs/architect/zh-cn/well-architected/guide/easy-overview) → [意图性](/docs/architect/zh-cn/well-architected/guide/intentional) → [可读性](/docs/architect/zh-cn/well-architected/guide/intentional#可读性) → [设计标准](/docs/architect/zh-cn/well-architected/guide/intentional#设计标准)的更多信息 | Where to look?
产品区域 \| 位置 | 好是什么样子？
模式 | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Einstein \| 客服人员 | ✅ 客服人员的语言设置与贵公司的语气相匹配 如果贵公司的语气是正式的，例如金融机构，客服人员的语气设置为“正式”。如果您的公司是非正式的，则语气设置为“随意”。否则，您的语气设置为“中性” | | Einstein \| 组织 | ✅ 提示模板利用格式化为 LLM 提供上下文 单个哈希用于将短文本块标记为提示模板上下文的单个单元 | | Einstein \| 组织 | ✅ 提示模板使用一致的写作风格 您的单词选择、格式、表情符号和标点符号在模板之间保持一致 | | Einstein \| 组织 | ✅ 提示模板简洁，易于理解和使用自然语言。模板避免使用行业术语或技术术语 | | Einstein \| 组织 | ✅ 提示模板清楚表示上下文和说明。在提示中提供上下文后，以文本“指令”开始新行，然后是三引号 ("") 括起来的指令 | | 平台 \| 业务 | ✅ 批准的 AI 模型被明确识别，并包含预期目的 | | 平台 \| 业务 | ✅ 批准的设计模式易于按用例查找和识别 | | 平台 \| 业务 | ✅ 团队知道使用（和不使用）什么工具完成工作 | | 平台 \| 组织 | ✅ 代码和声明性自定义具有一致的、人类可读的名称 | | 平台 \| 组织 | ✅ 数据模型的对象和字段名称一致、统一 | | 平台 \| 组织 | ✅ 审核显示字段在报表等中一致填写和引用。 | ### 文档模式 了解有关结构良好的[易用性](/docs/architect/zh-cn/well-architected/guide/easy-overview)的更多信息 → [意图](/docs/architect/zh-cn/well-architected/guide/intentional) → [可读性](/docs/architect/zh-cn/well-architected/guide/intentional#可读性) → [文档](/docs/architect/zh-cn/well-architected/guide/intentional#文档) | Where to look?
产品区域 \| 位置 | 好是什么样子？
模式 | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | Data 360 \| 文档 | ✅ 源系统在数据字典中清点 Data 360 数据源在解决方案设计过程中使用包含源和目标系统以及两者之间字段映射的数据字典进行记录 | | 平台 \| 业务 | ✅ 所有解决方案都有业务功能和技术实施详细信息的图表 | | 平台 \| 业务 | ✅ 为代码和声明性自定义设置关键人员/时间/信息日志 | | 平台 \| 业务 | ✅ 人员可以搜索和查找相关文档 | | 平台 \| 组织 | ✅ 代码和声明性自定义有清晰的描述 | --- ### 设计标准反模式 了解有关结构良好的[易用性](/docs/architect/zh-cn/well-architected/guide/easy-overview) → [意图性](/docs/architect/zh-cn/well-architected/guide/intentional) → [可读性](/docs/architect/zh-cn/well-architected/guide/intentional#可读性) → [设计标准](/docs/architect/zh-cn/well-architected/guide/intentional#设计标准)的更多信息 | Where to look?
产品区域 \| 位置 | 要避免什么？
反模式 | | ---------------------------------- | -------------------------------------------------------------------------------------- | | Einstein \| 提示模板 | 提示模板使用行话和/或技术术语 提示模板包括行话、缩写词和技术术语，而不是简洁的自然语言 | | 平台 \| 业务 | 批准的 AI 模型不明确，预期目的不明确 | | 平台 \| 业务 | 团队使用许多不同的工具完成类似的工作 | | 平台 \| 业务 | ⚠ 没有批准的设计模式 | | 平台 \| 业务 | ⚠ 供应商或新员工入职需要大量时间 | | 平台 \| 组织 | ⚏ 代码和声明性自定义名称不一致 | | 平台 \| 组织 | 数据模型的名称不一致，许多对象和字段似乎多余 | | 平台 \| 组织 | 审计显示许多未使用的字段或各种使用情况级别，并且没有与报告等一致的链接。 | ### 文档反模式 了解有关结构良好的[易用性](/docs/architect/zh-cn/well-architected/guide/easy-overview)的更多信息 → [意图](/docs/architect/zh-cn/well-architected/guide/intentional) → [可读性](/docs/architect/zh-cn/well-architected/guide/intentional#可读性) → [文档](/docs/architect/zh-cn/well-architected/guide/intentional#文档) | Where to look?
产品区域 \| 位置 | 要避免什么？
反模式 | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------- | | Data 360 \| 组织 | ⚏ 源到目标的映射仅在数据映射画布中记录 数据源字段在 Data 360 的数据映射画布中配置期间动态映射到数据模型对象字段 | | 平台 \| 业务 | 解决方案的内容/方式/原因很难找到，并且可能对大多数团队不可用 | | 平台 \| 业务 | 人们很难理解解决方案和他们正在使用的系统 | | 平台 \| 业务 | ⚠ 供应商或新员工入职需要大量时间 | | 平台 \| 组织 | ⚏ 代码和声明性自定义没有描述，有难以理解的描述，或者有似乎与自定义的实际功能不匹配的描述 | ---