Judikt团队打造：基于MCP的AI智能体安全与可靠性控制平面

本指南将重新梳理从原材料到可运行系统的完整流程，适用于项目《I Built Judikt：基于MCP的AI智能体安全与可靠性控制平面》。重点在于可操作的步骤、明确的检查点，以及可直接放入代码仓库的代码，无需猜测其用途。 在修改代码之前，应先明确输入参数、各步骤的负责人以及完成标准。操作人员应能够从已知的检查点重新运行相应步骤，而无需推测隐藏状态。 需同时记录正常流程与异常恢复流程。重试机制、人工审核环节以及错误处理都是产品不可或缺的部分，而非后续需要补充的功能。

什么是Judikt？

在研究“什么是Judikt？”时，首先写下相关契约：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 优先选择小型且可测试的单元，而非庞大的脚本。当某个步骤失败时，故障应能指向单一的责任模块，而非复杂的流程链。 为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理循环将会浪费大量时间。

你想要解决的问题

在处理需要解决的问题时，首先写下相关契约：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 将这一阶段视为输入与验证后输出之间的契约。为相关产物命名，明确成功判定标准，杜绝无声的半完成状态。 每次调用时都要记录工具名称、参数哈希值、延迟时间以及执行结果。没有这些记录，调试过程将会浪费大量时间。

请求在 Judikt 中的处理流程

在研究请求如何在 Judikt 中流转时，首先需列出相关规范：所需输入、成功信号以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 在功能结果旁记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外费用。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试循环将会耗费大量时间。

AI agent or MCP client
        |
        v
Authentication and actor binding
        |
        v
Tool allowlist and argument inspection
        |
        v
Risk scoring and environment checks
        |
        v
Rate limit, approval, rollback plan, kill switch
        |
        +---- DENY / REQUIRE_APPROVAL / DRY_RUN_ONLY
        |
        v
Pinned MCP tool-definition verification
        |
        v
JSON-RPC tools/call over stdio or Streamable HTTP
        |
        v
Operational backend or external MCP server
        |
        v
Prompt-injection inspection and secret redaction
        |
        v
Agent-visible result
        |
        v
Signed audit event, metrics, traces, and findings

在研究请求如何在 Judikt 中流转时，首先需列出相关规范：所需输入、成功信号以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 需同时记录正常流程与异常恢复流程。重试机制、人工审核环节以及死信处理都是产品功能的一部分，而非后续需要补充的内容。

本地演示中实际运行的内容

在处理本地演示中的实际运行内容时，将其视为可测量的对象最为有效。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。 应优先选择小型且可测试的单元，而非庞大的脚本。当某个步骤失败时，故障应指向单一的责任模块，而非复杂的流程链。 需使用结构明确的工具，并标注清晰的副作用信息。主机在自动批准之前必须知道哪些调用会修改状态。

runtime.call_tool(
    "platform-ops",
    "platform.health",
    {"service": "payments-api"},
)

python -m judikt.cli backend platform-ops

JudiktRuntime.call_tool
  -> PolicyEngine.evaluate
  -> StdioMCPClient.call_tool
  -> JSON-RPC tools/call
  -> PlatformOpsBackend.call
  -> ContentGuard.inspect
  -> PolicyEngine.redact
  -> AuditStore.record
  -> Metrics.observe
  -> ToolCallResult

运营后端系统

将运行后端视为可度量的对象时，其功能表现最为优异。在扩大范围之前，先记录一份理想的处理结果、一个故障案例以及回滚说明。 将此阶段视为输入与经过验证的输出之间的契约。为相关成果命名，明确成功标准，绝不允许默默地完成部分任务。 提供具有严格结构定义和明确副作用标注的工具。主机需要在自动批准之前知道哪些调用会改变状态。

请求端治理

将请求端治理视为可度量的对象时，其效果最佳。在扩大范围之前，先记录一份标准操作示例、一个故障案例以及回滚说明。 在功能结果旁同时记录处理时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外账单。 提供具有明确结构规范和清晰副作用标注的工具。主机需要在自动批准之前知道哪些调用会改变状态。 将请求端治理视为可度量的对象时，其效果最佳。在扩大范围之前，先记录一份标准操作示例、一个故障案例以及回滚说明。 需同时记录正常流程和恢复流程。重试机制、人工审核环节以及死信处理都是产品的一部分，而非后续需要补充的功能。

需审批的修复措施

对于需要审批的修复工作，在修改代码之前应明确输入参数、该步骤的负责人以及完成标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。相比庞大的脚本，更应采用小型且可测试的单元。当某个步骤失败时，故障原因应能明确指向某个具体责任方，而非整个复杂的流程。应在网关处进行身份验证，在数据层再次授权——仅凭承载令牌并不能作为租户边界。

模拟运行、影子模式与紧急停止功能

对于试运行、影子模式和终止机制，应在修改代码之前明确输入参数、该步骤的负责人以及退出标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 将此阶段视为输入与已验证输出之间的契约。为相关成果命名，定义成功判定标准，并拒绝默许的半完成状态。 在网关处进行身份验证，在数据层再次授权。仅凭承载令牌并不足以界定租户边界。

保护响应路径

为保障响应路径的安全，在修改代码之前需明确输入参数、该步骤的负责人以及终止条件。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。应在功能结果旁记录执行时间以及令牌或查询成本。提前了解这些成本信息，可避免在路径从演示环境切换到共享环境时出现意外费用。

