跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ironclaw.com/llms.txt

Use this file to discover all available pages before exploring further.

在 IronClaw 中，每一个工作单元都是一个任务。任务会并行运行、彼此隔离上下文，并沿着定义好的状态机推进，直到完成、失败或被恢复。

​
配置

# 最大并行任务数
MAX_PARALLEL_JOBS=5

# 沙箱超时（影响任务何时会被视为卡住）
SANDBOX_TIMEOUT_SECS=1800

​
任务状态机

Pending
    ↓
InProgress ──────────────┬──► Completed
    ↑                    │
    │  (self-repair)     └──► Failed
    │
  Stuck ────────────────────► Failed (if unrecoverable)

​
状态

状态描述下一状态
Pending任务已创建，正在等待可用 worker 槽位InProgress
InProgressWorker 正在执行任务，例如调用 LLM 或运行工具Completed、Failed、Stuck
Completed任务已成功完成终态
Failed发生不可恢复错误，或任务被显式取消终态
Stuck在超时窗口内未检测到任何进展InProgress（恢复）、Failed

​
状态流转

当自修复系统发现一个 InProgress 任务在超过配置超时时间后仍没有任何活动时，任务会进入 Stuck。系统随后会尝试使用新的 worker 重新进入 InProgress 来恢复任务。如果多次恢复都失败，任务就会进入 Failed。

​
并行执行

IronClaw 可以同时运行多个任务。每个任务都拥有自己的隔离上下文，包括记忆、工具调用历史和会话状态。
配置变量默认值描述
MAX_PARALLEL_JOBS5每个实例允许的最大并发任务数
当所有任务槽位都被占满时，新任务会以 Pending 状态排队，直到有空闲槽位为止。调度器会按创建时间顺序分发排队任务。
提高 MAX_PARALLEL_JOBS 会增加对 LLM API 的并发压力。请根据您的 API 限额和机器资源来设置该值。

​
任务工具

有四个内置工具可供智能体在运行时管理任务：
工具描述
create_job创建一个带有描述和可选上下文的新任务
list_jobs列出所有活动任务及其当前状态和元数据
job_status获取指定任务 ID 的详细状态
cancel_job取消一个 InProgress 或 Pending 状态的任务