用途:把产品/资源描述交给 CADT AI 智能体,由后端生成云架构图(节点、连接、校验、布局),并返回 Markdown 架构摘要。仅用于架构创建,不进行资源开通或部署。
前提:aliyun 版本需 >= 3.3.3,且存在有效 profile(aliyun configure list)。安全要求:绝不读取或回显 AK/SK,绝不要求用户在对话中输入凭证。
使用方式:第一步用 SendMessage 提交绘图请求,例如: aliyun bpstudio execute-operation-sync --service-type ai_agent --operation SendMessage --region cn-hangzhou --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-cadt-arch-draw/{SESSION_ID}" --attributes '{"prompt": "一台 Web ECS + 一台 MySQL RDS + 一台 SLB,部署在同一个 VPC 内"}' prompt 必填,需具体说明产品、数量与关系;sessionId 可选,用于在已有架构上迭代;scene 暂无可选值,省略。若用户提供 sessionId,必须原样传入以复用会话,不得新建会话或本地重画。
第二步用 ListMessage 轮询结果,传入同一 sessionId。查找最后一条 senderType 为 robot 的消息:status 为 ongoing 则等 5 秒再轮询;为 done 则进入交付。最多轮询 30 次(约 150 秒),超时后停止并告知用户,不得新建会话。
第三步交付:若内容含资源表/拓扑/校验,则原样呈现 Markdown,并说明架构已在 CADT 创建、可在 CADT 控制台查看编辑,可继续用同一 sessionId 修改;若内容是澄清提问,则转达用户、收集回复后用同一 sessionId 再次 SendMessage。
限制与错误处理:不存在的产品或地域不会返回 FAILURE,而是返回澄清提问,需如实转达,不得编造成功架构。SUCCESS 不重试;业务类 FAILURE 展示 Message 后停止;仅当 FAILURE 且 Message 含 "Failed to invoke"(后端不可用)时等 30 秒重试一次。所有调用必须携带 --user-agent,uid 由网关自动注入,不得在 attributes 中传入。轮询以 robot 消息状态为准,而非顶层 ongoing 字段。不得在本地生成架构图文件。