AI 能力底座 内部 API

模型接入、场景试运行、Agent 工具 / 技能、MCP 接入等内部接口。

权限码为接口所需权限标识。

AiAccessController

• 基础路径：/ai/access
• 类级权限：@ss.hasPermi('ai:access:query')

方法	路径	权限	说明
GET	/ai/access/app/list	@ss.hasPermi('ai:access:query')
GET	/ai/access/app/{appId}	@ss.hasPermi('ai:access:query')
POST	/ai/access/app	@ss.hasPermi('ai:access:add')
PUT	/ai/access/app	@ss.hasPermi('ai:access:edit')
DELETE	/ai/access/app/{appIds}	@ss.hasPermi('ai:access:remove')
GET	/ai/access/scene/list	@ss.hasPermi('ai:access:query')
GET	/ai/access/scene/{sceneId}	@ss.hasPermi('ai:access:query')
POST	/ai/access/scene	@ss.hasPermi('ai:access:add')
PUT	/ai/access/scene	@ss.hasPermi('ai:access:edit')
DELETE	/ai/access/scene/{sceneIds}	@ss.hasPermi('ai:access:remove')
GET	/ai/access/widget/list	@ss.hasPermi('ai:access:query')
POST	/ai/access/widget	@ss.hasPermi('ai:access:add')
PUT	/ai/access/widget	@ss.hasPermi('ai:access:edit')
DELETE	/ai/access/widget/{widgetIds}	@ss.hasPermi('ai:access:remove')
GET	/ai/access/mount/list	@ss.hasPermi('ai:access:query')
GET	/ai/access/mount/{mountId}	@ss.hasPermi('ai:access:query')
POST	/ai/access/mount	@ss.hasPermi('ai:access:add')
PUT	/ai/access/mount	@ss.hasPermi('ai:access:edit')
DELETE	/ai/access/mount/{mountIds}	@ss.hasPermi('ai:access:remove')
GET	/ai/access/scope/list	@ss.hasPermi('ai:access:query')
POST	/ai/access/scope	@ss.hasPermi('ai:access:add')
PUT	/ai/access/scope	@ss.hasPermi('ai:access:edit')
DELETE	/ai/access/scope/{scopeIds}	@ss.hasPermi('ai:access:remove')
GET	/ai/access/meta	@ss.hasPermi('ai:access:query')
POST	/ai/access/try	@ss.hasPermi('ai:access:run')	试运行：用当前登录身份真调一次场景（走与线上一致的鉴权 + 数据域链路）。

AiMcpServerController

• 基础路径：/ai/mcp
• 类级权限：@ss.hasPermi('train:ai:mcp:list')

方法	路径	权限	说明
GET	/ai/mcp/list	@ss.hasPermi('train:ai:mcp:list')
GET	/ai/mcp/{serverId}	@ss.hasPermi('train:ai:mcp:list')
POST	/ai/mcp	@ss.hasPermi('train:ai:mcp:add')
PUT	/ai/mcp	@ss.hasPermi('train:ai:mcp:edit')
PUT	/ai/mcp/state	@ss.hasPermi('train:ai:mcp:edit')
DELETE	/ai/mcp/{serverIds}	@ss.hasPermi('train:ai:mcp:remove')
POST	/ai/mcp/test	@ss.hasPermi('train:ai:mcp:test')	连接测试：真连一次并列出工具。
POST	/ai/mcp/reload	@ss.hasPermi('train:ai:mcp:edit')	连接测试：真连一次并列出工具。

AiSkillController

• 基础路径：/ai/skill
• 类级权限：@ss.hasPermi('train:ai:skill:list')

方法	路径	权限	说明
GET	/ai/skill/list	@ss.hasPermi('train:ai:skill:list')
GET	/ai/skill/enabled	@ss.hasPermi('train:ai:skill:list')
GET	/ai/skill/{skillId}	@ss.hasPermi('train:ai:skill:list')
POST	/ai/skill	@ss.hasPermi('train:ai:skill:add')
PUT	/ai/skill	@ss.hasPermi('train:ai:skill:edit')
POST	/ai/skill/generate	@ss.hasPermi('train:ai:skill:add')	一句话生成技能草稿：入参 {@code {"requirement":"..."}}。
POST	/ai/skill/upload	@ss.hasPermi('train:ai:skill:edit')
DELETE	/ai/skill/{skillIds}	@ss.hasPermi('train:ai:skill:remove')
POST	/ai/skill/import	@ss.hasPermi('train:ai:skill:edit')

AiHarnessController

• 基础路径：/ai/harness
• 类级权限：@ss.hasPermi('train:ai:model:test')

方法	路径	权限	说明
POST	/ai/harness/probe	@ss.hasPermi('train:ai:model:test')	真实调用一次模型，验证 harness 通道。

AiRunController

• 基础路径：/ai

方法	路径	权限	说明
GET	/ai/manifest
POST	/ai/attachment/upload
POST	/ai/run
POST	/ai/run/task		提交异步长任务：立即返回任务ID，结果稍后取。
GET	/ai/run/task/{taskId}		查询异步任务（status：0 处理中 / 1 成功 / 2 失败）。
POST	/ai/run/task/{taskId}/watch		实时订阅一个任务的执行过程（SSE 推送）。
GET	/ai/run/task/{taskId}/delta		取「边跑边看」的增量（游标式）。
GET	/ai/run/tasks		我的历史任务 —— 「关掉页面再打开还能看到之前的内容」靠它。

AiMcpServerConfigController

• 基础路径：/ai/mcp-server
• 类级权限：@ss.hasPermi('train:ai:mcpserver:list')

方法	路径	权限	说明
GET	/ai/mcp-server/status	@ss.hasPermi('train:ai:mcpserver:list')
GET	/ai/mcp-server/calls	@ss.hasPermi('train:ai:mcpserver:list')	对外调用日志（分页 + 按能力/主体/状态筛选）。
PUT	/ai/mcp-server/config	@ss.hasPermi('train:ai:mcpserver:edit')
POST	/ai/mcp-server/token/generate	@ss.hasPermi('train:ai:mcpserver:edit')
POST	/ai/mcp-server/selftest	@ss.hasPermi('train:ai:mcpserver:test')	自测：以指定代理主体跑一次能力，看外部系统会拿到什么。