智能体

最快的路径是一个带模型的会话。智能体感知你接入的机器，做出决策并行动——全程流式传输，让你可以观看、和它对话，或者接管它。像快速开始里那样接入一台计算机或机器人。

# Start an agent thread — pick a model; the agent picks its own tools.
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" }'

• 模型——注册表中的任意模型，或你自己的密钥。参见模型与你的密钥。
• 工具——智能体从一个共享的工具接口中取用；工具只在相关时才会出现（3D 工具只在上下文中有 3D 文件时出现）。参见工具。
• 技能——你为智能体装备的可复用能力文件夹。参见技能。
• 人设与语音——一段系统提示词，以及一个可选的语音发声。参见语音与在场。
• 记忆——一个智能体可以读写的持久知识图谱。参见记忆。

一个已保存的智能体是你 Drive 上的一个文件夹——一个把配置写在 frontmatter 中的 AGENT.md，加上它所装备的技能。这让一个智能体像任何文件一样可版本化、可分叉、可共享，并可通过组织 → 用户 → 项目的级联方式解析，让团队能共享一个统一的人设。

---
name: Research assistant
model: openai/gpt-5.1
voice: true
skills: [web-research, cite-sources]
---
You are a careful research assistant. Prefer primary sources.
Ask before spending more than 20 credits on a single task.

一个会话是事件驱动且长期存在的。你（或另一个智能体，或一封传入的邮件/短信）可以随时给它发消息；它可以暂停下来提问、请求一个文件，或把控制权交给你。它还可以为子任务生成子智能体——父子会话图是同一个统一的模型，而不是一个独立的集成。

以上一切也是一个工具接口，所以一个智能体——或者你自己的代码——可以通过 API、SDK，或MCP 服务器来驱动它：创建一个会话，发送一条消息，观察、行动、拍摄快照、停止。用触发器按计划或事件唤醒它。