规划与工作流Planning & workflows
把复杂目标拆解成步骤并驱动执行：SOP 状态机、目标验证流水线、团队流水线等。适合长任务、可审计流程和需要人工介入的业务。Break complex goals into steps: SOP state machines, verifier pipelines and team pipelines for long-running, auditable work.
心智模型Mental model
规划层把复杂目标拆成步骤，用流水线、工作流或 SOP 编排多个智能体/工具，并维护步骤状态与失败恢复。Planning decomposes goals into steps and orchestrates agents or tools through pipelines, workflows or SOPs with step state and recovery.
先学什么What to learn first
- 流水线适合固定拓扑，SOP 适合需要人工审批和状态机控制的流程。Pipelines fit fixed topologies; SOPs fit state machines with human approval.
- 每一步都要有输入输出契约，否则失败后无法重放。Every step needs an input/output contract so it can be replayed after failure.
- 规划结果要可观测：记录步骤、耗时、失败原因和重试次数。Make plans observable: record steps, latency, failure causes and retries.
生产常见坑Production pitfalls
- 让模型自由生成无限步骤，缺少预算和终止条件。Unbounded model-generated steps without budget or termination.
- 步骤失败后从头重跑，产生重复副作用。Restarting a failed workflow from scratch duplicates side effects.
域内图谱Domain map
点击节点打开 API 页面；拖拽平移，滚轮缩放。Click a node to open its API page. Drag to pan, scroll to zoom.
Python API 集Python API set 20
归入本功能域的全部 Python 公开类型，按所属包分组。Every public Python type classified into this domain, grouped by owning package.
agentscope.sop9
AgentLike | class | 智能体 Like，把复杂任务拆分为可执行步骤并驱动流程。 |
SOP | class | SOP，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPEngine | class | SOP 引擎，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPPhase | class | SOP 阶段，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPRunState | class | SOP 运行状态，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPStep | class | SOP 步骤，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPStepBase | class | SOP 步骤基类，把复杂任务拆分为可执行步骤并驱动流程。 |
SOPStepRunState | class | SOP 步骤运行状态，把复杂任务拆分为可执行步骤并驱动流程。 |
VerificationResult | class | Verification 结果，把复杂任务拆分为可执行步骤并驱动流程。 |
agentscope.app.storage8
AgentVerifier | class | 智能体校验器，在多次调用之间保存和恢复会话与记忆数据。 |
HumanVerifier | class | 人工校验器，在多次调用之间保存和恢复会话与记忆数据。 |
SOPAgentRef | class | SOP 智能体引用，在多次调用之间保存和恢复会话与记忆数据。 |
SOPData | class | SOP 数据，在多次调用之间保存和恢复会话与记忆数据。 |
SOPRecord | class | SOP 记录，在多次调用之间保存和恢复会话与记忆数据。 |
SOPRunRecord | class | SOP 运行记录，在多次调用之间保存和恢复会话与记忆数据。 |
SOPStepDataV1 | class | SOP 步骤数据 V 1，在多次调用之间保存和恢复会话与记忆数据。 |
SOPWorkspaceGrain | class | SOP 工作区粒度，在多次调用之间保存和恢复会话与记忆数据。 |
agentscope.pipeline2
GoalPipeline | class | 目标流水线，把复杂任务拆分为可执行步骤并驱动流程。 |
PipelineProtocol | class | 流水线协议，把复杂任务拆分为可执行步骤并驱动流程。 |
agentscope.app.middleware1
SOPStepSubmitMiddleware | class | SOP 步骤提交中间件，在智能体执行流程中提供横切扩展。 |
Java API 集Java API set 1
归入本功能域的全部 Java 公开类型，按包分组并标注构件。Every public Java type classified into this domain, grouped by package with its artifact.
io.agentscope.harness.agent.workspace.plan1
PlanModeManager | class | agentscope-harness | 计划模式管理器，把复杂任务拆分为可执行步骤并驱动流程。 |
Python ↔ Java 对照Python ↔ Java
Python
Java
SaaPlanPlanAgentPlan两套实现共享同一概念模型，但在并发（async/await 与 Reactor）、打包（wheel 模块与 Maven 构件）和生命周期 API 上存在差异。需要精确签名时请使用 API 全景。The two implementations follow the same conceptual model but differ in concurrency (async/await vs Reactor), packaging (wheel modules vs Maven artifacts) and lifecycle APIs. Use the full API map to locate exact signatures.