快速开始

English | 简体中文 | 首页

使用 0.7.2 代码，并确保 Python 版本为 3.10 或更高。 在仓库根目录运行：

python -m venv .venv

在 POSIX 系统上使用 source .venv/bin/activate 激活环境；在 Windows PowerShell 中使用 .venv\Scripts\Activate.ps1。激活后运行：

python -m pip install .
python examples/managed_task.py

预期输出：

42

该示例 使用 Dispatcher 管理 Runtime、后台 Host、 部署检查和通知收件箱。它用稳定的请求 ID 提交一个任务，并等待持久化结果。 示例为了方便运行使用临时目录；实际应用应改用固定路径。

执行脚本并接收结果

在 Linux 上运行：

python examples/sdk_script_wakeup.py

预期输出：

Wake conversation-42: succeeded
report ready

脚本示例 会提交任务并在后台执行。回调会先持久化 通知，示例再读取 stdout。它只打印结果；实际应用还需要由收件箱消费者读取通知并继续 Agent 流程。后台任务运行期间要保持 Host 存活。原生 Windows 的运行要求和已记录的验证范围详见平台状态。

接入自己的任务

先看托管任务。需要任务依赖、等待条件或显式 Run 决策时， 再使用底层的原子提交指南。接着可阅读 接入指南。