AI 场景

场景位于 /ai/scenarios。查看需要查看权限，创建和修改需要管理权限；缺少相应权限时，卡片会保持不可用或只读。

场景契约

设置稳定的 key、名称、说明、分类、enabled、useCase（text_improve、text_fix、json_analysis、custom）、outputMode（text 或 json）、systemPrompt、userPromptTemplate、tags 和可选的 responseSchema。可以绑定 connectionId，也可以使用默认连接。

场景限制包括 maxPromptChars、maxOutputChars、maxContextChars、requestTimeoutMs 和 overflowMode（reject/truncate）。不要在不了解后果时关闭系统指令：disableSystemPrompt=true 后只剩用户模板。

测试

在 AI 沙盒用合成示例测试场景。对 JSON 检查 schema 是有效对象、必填字段确有必要且工作表单能处理响应。测试长输入、timeout、没有连接和部分加载列表。旧场景应设为 enabled=false，不要复用其 key。

表单与编辑冲突

创建或编辑必须填写 key 和名称。填写 responseSchema 时必须是 JSON 对象；tags 用逗号分隔输入。场景弹窗中的刷新会重新读取最近保存的场景数据，并在记录已删除或找不到时发出提示。场景关联连接时，可以从表单打开连接卡片；停用会保留记录并将 enabled 设为 false。

安全

Prompt 不应要求密码、token、多余个人数据、合同金额或其他客户的文件。会修改 CRM、任务、日历或文档的场景必须再由人确认。说明中应写明负责人、允许的 context 和完成标准。

如果场景无法加载、无法运行或返回空结果，请显示原因并重新检查设置，不要把空结果当作成功。演示使用合成数据，不显示金额或密钥，并检查界面语言下的标签。

相关：AI 沙盒、连接、AI 与 Assistant 设置。