agent-center·
首页开发指引v2.8 战略设计 › 智能体
战术设计 · 核心域 CORE

智能体 · Agent

在 worker 上执行任务的智能体;运行时生命周期工作项是两个独立聚合,强制单活工作项。internal/agent

← 战略设计 项目管理 智能体 环境 会话 可观测性 身份 SecretManagement
聚合根 AR 实体 Entity 值对象 VO Repository 领域事件 Event
技术方案 · 调度与单活工作项

派任务给智能体 → agent 侧建 AgentWorkItem,以 pm://tasks/{id} 非拥有引用(ACL)。不变式:单智能体同时仅 1 条活跃工作项;重派 → 旧置 superseded、新建 queued。智能体 lifecycle 与工作项是两个聚合

lifecycle:stoppedrunningstopping · resetting · error(瞬态) · failed(崩溃熔断终态,term)
工作项:queuedactivewaiting_inputdone · failed · canceled · superseded(后四个 term)
战术设计 · 聚合 / 实体 / 值对象 / 事件

智能体 · Agent internal/agent

Agent 智能体 AR
id · organizationID · profile(Profile VO:Name/Description/Model/CLI/EnvVars) · skills[] · workerID(不可变) · lifecycle · lifecycleError · createdBy(IdentityRef) · identityMemberID · createdAt · updatedAt · version
注:无顶层 name/agentCLI/state/isBuiltin,name 在 Profile 内。
状态机 lifecycle: stopped running stopping · resetting · error(瞬态) failed(崩溃熔断终态)
值对象
ProfileAvailability(派生·不存储)
Repository · 事件
Repository · FindByID · ListByWorker · ListByOrg · Save · Update · Delete
agent.createdagent.lifecycle_changedagent.work_item_transitioned
AgentWorkItem 工作项 AR
id · agentID · taskRef(pm://tasks/{id} · 非拥有引用) · status(WorkItemStatus) · …
状态机: queued active waiting_input done · failed · canceled · superseded (后四 term)
值对象/不变式
WorkItemStatus(7 态)TaskRef(pm://tasks/{id})
单智能体同时仅 1 条活跃工作项(HasActiveWorkItem)。
Repository
WorkItemRepository · FindByID · ListByAgent · ListByTask · ListByStatus · HasActiveWorkItem · Save · Update
AgentActivityEvent 活动事件 AR · 追加写
append-only 观测流:智能体冗长中间输出落此,不进会话线程。
ActivityEventRepository · Append · ListByAgent · ListByWorkItem
领域服务 · 工作项分派:任务派给 Agent → 建 queued 工作项;重派 → 旧 superseded + 新 queued(跨聚合协调,强制单活工作项)。可用性投影:由 Worker 状态 + Agent lifecycle 派生 availability(跨上下文,环境优先)。
跨域协作:本域以 ACL(pm://tasks/{id})非拥有引用项目管理的 Task;可用性由环境的 Worker 状态派生(D,环境优先);向可观测性同事务发事件。完整业务流见 战略设计 · Event Storming