企业智能体工程体系v1.1｜ 企业智能体工程卷 · 第0期·企业公民——Agent 是同事，不是工具

#企业智能体工程体系v1.1｜ 企业智能体工程卷 · 第0期

企业公民——Agent 是同事，不是工具

作者：技术治理研究组
系列：企业智能体工程卷（发布版 v1.1）
主案例：CASE-CR-0042（信用提额申请）
适合读者：架构师、技术负责人、AI 产品经理、企业数字化转型决策者

📌 本文档声明

摘要

当智能体进入企业，它会做决策、跨系统操作、与其他 Agent 协作。此时，它不再是“工具”，而是一个需要被治理的“企业公民”。

本文是企业智能体工程卷的开篇，回答三个核心问题：

全文围绕「星河零售」信用提额申请案例展开，建立了 Identity、SkillContract、DecisionRecord、MemoryItem、AuditEvent 等核心对象模型，为后续 9 期内容提供统一的概念基底。

一句话核心：工具观收获失控自动化；公民观才可能收获靠谱同事。

0. 建议预备知识清单

开始本卷前，建议具备下列基础。不必样样精通，知道“是什么、为什么重要”即可。

0.1 必备知识

0.2 加分知识

0.3 本卷用词约定

1. 从“AI 只是工具”的错觉说起

1.1 工具观的局限

过去两年，我们把智能体当成“更聪明的宏脚本”：给一个任务，出一个结果。这种模式在单步、无状态、低风险的场景中足够用。

但当 Agent 开始 做决策、跨系统操作、长时间执行任务、与其他 Agent 协作 时，“工具”心智会全面失灵：

1.2 从“工具”到“公民”的心智升级

核心论断：工具观收获失控自动化；公民观才可能收获靠谱同事。

2. 主案例开场：CASE-CR-0042

全卷只演这一出戏，每一期都在它上面“加一层”。请先熟悉这张工单：

红线规则（全卷有效）

阅读任何一期，都默认你已经知道这张工单的背景。

3. 总架构与对象模型

3.1 核心数据流

T-CR-0042 请求
↓
Identity ← 谁在行动（第0期）
↓
SkillContract ← 允不允许这项能力（第1期）
↓
ToolSpec ← 怎么调用、有何副作用（第4期）
↓
DecisionRecord ← 本环节结论，只追加（第2-3期）
↓
MemoryItem? ← 是否写入受治理记忆（第7期）
↓
AuditEvent ← 全程可追溯（贯穿全卷）

变更路径:
Flywheel.Plan → AssuranceReport → 发布 / 打回 / 回滚（第5、8期）

多角色协作:
PermissionMatrix ← 约束横向访问（第9期）

3.2 核心对象一览

后文代码与表格都使用这些名字，避免每期换一套词。

4. 企业公民的三权利与三义务

4.1 权利

4.2 义务

5. CASE-CR-0042 的三份公民档案

以下是三个 Agent 在企业中的“公民档案”——它们的身份、契约、记忆和协作关系。

5.1 档案一：客服 Agent（support.intake）

agent.support.intake
├── 契约
│ ├── 允许: 建单、澄清客户信息、转交工单
│ └── 禁止: 直接修改额度、裁决申请
├── 记忆
│ ├── 允许: 会话摘要（工单编号、客户诉求）
│ └── 禁止: 证件号、详细收入等强身份信息
└── 协作
└── 信息收集齐备 → 转交给 data.credit

5.2 档案二：数据 Agent（data.credit）

agent.data.credit
├── 契约
│ ├── 允许: 只读查询信用快照、财务报表
│ └── 禁止: 裁决额度、写入业务系统
├── 记忆
│ ├── 允许: 查询键、时间戳、快照摘要
│ └── 禁止: 原始证件字段落长程记忆
└── 协作
└── 快照就绪 → 转交给 finance.limit

5.3 档案三：财务 Agent（finance.limit）

agent.finance.limit
├── 契约
│ ├── 允许: 提额提议/裁决（受阈值与四轴约束）
│ └── 禁止: 绕过四轴直接通过
├── 记忆
│ ├── 允许: 裁决摘要 + 依据编号
│ └── 禁止: 存储可反推个人隐私的完整数据
└── 协作
└── 拒绝或需补件 → 回 support.intake 补充信息

