简短需求可以是很好的起点，但不一定是完整的执行契约。自然语言增强会在不替换用户原话的前提下补充结构。

当请求中包含可识别的信号时，引擎会把它们编入结构化要求，包括输出格式、硬约束、受众、运行环境、证据和成功标准；只有缺失信息会阻止可靠推进时，才提出澄清问题。

01

保留原始请求

原始输入始终可见，并逐字包含在增强提示词中。

02

补充执行细节

补充约束、边界情况、假设和可落地的推进方式。

03

让完成可检查

要求输出可检查、可验证，避免没有证据的“已经完成”。

原始请求：帮我为团队设计一个小型 API

增强提示词（节选）：
# 执行要求
- 保持兼容性，并覆盖错误路径和边界情况。
# 输出要求
- 提供可运行代码，并附带验证步骤。
# 完成标准
- 让结果可检查、可复现。

真实场景

同一套引擎，覆盖不同类型的工作。

增强器会根据 profile 补充不同的执行重点，同时保持相同的安全契约； 它不会把所有请求套进同一种模板。

规划 帮我规划一个小型 API 会补充里程碑、依赖、风险、负责人和完成信号。
编码 修复这个接口 会补充兼容性边界、错误路径、可运行修改和验证方式。
研究 比较两种方案 会补充来源要求、不确定性、权衡和有证据支持的结论。

运行预览

无需账号或 API Key 即可体验。

可以直接打开浏览器 Prompt Lab，也可以运行已发布容器，获得能够在其他机器复现的终端记录。

打开浏览器 Prompt Lab 分享验证结果

本地结果出现后，可以使用复制证据或下载证据，再把 JSON 放入可选的 Usage Report 表单。也可以使用复制分享链接，让其他浏览器复现同一个输入、任务类型和语言。分享前请检查原始请求，因为链接片段包含输入文本。文件不包含 provider 密钥。

docker run --rm ghcr.io/happy520ai/unified-ai-system/ai-gateway-service:0.5.0 pnpm --silent gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --json

成功预览会报告 providerCalled=false、credentialRequired=false 和 deterministic=true。它只使用本地 fake provider，不会调用真实 provider。

HTTP 与 SDK

在自己的工作流中复用同一份契约。

增强接口不会触发 provider。它返回原始请求、增强提示词、识别出的 profile 和语言、澄清问题以及安全元数据。 

curl --request POST http://127.0.0.1:3100/prompts/enhance \
  --header "content-type: application/json" \
  --data '{
    "input": "帮我为团队设计一个小型 API",
    "profile": "coding",
    "language": "zh-CN"
  }'

同一接口也可以通过 shared SDK 使用。聊天增强是显式 opt-in，因此升级网关不会悄悄改变已有的 /chat 行为。 

pnpm gateway serve
node docs/examples/shared-sdk-prompt-enhancement.mjs "帮我为团队设计一个小型 API" --profile coding --language zh-CN

可以查看可运行的 Shared SDK 示例，其中包含无需 provider 的就绪状态和元数据校验。

如果不想启动网关，也可以运行本地回环取消示例，查看调用方取消与 SDK TimeoutError 原因的区别。

在 auto 模式下，Please answer in Chinese 或请用英文回答这类明确的输出语言要求会优先于字符比例检测； 如果 API 或 CLI 已传入 language，仍以显式参数为准。

Profilesgeneral、coding、analysis、writing、research、planning
语言auto、zh-CN、en
输入上限20,000 个字符

MCP / CODEX / IDE

把增强能力作为受治理工具暴露出去。

已发布 MCP Server 暴露 gateway_prompt_enhance，同时提供健康、就绪、聊天、知识、工作流和 workforce 工具。将固定版本容器接入 Codex、Cursor 或 Cline 后，先检查工具列表，再发起调用。

输入自然语言需求
网关Profile / 语言 / 策略
输出可检查的增强提示词
下一步人或模型执行

具体接入方式请阅读 Codex MCP Docker 中文快速开始，其中包含固定镜像和九工具验证路径。

安全与治理

结构更清晰，不等于承诺更聪明。

这是确定性的启发式转换。它改善一致性和可检查性，但不保证每个模型或任务都会因此表现更好。

会做什么保留输入、补充结构、报告元数据，并提出有限的澄清问题。
不会做什么调用 provider、编造执行结果，或开启真实 provider 访问。
仍然需要明确授权、模型判断，以及独立证据来支持生产级结论。

生产就绪、L5 自主和 AGI 不能由这次预览证明。项目明确写出这些边界，因为可信赖的网关也应该让自己的限制可见。