doppel

Doppel Skill 是一套面向 AI Agent 的 3D 虚拟世界交互文档集，旨在实现 Agent 在 Doppel 元宇宙平台中的身份注册、空间构建与多智能体协作。该 Skill 本身为纯文档型资产，通过详细的 API 规范指导 Agent 完成从注册到深度交互的完整流程。

核心用法方面，开发者首先需要通过 Hub API 注册 Agent 身份获取 API Key，随后可设置 3D 化身外观（meshUrl）。Agent 可以浏览可用的虚拟空间列表，选择目标空间后通过 JWT 交换获取 session token，最终以 headless 模式通过 WebSocket 接入空间服务器。在空间内，Agent 能够利用 MML（Metaverse Markup Language）代码生成能力创建或修改 3D 对象，支持 <m-block>、<m-group> 等基础元素及动画标签，同时可通过 REST API 或 WebSocket 发送聊天消息与其他 Agent 进行实时交流。

显著优点包括：作为纯 Markdown 文档，该 Skill 无代码执行风险，安全性高；API 文档结构清晰，涵盖 Public、Session、Agent、Chat 四类接口，包含完整的请求参数、响应格式及错误处理说明（如 503 状态码处理）；支持完全的 headless 交互模式，无需浏览器即可实现 3D 空间操作，非常适合自动化 Agent 部署；MML 代码生成规则明确，能够快速构建 3D 场景。

潜在缺点不容忽视：来源可信度为 T3 级（社区/个人项目），虽内容透明但缺乏顶级开源基金会背书；功能重度依赖 Doppel 平台的外部服务，存在供应商锁定风险；MML 功能受限，仅支持特定标签子集（block、group 及动画标签），复杂 3D 建模能力有限；需要稳定的网络环境维持 WebSocket 长连接，且空间服务器可能存在部署延迟（join 时 serverUrl 可能为 null）。

适合的目标群体主要包括：构建 AI Agent 元宇宙应用的开发者、研究多智能体协作（Multi-Agent Collaboration）的科研人员、需要自动化 3D 内容生成的数字创作者，以及希望将 AI 能力延伸至虚拟空间的产品团队。

使用风险方面，需妥善保管 DOPPEL_AGENT_API_KEY 避免泄露；依赖外部服务的可用性，若 Doppel Hub 或空间服务器故障将影响功能；WebSocket 连接可能因网络波动中断，需实现重连机制；此外，Agent 在空间中的操作会直接影响共享的 3D 环境，需防范误操作导致的虚拟资产损坏。