快速开始 | Hast Docs

使用个人 API 密钥，从你的服务端向 Task Agent 提交任务，再通过事件流查看进度与结果。本指南与产品内的 Task Agent API 文档使用同一份公开接口定义。

准备地址与密钥

在管理 API 密钥页面创建个人 API 密钥，提交任务需要 prompts:write，读取会话和事件需要 sessions:read。保存完整密钥，并在运行示例的终端设置环境变量：

export HAST_API_BASE='https://backend.hast.so/api/public/v1'
export HAST_API_KEY='<你的个人 API 密钥>'

发送第一条任务

curl --fail-with-body --request POST \
  --url "$HAST_API_BASE/prompts" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"request_id":"req_123","prompt":"Summarize the latest workspace files."}'

这个例子要求 Agent 汇总工作区文件。也可以把 prompt 替换为自己的任务要求。

省略 session_id 会创建会话；后续携带同一个 session_id 可以继续该会话。request_id 用于幂等处理，提交新一轮任务时使用新的值。

接口接收请求后返回 HTTP 202。保存响应中的 session_id；202 表示任务已接收，执行结果需要继续读取事件。完整请求字段和返回结构见 API 文档。

读取执行过程

将返回的会话 ID 设置为 SESSION_ID：

export SESSION_ID='<响应中的 session_id>'
curl -N --fail-with-body \
  "$HAST_API_BASE/sessions/$SESSION_ID/events/stream?after=0" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Accept: text/event-stream'

会话通过 SSE 推送 HAST Event v2。根据事件类型显示消息、工具进度和运行结果；message.completed 表示一条消息完成，整轮任务的状态需要查看运行事件。帧格式、事件结构与断线续读见事件流。

继续接入

在 API 文档中查看会话、文件、技能、记忆、连接器和密钥接口，展开接口即可查看参数和响应结构。也可以下载 OpenAPI JSON，导入支持 Swagger / OpenAPI 2.0 的工具。