5.4 工具观 vs 公民观：事件对比

6. 最小代码：Identity + AuditEvent

以下为教学级示意代码，展示本期的两个核心对象：Identity（身份）和 AuditEvent（审计事件）。

from __future__ import annotations

from dataclasses import dataclass, field
from datetime import datetime, timezone
from typing import Any

@dataclass(frozen=True)
class Identity:
"""Agent 的唯一身份标识。

每个 Agent 实例拥有一个不可变的身份，
用于所有审计和权限校验。
"""
agent_id: str
role: str
version: str = "v1"

def urn(self) –> str:
"""生成统一资源名称，用于全链路追溯。"""
return f"agent://{self.role}/{self.version}/{self.agent_id}"

@dataclass
class AuditEvent:
"""不可变的审计事件记录。"""
at: str # ISO 时间戳
agent_urn: str # 执行者的 URN
case_id: str # 关联案例编号
action: str # 操作名称
ok: bool # 是否成功
detail: dict[str, Any] = field(default_factory=dict) # 补充细节

class AuditLog:
"""审计日志——只追加，不修改，不删除。"""

def __init__(self) –> None:
self.events: list[AuditEvent] = []

def record(
self,
agent: Identity,
case_id: str,
action: str,
ok: bool,
**detail: Any,
) –> None:
"""记录一条审计事件。"""
self.events.append(
AuditEvent(
at=datetime.now(timezone.utc).isoformat(),
agent_urn=agent.urn(),
case_id=case_id,
action=action,
ok=ok,
detail=detail,
)
)

def for_case(self, case_id: str) –> list[AuditEvent]:
"""按案例查询审计记录。"""
return [e for e in self.events if e.case_id == case_id]

# ===== 使用示例：CASE-CR-0042 =====

CASE_ID = "CASE-CR-0042"

def support_accept(agent: Identity, log: AuditLog, note: str) –> str:
"""客服 Agent 受理工单。

演示契约拦截：如果工单中包含“直接改额度”意图，则拒绝。
"""
if "直接改额度" in note:
log.record(agent, CASE_ID, "accept", False, reason="out_of_contract")
raise PermissionError("support 契约禁止直接改额度")

msg = f"已受理 {CASE_ID}: {note}"
log.record(agent, CASE_ID, "accept", True, ticket="T-CR-0042")
return msg

if __name__ == "__main__":
# 创建客服 Agent 身份
support = Identity(agent_id="001", role="support.intake")
log = AuditLog()

# 场景1：正常受理
print("=== 场景1：正常受理 ===")
print(support_accept(support, log, "客户申请额度至 120000"))
print(log.events[–1])

# 场景2：越权尝试（被拦截）
print("\\n=== 场景2：越权拦截 ===")
try:
support_accept(support, log, "客户申请额度至 120000，直接改额度")
except PermissionError as e:
print(f"拦截成功: {e}")

# 查看完整审计
print("\\n=== 审计记录 ===")
for event in log.for_case(CASE_ID):
print(f" {event.at} | {event.action} | ok={event.ok}")

输出示意：

=== 场景1：正常受理 ===
已受理 CASE-CR-0042: 客户申请额度至 120000
AuditEvent(at='2026-08-04T…', agent_urn='agent://support.intake/v1/001',
case_id='CASE-CR-0042', action='accept', ok=True,
detail={'ticket': 'T-CR-0042'})

=== 场景2：越权拦截 ===
拦截成功: support 契约禁止直接改额度

=== 审计记录 ===
2026-08-04T… | accept | ok=True
2026-08-04T… | accept | ok=False

7. 思考题

以下问题供团队内部讨论，帮助将概念落地到具体场景：

8. 下期预告

第 1 期：技能即契约（SkillContract）

把三个角色的能力写成可检查的契约声明，引入 P2 协议（契约 vs 权限，以更严者为准）。

9. 延伸阅读

• 本卷序章：心智模型、对象表、主案例（见系列总览）
• 冲突协议总表：P1–P5（见系列总览「冲突与例外协议」）
• 第 1 期：技能即契约——三个角色的 SkillContract 设计

本文是「企业智能体工程卷」十期专栏的第 0 期。欢迎转载，请注明出处与原文标题。