内容屏蔽与机密信息

在处理数据掩码与机密信息时，首先需写明相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改始终符合约定。 建议采用小型、可测试的单元而非庞大的脚本。当某个步骤失败时，故障应能指向单一责任模块，而非复杂的流程链。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理将陷入无休止的循环，耗费大量时间。

可验证的防篡改审计证据

在处理防篡改的审计证据时，首先写下合同条款：所需的输入参数、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持透明可追溯。 将这一阶段视为输入与已验证输出之间的契约。为相关成果命名，明确成功判定标准，杜绝无声的半完成状态。 需记录每次调用的工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

可观测性

在处理可观测性相关问题时，首先需明确规范：所需的输入参数、成功标志以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 在功能结果旁记录执行时间以及令牌或查询成本。提前了解成本情况，可避免从演示环境过渡到共享环境时出现意外费用。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理的循环操作会浪费大量时间。 在处理可观测性相关问题时，首先需明确规范：所需的输入参数、成功标志以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 需同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及死信处理都是产品功能的一部分，而非后续需要补充的内容。

演示内容涵盖哪些方面

该演示所涵盖的内容，若将其视为可度量的界面来处理效果最佳。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。 相较于庞大的脚本，应优先选择小型且可测试的单元。当某一步骤失败时，故障应指向单一责任模块，而非复杂的流程链。 需使用结构清晰、带有明确副作用标注的工具。主机在自动批准之前，必须知道哪些调用会改变状态。

部署选项

将部署选项视为可度量的指标会更有助于其有效运用。在扩大范围之前，先记录一份理想的运行日志、一个故障案例以及回滚说明。 把这一阶段视为输入与已验证输出之间的契约。为相关成果命名，明确成功标准，绝不允许默许不完整的处理结果。 使用结构严谨的工具，并标注明确的副作用信息。主机需要在自动批准之前知晓哪些操作会改变系统状态。

测试与安全验证

将测试与安全验证视为可度量的对象，才能发挥最佳效果。在扩大范围之前，先记录一份理想状态下的操作日志、一个故障案例以及回滚说明。在功能结果旁同时记录执行时间以及令牌或查询成本。提前了解这些成本，可避免在系统从演示环境过渡到共享环境时出现意外费用。应提供具有明确结构规范和清晰副作用标注的工具，这样主机才能在自动批准之前知道哪些调用会改变系统状态。将测试与安全验证视为可度量的对象，才能发挥最佳效果。在扩大范围之前，先记录一份理想状态下的操作日志、一个故障案例以及回滚说明。需同时记录正常流程与恢复流程的文档，重试机制、人工审核环节以及死信处理都是产品本身的组成部分，而非后续需要补充的内容。

尚未解决的问题

对于尚未解决的问题，在修改代码之前需明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。相比冗长的脚本，更应采用小型且可测试的单元。当某个步骤失败时，故障原因应能指向单一责任主体，而非复杂的流程链。应在网关处进行身份验证，在数据层再次授权——仅凭承载令牌并不能界定租户边界。

你学到了什么

针对所学内容，在修改代码之前需明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 将此阶段视为输入与已验证输出之间的契约。为相关成果命名，定义成功判定标准，杜绝默许的半完成状态。 在网关处进行身份验证，在数据层再次授权。仅凭承载令牌并不足以界定租户边界。

尝试该项目

在修改代码之前，为“试用项目”明确输入参数、各步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 在功能结果旁记录执行时间以及令牌或查询成本。提前显示成本可避免在从演示环境过渡到共享环境时出现意外费用。 在网关处进行身份验证，在数据层面重新授权。仅凭承载令牌并不足以界定租户边界。

git clone https://github.com/gaurav-gs7/Judikt.git
cd Judikt
./scripts/run_demo.sh --audit-db /tmp/judikt-demo.db

在修改代码之前，为“试用项目”明确输入参数、各步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及死信处理都是产品的一部分，而非后续需要补充的功能。

运营检查清单

将操作检查表视为可度量的基准，才能发挥最佳作用。在扩大范围之前，先记录一份完美的操作日志、一个故障案例以及回滚说明。

将配置与应用程序代码分开。环境文件、密钥存储和功能开关应集中存放，以便操作人员无需查看全部内容即可进行审计。

提供具有明确结构定义和清晰副作用标注的工具。主机需要在自动批准之前知道哪些调用会修改状态。

对于涉及资金支出或更改生产数据的操作，必须经过人工审批。编译时的连接方式并不等同于业务上的完整性。

编写简短的操作手册：说明如何轮换密钥、如何清空队列、以及如何回滚上一次的数据导入操作。

将此阶段视为输入与经过验证的输出之间的契约。为相关成果命名，明确成功标准，杜绝默许的半完成状态。

在推广该技术栈之前，应先冻结版本，为关键流程记录标准输出日志，并明确回滚步骤。共享环境需要设置速率限制、租户验证机制，以及负责密钥轮换的明确责任人。与其展示花哨的一次性演示，不如注重扎实的可靠性。

关于2580b5835abc的批注：请将提供商密钥移出代码仓库，设定单会话令牌上限，并将日志存储在评估用示例文件旁，以便后续模型更换时仍能保持数据可比性。