﻿# 组合任务

任何 BaseTask 都可同步调用已注册子任务。条件、循环和阶段屏障属于父任务，不需要专用组合基类或 Task 类型。

## 编写父任务

```python
from axonx.task.core.base import BaseTask
from axonx.task.models.params import BaseOutputParams

class ChainOutput(BaseOutputParams):
    total: int

class DemoChainTask(BaseTask):
    """Run two registered additions in one execution process."""
    output_cls = ChainOutput

    def build_task_steps(self):
        yield self.first
        yield self.second

    def first(self):
        result = self.run_task("demo", node_name="first", task_name="first", x=1, y=2)
        self.state["first"] = result.output["result"]

    def second(self):
        result = self.run_task("demo", node_name="second", task_name="second",
                               x=self.state["first"], y=4)
        self.state["total"] = result.output["result"]

    def build_output_params(self):
        return ChainOutput(total=self.state["total"])
```

在 plugin.yaml 注册 `demo_chain: example_plugin.chain:DemoChainTask`，然后执行 `axonx exec --task demo_chain --task-name experiment`，结果为 7。子任务共享父进程和工作区。示例显式设置子实例名；生产流水线需要隔离实验输出时应从父名称派生子名称。

## 失败与阶段屏障

`run_task` 在子任务完成后返回，检查 result.success、child_task_id、record 和 output。默认 on_error=stop 抛出 ChildTaskError；continue 保留失败记录并可继续后续工作，但父任务默认退出策略仍报告失败。只有明确处理了执行错误才应覆盖 exit_code；正常完成的业务结论保留在输出字段中。

输入依赖需要显式传 upstream_task_ids，父子包含关系不建立这些边。node_name 标识调用和尝试，task_name 选择目录。重复调用同注册/名称会替换当前输出，应先消费或固定产物。

## 记录、所有权与停止

父 metadata.children 保存调用快照，构造失败可能没有子 ID。子任务有独立 metadata，但共享进程所有权。`kill` 将活动子任务解析到根所有者并停止执行进程及后代，不能独立停止进程内子任务而保留父执行。

独立实验使用不同父/子实例，固定名称流水线由调用方协调。启动或显式 kill 修正确认已退出的本机记录，查询保持只读。

[Task 契约](https://flowllm-ai.github.io/AxonX/zh/reference/task-contracts) · [生命周期](https://flowllm-ai.github.io/AxonX/zh/concepts/jobs-and-tasks)
