smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# MCP 能力契约
|
||
|
||
## 基本信息
|
||
|
||
| 字段 | 内容 |
|
||
|---|---|
|
||
| 服务名称 | `<名称>` |
|
||
| 接入目的 | `<要解决的外部事实或操作>` |
|
||
| 适用场景 | `<何时允许使用>` |
|
||
| 不适用场景 | `<何时不得使用>` |
|
||
| 来源依据 | `<接口文档、系统规范或已验证记录>` |
|
||
|
||
## 工具清单
|
||
|
||
| 工具 | 用途 | 输入契约 | 输出契约 | 副作用 | 权限与确认 | 错误语义 | 审计与脱敏 |
|
||
|---|---|---|---|---|---|---|---|
|
||
| `<tool>` | `<用途>` | `<必填、格式、范围>` | `<字段、时效、空值>` | `只读 / 可逆写入 / 不可逆` | `<调用资格与确认>` | `<鉴权、限流、超时等>` | `<留痕字段与脱敏规则>` |
|
||
|
||
## Agent 绑定边界
|
||
|
||
- 允许调用的自定义 Agent：`<名称或角色>`。
|
||
- 不允许调用的 Agent：`<名称或角色>`。
|
||
- Agent 调用前必须具备的运行时事实：`<数据范围、目标对象、确认信息>`。
|
||
- Agent 调用后必须输出：`<来源、时间、结果、失败或待确认>`。
|
||
|
||
## 停止与降级
|
||
|
||
| 情况 | MCP 或 Agent 的行为 |
|
||
|---|---|
|
||
| 缺少关键输入 | 拒绝调用并列出字段缺口 |
|
||
| 鉴权或数据范围不满足 | 拒绝调用，不尝试扩大权限 |
|
||
| 限流、超时或服务不可用 | 区分故障类型，标记外部事实未取得 |
|
||
| 有副作用但未确认 | 停止并请求确认 |
|
||
| 返回敏感信息 | 按规则脱敏，避免写入任务记录或日志 |
|