开始使用
快速开始
创建一个会话，接入一台真实的机器，看着智能体工作——只需两次调用。
1. 获取 API 密钥
2. 启动一个会话
会话是智能体运行的工作空间。它一开始是空的；你把机器接入进去。
POST /threads
curl https://api.commandagi.com/threads \
-H "Authorization: Bearer $COMMANDAGI_API_KEY" \
-H "content-type: application/json" \
-d '{ "title": "Fix the failing test", "modelId": "openai/gpt-5.1" }'3. 接入一台机器
添加一台计算机（或一个机器人仿真）。运行期间会按商品费率预先向你收费——参见账单。
POST /threads/:id/computers
# Add a Standard Computer to the thread and start the agent.
curl https://api.commandagi.com/threads/$THREAD_ID/computers \
-H "Authorization: Bearer $COMMANDAGI_API_KEY" \
-H "content-type: application/json" \
-d '{ "snapshotId": "computer/software-engineer" }'实时观看
打开 https://commandagi.com/thread/<id>，就能像看直播一样观看智能体，与它对话，接管远程控制，或对机器拍摄快照。同一个视图适用于计算机、机器人和仿真。
不用智能体——自己来驾驶
想要一台你自己直接控制的机器，而不是智能体？用 POST /device-threads 创建一个，并通过 WebSocket 驾驶它——非常适合在 3D 仿真中测试机器人策略。Python SDK 只需三行代码就能做到。