CAD Web AI Agent 接入
This commit is contained in:
@@ -0,0 +1,269 @@
|
||||
# CAD Web AI Agent 前端对接
|
||||
|
||||
本文描述已实现的后端接口和 SolidCraft 网页端需要完成的适配。后端不运行 CAD 引擎,不执行工具,也不持久保存聊天。**仅嵌入当前 SolidCraft 网页构建不会自动启用 Agent**:原有模型客户端、CLI Agent 和聊天入口受桌面编译条件限制,需要前端新增网页 `ChatBackend`、工具适配器及文档生命周期管理。
|
||||
|
||||
调用链:SolidCraft 面板 → `/api/cad/ai/chat` → 豆包 → 浏览器执行工具 → 携带结果再次请求。一次 HTTP 请求只推进一次模型推理。设计文件的保存与续编仍使用 [CAD 工作空间接口](frontend-cad-workspace.md)。
|
||||
|
||||
## 登录、启用和能力
|
||||
|
||||
全部接口复用平台 `Authorization: Bearer <token>`,不向网页下发方舟密钥或 Endpoint。推荐同源部署;iframe 使用受控宿主桥接时校验精确 origin、source 和请求关联编码,Token 不进入 URL。关闭、换账号或退出登录时取消旧请求并清理账号相关会话。
|
||||
|
||||
| 方法 | 路径 | 返回 |
|
||||
| --- | --- | --- |
|
||||
| GET | `/api/cad/ai/capabilities` | 普通统一 JSON 包装,data 为能力 |
|
||||
| POST | `/api/cad/ai/chat` | `text/event-stream`,每个 data 使用统一包装 |
|
||||
|
||||
```ts
|
||||
interface CadAiCapabilities {
|
||||
enabled: boolean;
|
||||
protocolVersion: 'cad-agent-v1';
|
||||
model: string;
|
||||
tools: Array<{ name: string; description: string; parameters: object }>;
|
||||
limits: {
|
||||
requestBytes: number; // 4194304,仅 chat 请求
|
||||
imageBytes: number; // 1048576,单图解码后字节
|
||||
imageMaxEdge: number; // 2048
|
||||
imagesPerRequest: number; // 2,包含全部历史中的图片
|
||||
textBytes: number; // 262144,UTF-8 文本及结构化上下文
|
||||
toolResultTextBytes: number; // 32768,单份工具结果的文字合计
|
||||
historyItems: number; // 256
|
||||
maxModelCallsPerTurn: number; // 默认 12
|
||||
maxChangesPerTurn: number; // 默认 24
|
||||
requestTimeoutSeconds: number;// 默认 60
|
||||
requestsPerMinute: number; // 默认 30,工具续调同样计数
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
先读能力,再启用面板中的平台 Agent。功能关闭或基础配置不完整时 `enabled=false`,能力接口仍返回 200;聊天接口返回 503。界面使用平台指定模型,隐藏本地 Agent、API Key、任意服务地址、模型切换及不受限权限选项。能力不兼容时要求更新网页构建,不能把原生桌面 Agent 当作回退。
|
||||
|
||||
## 请求和历史类型
|
||||
|
||||
```ts
|
||||
type Content =
|
||||
| { type: 'text'; text: string }
|
||||
| { type: 'image'; mimeType: 'image/png' | 'image/jpeg'; data: string };
|
||||
// image.data 是纯标准 Base64,不包含 data:image/... 前缀,不接受外链或 file_id。
|
||||
type HistoryItem =
|
||||
| { type: 'message'; role: 'user' | 'assistant'; content: Content[] }
|
||||
| { type: 'toolCall'; callCode: string; name: string; arguments: object }
|
||||
| { type: 'toolResult'; callCode: string; isError: boolean; content: Content[] };
|
||||
interface CadAiRequest {
|
||||
protocolVersion: 'cad-agent-v1';
|
||||
documentSessionCode: string;
|
||||
turnCode: string;
|
||||
cadProjectCode?: string;
|
||||
history: HistoryItem[];
|
||||
context: { documentRevision: string; selection?: object[] };
|
||||
}
|
||||
```
|
||||
|
||||
- `documentSessionCode`、`turnCode` 为前端生成的 1~64 位字母、数字、下划线或短横线编码。每次打开文档生成文档实例编码;一条用户消息的全部工具循环共用轮次编码。
|
||||
- `cadProjectCode` 可省略,未保存的空白设计也能使用。提供时必须是当前账号未删除项目;其他人、不存在或已删除统一 404。
|
||||
- `documentRevision` 是当前浏览器设计的修订标记,1~128 字符。它用于前端判断迟到结果,**不是云端保存的 version**,两者不能互换。
|
||||
- `selection` 最多 64 个对象,采用 SolidCraft 原生上下文描述,包含实体、特征或几何元素的稳定引用及必要尺寸;不发送全部 CAD 文件、整个网格或 OSS 链接。
|
||||
- 文字内容不能为空字符串。单条 content 最多 16 块;助手 message 只接受文字,用户消息和工具结果可包含图片。角色不能为 system/developer。
|
||||
- 每种 history 类型只填写对应字段。工具名称、参数 Schema 以能力接口为准,前端不能提交自己的工具定义、系统指令或模型配置。
|
||||
|
||||
历史必须以用户消息开头,发送时以本次用户消息或全部已配对的工具结果结尾。助手文字后可以连续出现多个 `toolCall`,其结果必须按调用顺序全部回填;`callCode` 在保留的历史内唯一,不允许缺失、重复或错配。
|
||||
|
||||
正常顺序示例:`用户 → 助手文字(可选) → 调用 A → 调用 B → 结果 A → 结果 B → 助手 → 新用户`。工具可以只有调用而没有说明文字;一次调用失败仍回填 `isError=true`,不要删除关联调用。
|
||||
|
||||
完整历史由前端持有,刷新或关闭页面后不恢复。超过总量、图片数或条目数时,裁剪最早的**完整用户轮次**,不单独删除调用或结果。当前轮次本身超限时停止并提示开启新聊天。图片限制覆盖历史图片:保留当前轮次需要的图片,必要时清理整轮旧历史。
|
||||
|
||||
## SSE 事件和执行边界
|
||||
|
||||
每个事件的 data:`{code,message,data,requestId}`。成功 code 为 `OK`;心跳是 SSE 注释,不带 JSON。事件中的 data 均携带 `documentSessionCode` 和 `turnCode`。
|
||||
|
||||
| event | data 其他字段 | 前端行为 |
|
||||
| --- | --- | --- |
|
||||
| `text_delta` | `text` | 追加助手显示文本 |
|
||||
| `tool_call` | `callCode,name,arguments` | 展示待执行卡片,暂不执行 |
|
||||
| `completed` | `finishReason,output,usage` | 本步成功终态;output 是规范化 HistoryItem[] |
|
||||
| `error` | 无其他字段,错误在包装的 code/message | 停止本轮,保留设计;不执行待确认工具 |
|
||||
|
||||
`completed.finishReason` 为 `stop` 或 `tool_calls`。`usage` 为 `{inputTokens,outputTokens,totalTokens}`,上游未提供时为 null。本步 `output` 是历史回填的唯一来源,不再把 text_delta 或 tool_call 额外拼进历史,避免重复。
|
||||
|
||||
**只有完整收到 `completed` 且 `finishReason=tool_calls` 后,才按 output 中的调用顺序执行。** 所有工具参数在上游完整结束后才会被后端验证和交付。截断、参数损坏、未知工具、拒绝、超时或断流不会产生成功 completed;显示过的文字不是执行依据。不要将模型自然语言中的伪工具调用作为命令运行。
|
||||
|
||||
使用带 Authorization 的 POST fetch 读取 SSE,不能使用只支持 GET 的原生 EventSource。下面的读取器处理 UTF-8 分片、跨包事件、CRLF、多行 data 及注释:
|
||||
|
||||
```ts
|
||||
async function* readSse(response: Response) {
|
||||
if (!response.ok) throw await response.json();
|
||||
if (!response.headers.get('content-type')?.includes('text/event-stream') || !response.body)
|
||||
throw new Error('CAD AI 未返回 SSE');
|
||||
const reader = response.body.getReader();
|
||||
const decoder = new TextDecoder('utf-8', { fatal: true });
|
||||
let buffer = '';
|
||||
try {
|
||||
for (;;) {
|
||||
const { value, done } = await reader.read();
|
||||
buffer += decoder.decode(value, { stream: !done });
|
||||
if (buffer.length > 2 * 1024 * 1024) throw new Error('SSE 事件过大');
|
||||
for (;;) {
|
||||
const boundary = /\r?\n\r?\n/.exec(buffer);
|
||||
if (!boundary) break;
|
||||
const block = buffer.slice(0, boundary.index);
|
||||
buffer = buffer.slice(boundary.index + boundary[0].length);
|
||||
let event = 'message';
|
||||
const data: string[] = [];
|
||||
for (const line of block.split(/\r?\n/)) {
|
||||
if (line.startsWith('event:')) event = line.slice(6).trimStart();
|
||||
if (line.startsWith('data:')) data.push(line.slice(5).replace(/^ /, ''));
|
||||
}
|
||||
if (data.length) yield { event, envelope: JSON.parse(data.join('\n')) };
|
||||
}
|
||||
if (done) break;
|
||||
}
|
||||
} finally {
|
||||
await reader.cancel().catch(() => {});
|
||||
reader.releaseLock();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
调用方还必须验证 requestId、文档和轮次关联编码,并要求成功终态;EOF 不等于完成。每次请求使用新的 AbortController,停止时 abort。读取 completed 后可以结束读取本步。
|
||||
|
||||
### 两步请求示例
|
||||
|
||||
第一步请求:
|
||||
|
||||
```json
|
||||
{
|
||||
"protocolVersion": "cad-agent-v1",
|
||||
"documentSessionCode": "document-abc",
|
||||
"turnCode": "turn-001",
|
||||
"history": [{"type":"message","role":"user","content":[{"type":"text","text":"把宽度参数设为 40 mm"}]}],
|
||||
"context": {"documentRevision":"7","selection":[]}
|
||||
}
|
||||
```
|
||||
|
||||
假设本步 SSE 为:
|
||||
|
||||
```text
|
||||
event:tool_call
|
||||
data:{"code":"OK","message":"成功","data":{"documentSessionCode":"document-abc","turnCode":"turn-001","callCode":"call_a","name":"set_parameter","arguments":{"name":"width","value":40}},"requestId":"req-a"}
|
||||
|
||||
event:completed
|
||||
data:{"code":"OK","message":"成功","data":{"documentSessionCode":"document-abc","turnCode":"turn-001","finishReason":"tool_calls","output":[{"type":"toolCall","callCode":"call_a","name":"set_parameter","arguments":{"name":"width","value":40}}],"usage":null},"requestId":"req-a"}
|
||||
|
||||
```
|
||||
|
||||
确认文档仍然有效后执行 `set_parameter`,将 completed.output 和结果依次加入原 history,再次 POST:
|
||||
|
||||
```json
|
||||
{
|
||||
"protocolVersion":"cad-agent-v1",
|
||||
"documentSessionCode":"document-abc",
|
||||
"turnCode":"turn-001",
|
||||
"history":[
|
||||
{"type":"message","role":"user","content":[{"type":"text","text":"把宽度参数设为 40 mm"}]},
|
||||
{"type":"toolCall","callCode":"call_a","name":"set_parameter","arguments":{"name":"width","value":40}},
|
||||
{"type":"toolResult","callCode":"call_a","isError":false,"content":[{"type":"text","text":"{\"name\":\"width\",\"value\":40,\"errors\":[]}"}]}
|
||||
],
|
||||
"context":{"documentRevision":"8","selection":[]}
|
||||
}
|
||||
```
|
||||
|
||||
下一步可能继续调用工具,也可能回复并以 `finishReason=stop` 结束。工具文字结果可以是 JSON 字符串,保留实际错误;不得把失败改成成功。截图结果使用 image 块,同一 callCode 可以附带简短文字说明和图片。
|
||||
|
||||
## SolidCraft 网页工具适配
|
||||
|
||||
能力接口给出的 parameters 是版本化工具 Schema 的来源。现有 `window.solidcraft` 提供 `commands()`、`execute(command,params)`、`inspect(params)` 和 `request(method,params)`。这些是底层控制入口,**不能直接把模型指定的方法名传给 request**,必须经过固定工具适配器和原生 gate。
|
||||
|
||||
| 工具 | 输入概要 | 网页实现及结果要求 |
|
||||
| --- | --- | --- |
|
||||
| `list_commands` | `filter?` | `commands()`,按原生规则过滤编码、名称、面板和工具栏,返回命令目录 |
|
||||
| `describe_command` | `id` | `execute('engine.describe',{command:id})`;id 是引擎命令编码,不是数据库 ID |
|
||||
| `inspect_design` | `measure?,sketches?,joints?` | 基于 inspect,按原生 MCP 语义补齐所需草图及关节详情;不能只透传这些标记给 inspect 后宣称完整实现 |
|
||||
| `execute` | `command,params?,verbose?,expect?` | 执行前核验命令与参数;支持原生 compact 结果和 expect 测量断言,断言失败不自动回滚设计 |
|
||||
| `batch` | `commands,rollback?,coalesce_parameters?,timings?,profile?,verbose?,expect?` | 使用原生 batch 映射和 checkpoint/回滚逻辑,最多 24 步;支持可映射的 set_parameter、measure 等步骤;不允许嵌套 batch |
|
||||
| `measure` | `body?,items?,names_only?,summary?` | 复用 `inspect.measure` 及原生筛选/精简逻辑,items 最多两个;返回尺寸、体积、面积、包围盒等 |
|
||||
| `body_topology` | `body,faces?` | 读取 model.edges/model.faces;faces=cylinders 时按原生逻辑合并圆柱面,不能直接返回全部面假冒合并结果 |
|
||||
| `set_parameter` | `name,value或expression,unit?,comment?` | 映射 parameters.change,value/expression 为别名;返回求值和重建错误 |
|
||||
| `check_parameters` | `set,report?` | 按原生 MCP 的试值、检查、精确恢复逻辑实现,包含 undo 历史;返回 restored,恢复失败必须标为错误并停止本轮 |
|
||||
| `screenshot` | `view或camera?,width?,height?,source?,grid?,axes?` | 只捕获 CAD 画布或模型视图;不捕获平台页面/聊天栏,不写磁盘;压缩为 PNG/JPEG content,view/camera 二选一 |
|
||||
| `undo` | `{}` | 只能撤销本轮已经完成的修改,不能越过本轮起点 |
|
||||
|
||||
原生工具实现可参考 SolidCraft 的 `crates/mcp/src/tools.rs` 和 `crates/ui-egui/src/agent_chat`,但桌面的 CLI/MCP 进程和系统钥匙串不能搬进浏览器。网页 `ChatBackend` 要使用异步 fetch 和事件队列,不阻塞绘制;面板的文本、工具卡和停止操作继续接入现有事件模型。
|
||||
|
||||
后端拒绝已知的文件、设置、跨文档命令,并验证工具外层参数;它没有浏览器的实时命令注册表,因此**前端仍须检查 execute/batch 的每一条实际命令及其嵌套参数**。只允许当前文档内的建模、检查、参数和视图操作,禁止文件路径、打开/替换设计、导出保存、跨文档和应用设置;几何 path 与文件路径按原生规则区分,无法确定时拒绝。直接 execute edit.undo 等命令也必须遵守撤销边界。
|
||||
|
||||
## 工具循环、取消、重试和保存
|
||||
|
||||
每个文档同一时刻只运行一个 Agent 轮次。前端执行器需要:
|
||||
|
||||
1. 固定当前文档实例、轮次、修订标记和撤销起点,开始累计模型调用数及修改命令数。
|
||||
2. 发出一步请求并显示文字及待执行卡片,收到完整 completed 后才交付工具。
|
||||
3. 检查文档与轮次仍然有效,按顺序串行执行;每次自身修改成功后更新预期本地修订。
|
||||
4. 用 `(documentSessionCode,turnCode,callCode)` 缓存执行结果,重复收到同一调用返回缓存,不再次修改。
|
||||
5. 将本步 output 和完整结果加入历史,再推进下一步。达到能力限制时停止循环并提示用户继续发起新消息;batch 按实际修改命令数计入 24 条上限。
|
||||
6. 收到 stop 后结束本轮,合并为一个撤销组,显示可撤销的实际修改数量。
|
||||
|
||||
请求失败不自动重试。模型未发出 completed 前没有工具可执行,用户可重试该步;工具已经执行后,重试必须携带对应结果,不能重新发送执行前历史。执行状态不确定时先检查设计,不能假设失败并重放。工具结果已知失败可回传给模型,未知是否应用则停止本轮让用户处理。
|
||||
|
||||
取消、超时、切换文档或新聊天时废弃轮次,并取消网络及所有未执行任务。正在内核运行的单次命令可能无法立即中断,必须等其状态确定后才允许新轮次开始;迟到的模型回复不能进入新文档。保留已完成修改,不自动恢复旧快照。继续保留聊天时,给已交付但未执行的调用补齐 `isError=true` 的“本轮已停止,未执行”结果;实际执行状态不确定的结果明确标记,禁止自动继续。
|
||||
|
||||
用户手动建模造成修订变化时停止当前轮次,避免在旧上下文上继续修改。停止后可撤销本轮修改;如果之后已经有手动或新 AI 修改,禁用旧消息的“撤销这些更改”,使用正常撤销历史处理。
|
||||
|
||||
AI 修改后只标记为未保存。执行本轮期间暂停云端保存,正常结束或停止后使用既有 `.sc` 上传、确认接口,确认成功才显示云端已保存。保存过程中的版本冲突仍按工作空间规则处理。401 后保留本地设计,登录恢复后核对账号和项目归属再继续。
|
||||
|
||||
## 错误和部署配置
|
||||
|
||||
| HTTP / code | 处理 |
|
||||
| --- | --- |
|
||||
| 400 BAD_REQUEST / CAD_AI_INVALID_HISTORY / CAD_AI_INVALID_TOOL | 修复请求、历史对应关系、图片或工具参数 |
|
||||
| 401 UNAUTHORIZED | 保留设计,恢复登录;清理其他账号的请求与会话 |
|
||||
| 404 NOT_FOUND | 项目不存在、非本人或已删除,停止对该项目继续请求 |
|
||||
| 409 CAD_AI_PROTOCOL_MISMATCH | 更新编辑器与工具适配器 |
|
||||
| 413 REQUEST_TOO_LARGE / CAD_AI_INPUT_TOO_LARGE | 压缩截图、精简工具查询或裁剪完整历史轮次 |
|
||||
| 429 CAD_AI_RATE_LIMITED / CAD_AI_BUSY | 按 Retry-After 等待,不自动重放建模 |
|
||||
| 502 CAD_AI_PROVIDER_FAILURE | 模型输出或服务异常,保留设计和已知执行结果 |
|
||||
| 503 CAD_AI_UNAVAILABLE / REDIS_UNAVAILABLE | 功能未开启、配置不全或依赖不可用 |
|
||||
| 504 CAD_AI_TIMEOUT | 停止本轮,保留已完成修改 |
|
||||
| SSE error 的其他 code | 展示 message,保留设计并停止本轮 |
|
||||
|
||||
SSE 已建立后的错误以 error 事件返回,HTTP 仍可能是 200。服务端在客户端断开、超时和关停时取消上游并关闭响应体;并发许可在工作线程退出后释放,避免上游未停就接入更多任务。
|
||||
|
||||
```yaml
|
||||
vibemake:
|
||||
cad:
|
||||
ai:
|
||||
enabled: ${CAD_AI_ENABLED:false}
|
||||
model: ${CAD_AI_MODEL:${vibemake.ai.model}}
|
||||
request-timeout: ${CAD_AI_REQUEST_TIMEOUT:60s}
|
||||
heartbeat-interval: 10s
|
||||
max-concurrent: ${CAD_AI_MAX_CONCURRENT:4}
|
||||
requests-per-minute: ${CAD_AI_REQUESTS_PER_MINUTE:30}
|
||||
max-model-calls-per-turn: ${CAD_AI_MAX_MODEL_CALLS_PER_TURN:12}
|
||||
max-changes-per-turn: ${CAD_AI_MAX_CHANGES_PER_TURN:24}
|
||||
```
|
||||
|
||||
连接复用 `ARK_API_KEY`、`ARK_ENDPOINT`、`ARK_MODEL`,不增加 CAD 专用密钥或地址。CAD 开关独立于社区 AI 的 `AI_ENABLED`;设置 CAD_AI_ENABLED=true 后还必须具备有效共享配置。CAD_AI_MODEL 留给需要单独指定已开通模型的环境,默认使用共享模型。上游采用 Responses API、关闭深度思考并设置 store=false,不依赖上游响应历史。
|
||||
|
||||
频率限制通过 Redis 共享,每次推理请求(含续调)计数;模型并发上限按后端实例计算。12 次推理和 24 条修改是网页执行器每个用户轮次的限制,后端能力接口提供该值,不持久跟踪浏览器的整轮操作。日志仅记录关联编码、模型、耗时、用量及错误,不能增加完整聊天或 Base64 调试输出。
|
||||
|
||||
网关仅对该 POST 接口允许 4 MiB 请求体,关闭 SSE 缓冲及缓存,读取超时大于模型请求超时并留出余量(默认建议 90 秒)。后端设置 X-Accel-Buffering:no,并每 10 秒发送心跳;具体网关仍需对应配置。其他接口正文配额不变,不改 OSS 或数据库。
|
||||
|
||||
上线顺序:部署后端且 CAD_AI_ENABLED=false → 前端适配 → 测试环境启用并完成真实模型联调 → 验收后生产启用。关闭开关会拒绝新请求;已经开始的请求按原有超时或客户端停止结束。必须使用已开通且支持工具调用和图片理解的模型。
|
||||
|
||||
## 联合验收清单
|
||||
|
||||
- 同一平台账号进入空白设计或本人项目,可以连续聊天、建模和修改参数,其他用户和删除项目不可访问。
|
||||
- 工具卡显示真实结果,截图和选区能够进入模型上下文;工具执行前必须等到成功终态。
|
||||
- 一条消息对应一个撤销组;停止后无后续排队命令,后续编辑不会被旧消息撤销覆盖。
|
||||
- 切换文档、断流、请求重试和重复事件不会执行到错误文档或重复建模。
|
||||
- 手动保存后刷新并重新打开 `.sc` 仍能编辑;聊天不恢复;AI 失败与登录过期不丢失本地修改。
|
||||
- 浏览器构建及 API 响应中没有模型密钥;真实豆包工具调用、识图和流式输出均验证通过。
|
||||
|
||||
自动化模型替身和 HTTP 模拟服务覆盖后端协议及故障场景,不代表上述 SolidCraft 网页适配已经完成,也不替代真实模型、撤销和云端保存联调。
|
||||
|
||||
后端提供默认跳过的 `ArkCadAiLiveTest`,验证当前配置模型的原生工具调用,以及 screenshot 图片结果回填后的识图。它只发送公开提示和生成的红色矩形图片,不读取真实 CAD。部署前在已安全注入 ARK_API_KEY、可选 ARK_MODEL / ARK_ENDPOINT / CAD_AI_MODEL 的环境中显式运行(会产生模型调用费用):
|
||||
|
||||
```sh
|
||||
VIBEMAKE_CAD_AI_LIVE_TEST=true mvn -pl vibemake-service -am \
|
||||
-Dtest=ArkCadAiLiveTest -Dsurefire.failIfNoSpecifiedTests=false test
|
||||
```
|
||||
|
||||
这两项通过后,仍需完成浏览器内实际建模、撤销和云端保存联调。
|
||||
@@ -1,5 +1,7 @@
|
||||
# CAD 个人工作空间前端对接
|
||||
|
||||
网页 AI 助手使用独立的 `/api/cad/ai` 接口,复用平台登录,工具由浏览器执行;接口、工具循环、停止及撤销适配见 [CAD Web AI Agent 对接](frontend-cad-ai-agent.md)。AI 修改仍通过本文的原生 `.sc` 流程手动保存。
|
||||
|
||||
CAD 与 Vibemake 共用 `/api/auth/login`、`/api/auth/logout` 和 `/api/users/me`,使用同一个 `Authorization: Bearer <平台 token>`。CAD 工作空间独立于现有 `/api/workspace/projects`,不创建 Git 仓库、不自动发布社区。只支持当前用户的单个自包含原生 `.sc` 设计文件,不管理外部引用的多文件装配。
|
||||
|
||||
文件沿用现有 OSS 资源规则:上传继承 Bucket 权限,读取使用 `OSS_PUBLIC_BASE_URL` 对应的普通 OSS/CDN 地址。工作空间和平台接口按用户隔离,文件直链的访问权限由现有 Bucket/CDN 配置决定;公开配置下,拿到直链即可读取文件。
|
||||
|
||||
@@ -10,6 +10,8 @@ ZIP、TAR.GZ 下载和 HTTPS Git 本地开发的独立前端交付文档见 [仓
|
||||
|
||||
CAD 个人工作空间使用独立的 `/api/cad/workspace/projects`,共用登录,但不创建 Git 仓库、不混入现有项目列表。接口、保存续编流程和共用 OSS 配置见 [CAD 工作空间前端对接](frontend-cad-workspace.md),上线前执行 [CAD 建表 SQL](cad-database.md)。
|
||||
|
||||
CAD 网页 AI Agent 使用 `/api/cad/ai/capabilities` 和 `/api/cad/ai/chat`,支持流式回复及浏览器执行的 CAD 工具调用,复用豆包连接配置。功能默认关闭,聊天不落库;完整协议及 SolidCraft 网页适配要求见 [CAD AI Agent 前端对接](frontend-cad-ai-agent.md)。
|
||||
|
||||
## 阅读导航
|
||||
|
||||
- [接入约定](#接入约定)
|
||||
|
||||
Reference in New Issue
Block a user