Ordin

Ordin 是模型中立、单进程生命周期的 Python Agent 编排库。平台先持久化 UserMessage，再把 ExecutionRequest 交给一个 Ordin 对象；根主控和开发者 Agent 都使用同一个公共 Agent 类型和同一个 AgentLifecycle。未设置 custom logic 时，它们共享默认的 Context/模型/Tool/Artifact 多轮循环。

根 Agent 可以通过受控 Tool 创建 Task DAG、选择已注册 Agent 与模型、并发执行子 Agent、等待首个或 全部结果，并在检查和取消旧执行后原子修订 Plan。Provider、Store、ObjectStore 和注册表由 Ordin 持有，不进入 Agent 定义。

安装

pip install ordin

最小示例

from ordin import Agent, Ordin
from ordin.common import Identity
from ordin.llm import LLMCallPipeline, LLMProfile
from ordin.observability import EventBroker
from ordin.testing import InMemoryObjectStore, InMemoryOrdinBackend

backend = InMemoryOrdinBackend()
events = EventBroker(backend)
model = LLMCallPipeline(
    provider=my_llm_provider,
    recorder=backend,
    event_sink=events,
).bind(LLMProfile(id="private-model"))

ordin = Ordin(
    root_agent=Agent[None](
        name="root",
        instructions="Answer directly or create bounded child Agents when useful.",
        model=model.id,
    ),
    models=(model,),
    backend=backend,
    object_store=InMemoryObjectStore(),
    events=events,
)

ordin.register(
    Agent[None](
        name="research",
        description="Produce bounded research evidence.",
        instructions="Complete only the current Task.",
        model=model.id,
    )
)

request = await backend.prepare_execution(
    "分析这个问题",
    identity=Identity(user_id="u-1"),
)
result = await ordin.execute(request, context=None)

完整离线示例见 examples/direct.py、 examples/mission.py 和 examples/custom_agent.py；运行中取消与原子修订见 examples/plan_revision.py。

文档

• 文档入口
• 架构总览
• 根 Agent 编排
• Context 与模型调用
• Agent 模块
• 快速开始
• ADR-0001：Agent 自托管
• ADR-0008：绑定模型与受约束选择

开发校验

uv sync
uv run python scripts/docs.py --check
uv run pytest tests/test_docs.py
uv run ruff format .
uv run ruff check .
uv run ty check
uv run pytest