用途:Agent Vision 是托管式图表应用。用户编写一份小型 JSON 文档(spec,即 DSL),应用将其渲染(当前为 2D,等距视图后续支持),把每次变更保存为不可变修订,并返回公开分享 URL 和渲染后的 PNG,便于立即展示给用户。本已安装技能只是连接配方,完整 DSL、颜色/惯用法语法、示例、ops-patch 参考、图标目录和警告列表位于托管的标准技能文档中,应在绘图会话开始时获取一次并遵循:<app-url>/skill.md(向用户询问其 Agent Vision 应用 URL)。
连接方式:先检查环境,若已设置 AGENT_NATIVE_VISION_URL 和 AGENT_NATIVE_VISION_TOKEN 环境变量(预置容器),直接使用并在每次调用带上 bearer 头,跳过以下认证。主要方式为设备流程:POST <url>/_agent-native/mcp/connect/device/start(空 JSON 体,无认证)返回 device_code、user_code、verification_uri_complete、interval、expires_in;让用户在聊天中打开 verification_uri_complete 并点击授权设备(代码 user_code);随后每 interval 秒 POST <url>/_agent-native/mcp/connect/device/poll,体为 {"device_code":"<device_code>"},直到返回 approved 得到 token、mcpUrl 等(pending 继续,expired/consumed 则从第一步重启)。备选方式为用户自建令牌:用户登录后打开 <url>/_agent-native/mcp/connect,点击 Create connection token,把 { url, token } 粘贴给你;令牌按用户、有作用域、有期限,可在同页撤销。
MCP 客户端(如 Claude Code):claude mcp add --transport http agent-vision
<url>/_agent-native/mcp
--header "Authorization: Bearer <token>"。支持 OAuth 的客户端(Claude 网页/桌面、Cursor、ChatGPT)只需添加 <url>/_agent-native/mcp(无头),在客户端登录弹窗中批准连接器即可,无需令牌。纯 HTTP 代理(无 MCP 客户端):每个工具也是普通 HTTP 端点 <url>/_agent-native/actions/<name>,同一 bearer 令牌可用;每个请求发送 Authorization: Bearer <token>;读取为带查询参数的 GET,写入为带 JSON 体的 POST;缺少该头时这些路由返回 401 {"error":"Unauthorized"}。
首次接触五步:1. list-projects 发现/确认工作区;2. create-diagram { title, spec } 返回 { url, svgUrl, pngUrl, warnings };3. 获取 pngUrl 查看渲染并阅读 warnings;4. update-diagram { diagram, ops:[...] } 修复警告(按需重复 3–4);5. 分享 url,把 /d/<slug> 链接发给用户。切勿分享未渲染查看过或仍有未解决警告的图表——警告是待办清单而非装饰。分享 URL(<app-url>/d/<slug>)公开且无需令牌,是交给用户的链接;.svg / .png 变体为原始图像。超出此循环的内容(spec 结构、节点/边/组字段、ops 补丁、图标名称、惯用法如标注、区域、主干边、代码文本)请阅读 <app-url>/skill.md,它是唯一事实来源并随部署应用保持最新。
限制:本技能本身不含 DSL 细节,需依赖托管技能文档;认证令牌有期限且可撤销;未提供具体收费、价格或平台支持信息。