灵活构建智能体，
可靠运行智能应用。
可靠、可扩展的智能体全生命周期框架。
按需组合模型、工具与记忆，保存审批和回执，重启后继续原任务。
ticket: "INC-001"
run_01J_RALF在关键操作前审批。
重启后，依据记录继续。
以工单变更为例：核对计划并批准，模拟宿主重启，再用已保存的批准继续原任务。点击下方按钮，走完这条路径。
waiting_approvalrun_01J_RALFAction IDaction_change_001操作摘要55b34230…2ee944ac 缩略工具apply_change参数{ "ticket": "INC-001",
"plan": "restart test cache" }审批记录待确认演示宿主process_01示意 ID 与摘要：批准会绑定到这一个操作。
- 工单已读取，变更操作等待审批。
先核对工具、参数与摘要，再批准这次操作。
固定数据的浏览器示意，不运行 Python、调用模型或执行业务写入。真实恢复需要原数据、匹配配置和业务证据；未知写效果仍需核验。
从一个业务工具，
到完整的 Agent 应用。
先解决一个具体任务，再加入对话、知识与协作。每项能力都有独立的配置、使用指南和恢复边界。
模型与 Python 工具
连接明确的模型协议，把业务函数注册为工具。用参数 Schema、输出约束和审批规则定义调用边界。
适用：工单查询、订单助手、业务操作
工作流与多 Agent
把已知依赖编成静态图，按需加入有界并行、Plan 或 Team。父子任务保留各自的结果与执行身份。
适用：分步诊断、路由分派、研究与复核
持久会话与长期记忆
用 Session 串起多轮任务，用版本化 Facts 保存已确认信息。显式选择召回和上下文策略。
适用：连续对话、客户偏好、跨轮任务
文档摄取与知识检索
摄入文档、保存版本与来源，选择词法、向量或混合检索。让回答依据可以追溯，再验证实际效果。
适用：运维手册、产品问答、知识助手
外部工具与工作资料
按需接入 MCP、HTTP、固定 CLI、Workspace 与 Skills。宿主选择工具与范围，执行仍沿用审批和回执协议。
适用：复用服务、内部脚本、文件与操作说明
配置、交互与恢复
固定组件版本与执行限制。分别处理审批、补充输入和未知效果，通过原记录观察并恢复任务。
适用：版本管理、运行排障、受控执行
本地起步，按需组合。
Local + SQLite 是低依赖起点。外部工具、远程存储与 Temporal 等扩展需显式配置，当前 Alpha 按各自实验性范围使用。
无需密钥，
跑通第一个本地任务。
源码安装后，生成一个离线工单项目。固定 Provider 会提出待批操作，让你先理解执行协议，再接入自己的模型。
- 01安装 SDK，生成项目
Python 3.11+ · 本地 SQLite
- 02检查并批准原操作
inspect → approve
- 03恢复原 Run，检查完成状态
resume → succeeded
首次运行预期停在 waiting_approval。这些命令用于安装与启动项目，完整教程在同一页包含安装、审批、恢复和结果检查。
1. 从源码安装
git clone https://github.com/RalfNick/relf-agent.git
cd relf-agent
git checkout 0b9b6c9682c40285d91994cd831aa93d7e814bf1
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .2. 启动离线项目
ralf --format text init ../my-agent
cd ../my-agent
python -m agent_app --ticket INC-001从这里，走进 Relf-Agent。
下一步，交给你来定义。
从第一个本地 Agent，开始你的执行路径。
ALPHA · APIS & DEPLOYMENT CONTINUE TO EVOLVE