AI Engineering Tools

生成式 AI 工程

AI 提示管理与运营术语

了解如何注册、版本控制、配置、批准、部署、跟踪、回滚和停用在生产 AI 系统中使用的提示。

16 个术语

资产和注册表

提示资源

Prompt asset

含义

一个提示及其相关的元数据、变量、示例、配置、测试以及所有权信息。

使用场景

将生产环境中的提示视为受管的应用资产,而不是匿名复制的文本。

应用示例

资产包括模板、模式、所有者、模型绑定、测试套件、风险级别和发布说明。

资产和注册表

提示注册表或存储库

Prompt registry or store

含义

一个受控的目录,其中可以发现、版本控制、比较和检索提示资产。

使用场景

使用它来防止生产提示分散在源代码文件、文档和个人笔记中。

应用示例

按照用例、所有者、状态、模型系列和环境搜索注册表。

资产和注册表

提示 ID

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、不可变版本和内容摘要标识评估或请求所使用的确切资源。
模型、参数、模式、工具和变量合约使行为可重复,并暴露兼容性要求。
所有者、审批人、测试证据、环境和发布时间展示权威、准备状态和运营责任。
跟踪策略、监控阈值和回滚目标支持事件检测、诊断和恢复。

常见问题

为什么不将提示只保留在应用程序源代码中?

源代码控制很有用,但生产操作还需要特定于提示的元数据、评估证据、批准、环境推广、请求跟踪、所有权、弃用和回滚链接。 这些可以围绕代码构建,也可以由提示注册表提供。

提示版本是否应包含模型设置?

至少,记录可以改变行为的设置和依赖项,例如模型版本、支持的参数、输出模式、工具定义和变量合约。 它们是否共享一个版本号是一个实现选择,但确切的组合必须是可重现的。

应该将哪些信息不存储在提示跟踪中?

不要保留不必要的个人数据、凭据、密钥信息、机密源代码或未受版权保护的内容。应应用目的限制、删除、访问控制、保留期限、删除以及法律或合同要求。

官方参考资料