AI 沙盒
沙盒位于 /ai/playground(也可在 /ai 打开 playground 标签)。在把请求交给工作流程前,先在这里验证它。只有获准运行 AI 的用户可以使用;当 canRunRequests 为 false 时不显示该标签。
可验证的内容
- 普通 completion 或选定场景的执行;
- 文本或 JSON 响应;
template、messages、hybrid输入模式;- 可选连接或模块默认连接;
- JSON context 和流式响应;
- 文本改写、摘要和 JSON 分析的匿名预设。
在消息模式中至少添加一条用户或助手消息。启动前修正空字段、无效 JSON 和未知场景。
请求如何组成
模板模式填写 prompt 和可选 context。消息模式添加非空的用户或助手消息列表。混合模式结合 prompt、context 和消息。场景使用其模式对应的字段;场景支持流式响应。运行前检查所有可见表单字段。
/ai/playground 没有 @ 选择器:其中的 prompt、消息和 JSON 上下文都由用户手动输入。请在 /chat/:conversationId 的直接 Assistant 聊天中检查提及上下文:只使用合成的 Anna Test Employee 和 CRM 商机 Rebranding — demo,从 @ 建议中选择人员,不要手动输入姓名,并只发送只读请求。在 UI 修复前,直接 Assistant 分支中的已选提及可能只作为普通文本保存而没有 ID,因此近期上下文中的 @Display Name 尚未得到证明。禁止 raw ID、{}、mock_default、mock-v1 和原始 JSON,以及真实实体;公开截图或行为声明必须等待前端回归、部署以及无变更的可读显示名证据。
限制与溢出
检查可见的输入、输出和 context 限制、超时时间、结果格式及超限行为。选择“拒绝”时,过大的请求不会运行;选择“截断”时,界面应明确提示部分 context 已缩短。
流式响应中区分开始、中间文本、完成、停止和错误。完成前的中间文本不是已确认结果。如果错误显示的是技术性服务器或传输文本,而非本地化说明,请不要复制或发布:它不是用于决策或证据的安全原因。记录路由和时间,再向门户负责人说明情况,但不要附上错误内容;不要盲目再次运行请求。
阅读结果面板
右侧面板显示状态、延迟、所选连接与模型、输入模式以及截断提示。检查文本或 JSON 结果;流式响应完成后再使用。
访问与权限
运行 AI 的权限不等于修改连接或场景的权限。没有运行权限时,Playground 标签会隐藏;不提供绕过限制的方式。
安全
使用合成姓名、金额和记录。不要粘贴 key、密码、支付信息、个人数据或私有文件。沙盒只生成草稿;金额应在源系统中核对。
保存结果前的检查
- 确认选择了正确的场景和连接。
- 检查限制、格式以及是否发生截断。
- 对照原始 context 核对事实、姓名、日期和承诺。
- 将已确认的结果转入任务、CRM 或文档;AI 响应本身不是决定。