资产和注册表
提示资源
Prompt asset
含义
一个提示及其相关的元数据、变量、示例、配置、测试以及所有权信息。
使用场景
将生产环境中的提示视为受管的应用资产,而不是匿名复制的文本。
应用示例
资产包括模板、模式、所有者、模型绑定、测试套件、风险级别和发布说明。生成式 AI 工程
了解如何注册、版本控制、配置、批准、部署、跟踪、回滚和停用在生产 AI 系统中使用的提示。
16 个术语
资产和注册表
Prompt asset
一个提示及其相关的元数据、变量、示例、配置、测试以及所有权信息。
将生产环境中的提示视为受管的应用资产,而不是匿名复制的文本。
资产包括模板、模式、所有者、模型绑定、测试套件、风险级别和发布说明。资产和注册表
Prompt registry or store
一个受控的目录,其中可以发现、版本控制、比较和检索提示资产。
使用它来防止生产提示分散在源代码文件、文档和个人笔记中。
按照用例、所有者、状态、模型系列和环境搜索注册表。资产和注册表
Prompt ID
逻辑提示在不同版本中的稳定标识符。
在代码、遥测和审批中使用,版本标识确切的内容。
prompt_id: support.case_summary版本生命周期
Prompt version
一个可识别的提示内容和相关配置的修订版本。
使用不可变的版本,以实现可重复的评估、部署、事件和回滚。
support.case_summary@17,内容摘要的 sha256 值为:...版本生命周期
Draft and published version
一个可修改的工作版本,与可供应用程序使用的已批准的不可修改版本形成对比。
使用草稿进行迭代,仅在通过所有必要的测试和审批后才发布。
草稿 18 仍然可以编辑;生产环境继续引用已发布的版本 17。配置
Prompt variable
一个命名占位符,在运行时用特定于请求的数据填充。
定义每个变量的类型、必需字段、转义、长度限制和信任级别。
除非经过批准的设计明确要求并保护,否则不要将密钥信息放在提示变量中。
Summarize {{case_notes}} for {{audience}} using {{output_schema}}.配置
Prompt configuration
与提示相关的模型、推理参数、工具定义、输出模式和其他设置。
可以显著改变行为的版本设置,以及提示文本。
配置:模型系列,温度,最大输出,模式版本,已启用工具,超时时间。配置
Model binding
声明的模型或模型系列,用于设计和测试提示版本。
使用它来防止未经测试的模型迁移在静默状态下改变行为。
提示 v17 已批准用于模型系列 A 的 2026-05 版本。发送
Environment promotion
将已批准的提示版本在开发、测试和生产环境中进行部署。
推广使用相同的不可变版本,而不是手动在不同环境之间复制文本。
dev -> evaluation passed -> staging approval -> production发送
Prompt deployment
使选定的提示版本和配置可用于应用程序或工作流程。
通过标识符进行部署,并进行健康检查、可观察性,以及记录的恢复路径。
将 `support.case_summary@17` 部署到 10% 的符合条件的流量中,然后监控发布指标。发送
Prompt rollback
在发现问题后,将流量恢复到先前批准的提示版本。
在生产发布之前,准备并演练回滚操作。
如果必需字段的准确性低于阈值,请恢复版本 16,而不要进行任何修改。治理
Prompt change approval
一种记录的审查决策,授权特定用途和环境下的提示版本。
对外部可见、受监管、财务或安全相关的行为,需要进行相应的批准。
批准记录包含审查者、范围、证据、限制、版本和到期日期。治理
Prompt ownership
分配质量、访问、审查、事件、更新和提示退役的责任。
在将提示用于生产环境之前,分配服务所有者和备份人员。
所有者:支持平台;审核人:合规部门;下次审核:2026-10-01。治理
Prompt audit log
提示更改、批准、部署、访问和回滚的防篡改历史记录。
用于调查事件,并演示谁在何时更改了什么以及原因。
记录参与者、时间戳、提示 ID、版本(之前和之后)、操作、工单和环境。可观察性
Prompt trace
记录请求级别的元数据,包含提示版本、输入、模型配置、工具活动、输出和评估信号。
用于调试和性能分析,并采用适当的最小化和访问控制。
跟踪可能会捕获个人、机密或受版权保护的材料;根据需要,对其进行最小化、脱敏、限制和过期。
trace_id 链接到 prompt v17,已屏蔽的输入,模型版本,延迟,token 使用情况和验证器结果。版本生命周期
Prompt deprecation
将提示版本或资产标记为已计划停止使用,不再建议用于新用途。
发布迁移指南,识别用户,设置截止日期,并在删除之前保留回滚证据。
在 8 月 1 日停止 v12 的使用,将剩余的调用方迁移到 v17,并归档其评估记录。| 记录 | 为什么这很重要 |
|---|---|
| 提示 ID、不可变版本和内容摘要 | 标识评估或请求所使用的确切资源。 |
| 模型、参数、模式、工具和变量合约 | 使行为可重复,并暴露兼容性要求。 |
| 所有者、审批人、测试证据、环境和发布时间 | 展示权威、准备状态和运营责任。 |
| 跟踪策略、监控阈值和回滚目标 | 支持事件检测、诊断和恢复。 |
源代码控制很有用,但生产操作还需要特定于提示的元数据、评估证据、批准、环境推广、请求跟踪、所有权、弃用和回滚链接。 这些可以围绕代码构建,也可以由提示注册表提供。
至少,记录可以改变行为的设置和依赖项,例如模型版本、支持的参数、输出模式、工具定义和变量合约。 它们是否共享一个版本号是一个实现选择,但确切的组合必须是可重现的。
不要保留不必要的个人数据、凭据、密钥信息、机密源代码或未受版权保护的内容。应应用目的限制、删除、访问控制、保留期限、删除以及法律或合同要求。
关于可重用提示、变量、变体、测试、版本和应用程序集成的官方指南。
创建和列出管理提示版本的官方 API 参考。
构建角色、说明、示例、约束、可重用模板和输出规范。
在批准和推广版本之前,生成评估证据。
在部署后,跟踪系统质量、回归、人工审查、延迟和成本。
应用隐私、访问控制、注入防御、安全措施、审核和红队控制。