# 接口参考

按需查询命令语法、配置字段、响应和事件。第一次执行请跟随[快速开始](https://flowllm-ai.github.io/AxonX/zh/getting-started/quickstart)，完整研究链路见[研究流程](https://flowllm-ai.github.io/AxonX/zh/research/workflow)。

## 选择接口

| 接口或设置                      | 参考                                     |
| ------------------------------- | ---------------------------------------- |
| 命令行与当前进程执行            | [CLI](https://flowllm-ai.github.io/AxonX/zh/reference/cli)                            |
| 程序化服务调用                  | [Python](https://flowllm-ai.github.io/AxonX/zh/reference/python)                      |
| 客户端地址、令牌与超时          | [客户端配置](https://flowllm-ai.github.io/AxonX/zh/reference/client-configuration)    |
| 应用、Component 与 Job 装配     | [服务端配置](https://flowllm-ai.github.io/AxonX/zh/reference/configuration)           |
| HTTP 发现与 JobResponse         | [API 总览](https://flowllm-ai.github.io/AxonX/zh/api/overview)           |
| Task 提交、状态、上下文与关系图 | [Task API](https://flowllm-ai.github.io/AxonX/zh/api/tasks)              |
| 实时进度与日志事件              | [SSE 事件](https://flowllm-ai.github.io/AxonX/zh/api/events)             |
| 工作区列表与预览                | [工作区 API](https://flowllm-ai.github.io/AxonX/zh/api/workspace)        |
| 机器与资源读数                  | [机器 API](https://flowllm-ai.github.io/AxonX/zh/api/machines)           |
| 插件管理与快照同步              | [插件与同步 API](https://flowllm-ai.github.io/AxonX/zh/api/plugins-sync) |
| 内置 Agent 会话                 | [Agent API](https://flowllm-ai.github.io/AxonX/zh/api/agent)             |

外部 Agent 的服务工具发现见 [MCP 接入](https://flowllm-ai.github.io/AxonX/zh/agent/mcp-integration)。MCP 暴露公共 Job；实时 SSE 使用 HTTP 事件端点。

## 分层理解响应

HTTP 传输状态、JobResponse 的 `success` 与 Task 终态分别回答不同问题。成功的 `submit` 返回 TaskHandle；使用其中的 `task_id` 与 `run_id` 等待本次执行，再检查最终状态。已安装插件与配置的 Job 决定实际能力，因此应在所连接服务上发现 Schema。

实现契约见[开发扩展](https://flowllm-ai.github.io/AxonX/zh/development/overview)下的 [Task 契约](https://flowllm-ai.github.io/AxonX/zh/reference/task-contracts)、[插件清单](https://flowllm-ai.github.io/AxonX/zh/reference/plugin-manifest)和[研究产物](https://flowllm-ai.github.io/AxonX/zh/reference/research-artifacts)；执行语义见 [Job 与 Task](https://flowllm-ai.github.io/AxonX/zh/concepts/jobs-and-tasks)。