Mosoo Public Thread API

Mosoo Public Thread API 让你的后端把任务发送给已发布的 Mosoo Agent，并读取公开结果。Mosoo 负责 Agent runtime、sandbox、模型服务商配置、工具和执行生命周期；你的应用负责产品 UI、业务逻辑、用户映射、存储以及保存 thread.id。

API 只适用于已发布并启用 API access 的 Agent。Agent 配置、模型服务商连接、工具配置和渠道绑定仍然在 Mosoo 中管理。

心智模型

Agent API Endpoint

Agent API Access 面板中展示的已发布 Agent 入口。v1 的 agentId 路径参数是不带前缀的 ULID。

Thread

API 创建的对话容器。Thread 记录消息、文件、Run 状态和公开事件历史。

Run

Agent 在一个 Thread 上的一次执行。用户消息可以排队启动新的 Run。

Event

用户输入、Agent 输出增量、工具更新、文件变化、Run 状态和用量的公开时间线。

第一个请求

设置 Mosoo API token 和 Mosoo 中的已发布 Agent ID：

export MOSOO_API_TOKEN="mst_..."
export MOSOO_AGENT_ID="01J00000000000000000000001"

创建 Thread 并排队第一个 Run：

curl -X POST "https://try.mosoo.ai/api/v1/agents/$MOSOO_AGENT_ID/threads" \
  -H "Authorization: Bearer $MOSOO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ticket-182-create-thread" \
  -d '{
    "client_external_ref": "ticket-182",
    "input": {
      "type": "user.message",
      "content": [
        {
          "type": "text",
          "text": "Triage this customer escalation and suggest next steps."
        }
      ]
    }
  }'