diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/starops/2026-04-28/api-docs.php | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/zh_cn/starops/2026-04-28/api-docs.php')
| -rw-r--r-- | data/zh_cn/starops/2026-04-28/api-docs.php | 3750 |
1 files changed, 3750 insertions, 0 deletions
diff --git a/data/zh_cn/starops/2026-04-28/api-docs.php b/data/zh_cn/starops/2026-04-28/api-docs.php new file mode 100644 index 0000000..818c425 --- /dev/null +++ b/data/zh_cn/starops/2026-04-28/api-docs.php @@ -0,0 +1,3750 @@ +<?php return [ + 'version' => '1.0', + 'info' => ['style' => 'ROA', 'product' => 'STAROps', 'version' => '2026-04-28'], + 'directories' => [ + [ + 'children' => ['CreateDigitalEmployee', 'GetDigitalEmployee', 'UpdateDigitalEmployee', 'ListDigitalEmployees', 'DeleteDigitalEmployee'], + 'type' => 'directory', + 'title' => '数字员工', + 'id' => 452416, + ], + [ + 'children' => ['CreateThread', 'GetThread', 'UpdateThread', 'GetThreadData', 'ListThreads', 'DeleteThread', 'CreateChat'], + 'type' => 'directory', + 'title' => '会话', + 'id' => 452417, + ], + [ + 'children' => ['CreateDigitalEmployeeSkill', 'GetDigitalEmployeeSkill', 'ListDigitalEmployeeSkillVersions', 'UpdateDigitalEmployeeSkill', 'ListDigitalEmployeeSkills', 'DeleteDigitalEmployeeSkill'], + 'type' => 'directory', + 'title' => '技能', + 'id' => 452418, + ], + [ + 'children' => ['CreateMcpService', 'GetMcpService', 'UpdateMcpService', 'DeleteMcpService', 'ListMcpServices', 'FetchRemoteMcpTools'], + 'type' => 'directory', + 'title' => 'MCP管理', + 'id' => 452419, + ], + [ + 'children' => ['ListArtifacts', 'GetArtifact'], + 'type' => 'directory', + 'title' => '产物', + 'id' => 452420, + ], + [ + 'children' => ['CreateTicket'], + 'type' => 'directory', + 'title' => '控制台内嵌', + 'id' => 452421, + ], + ], + 'components' => [ + 'schemas' => [ + 'Tag' => [ + 'title' => '标签', + 'description' => '标签', + 'type' => 'object', + 'properties' => [ + 'key' => ['title' => '标签键', 'description' => '标签键', 'type' => 'string', 'example' => 'test-key', 'maxLength' => 128], + 'value' => ['title' => '标签值', 'description' => '标签值', 'type' => 'string', 'example' => 'test-value', 'maxLength' => 256], + ], + ], + ], + ], + 'apis' => [ + 'CreateChat' => [ + 'path' => '/chat', + 'methods' => ['post'], + 'schemes' => ['https', 'sse'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/octet-stream'], + 'produces' => ['application/octet-stream'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求结构体', + 'type' => 'object', + 'properties' => [ + 'digitalEmployeeName' => ['description' => '数字员工名称', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'threadId' => ['description' => '会话线程 ID', 'type' => 'string', 'required' => false, 'example' => 'thread_id01'], + 'action' => ['description' => '操作类型: create(默认), reconnect, stop', 'type' => 'string', 'required' => false, 'example' => 'create'], + 'variables' => ['description' => '变量列表', 'type' => 'object', 'required' => false, 'example' => '{'."\n" + .' "workspace": "test",'."\n" + .' "region": "cn-beijing",'."\n" + .' "project": "test",'."\n" + .' "language": "zh",'."\n" + .' "timeZone": "Asia/Shanghai",'."\n" + .' "timeStamp": "1768893948",'."\n" + .' "startTime": 1768887171,'."\n" + .' "endTime": 1768890771,'."\n" + .' "skill": "trace"'."\n" + .'}'], + 'messages' => [ + 'description' => '消息列表', + 'type' => 'array', + 'items' => [ + 'description' => '消息', + 'type' => 'object', + 'properties' => [ + 'messageId' => ['description' => '当前消息唯一标识', 'type' => 'string', 'required' => false, 'example' => 'message_id02'], + 'role' => ['description' => '消息的角色', 'type' => 'string', 'required' => false, 'example' => 'system'], + 'contents' => [ + 'description' => '文本或多模态数组', + 'type' => 'array', + 'items' => [ + 'description' => '文本或多模态', + 'type' => 'object', + 'properties' => [ + 'type' => ['description' => '内容类型', 'type' => 'string', 'required' => false, 'example' => 'text'], + 'value' => ['description' => '内容的值', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + 'required' => false, + ], + 'required' => false, + ], + 'tools' => [ + 'description' => '工具调用列表', + 'type' => 'array', + 'items' => ['description' => '工具调用', 'type' => 'object', 'required' => false, 'example' => '{'."\n" + .' "arguments": {'."\n" + .' "confidence": "high",'."\n" + .' "intent": "analyser",'."\n" + .' "is_new_turn": true,'."\n" + .' "language": "en",'."\n" + .' "title": "Root Cause of Alert"'."\n" + .' },'."\n" + .' "id": "IntentRecognition",'."\n" + .'}'], + 'required' => false, + ], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'messages' => [ + 'title' => '会话的消息列表', + 'description' => '会话的消息列表', + 'type' => 'array', + 'items' => [ + 'title' => '消息数据明细结构', + 'description' => '消息数据明细结构', + 'type' => 'object', + 'properties' => [ + 'version' => ['title' => '消息版本号', 'description' => '消息版本号', 'type' => 'string', 'example' => 'v0.1.0'], + 'parentCallId' => ['title' => '上一层级执行ID', 'description' => '上一层级执行ID', 'type' => 'string', 'example' => 'sess_abc123'], + 'callId' => ['title' => '当前执行ID', 'description' => '当前执行ID', 'type' => 'string', 'example' => 'call_search_001'], + 'role' => ['title' => '消息发起角色', 'description' => '消息发起角色', 'type' => 'string', 'example' => 'tool'], + 'seq' => ['title' => '消息序列号', 'description' => '消息序列号', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'timestamp' => ['title' => 'timestamp / 纳秒', 'description' => 'timestamp / 纳秒', 'type' => 'string', 'example' => '1765000005'], + 'type' => ['title' => '消息具体类型', 'description' => '消息具体类型', 'type' => 'string', 'example' => 'done'], + 'detail' => ['title' => '消息明细', 'description' => '消息明细', 'type' => 'string', 'example' => 'test'], + 'contents' => [ + 'title' => '内容信息', + 'description' => '内容信息', + 'type' => 'array', + 'items' => ['title' => '内容信息明细结构', 'description' => '内容信息明细结构', 'type' => 'object', 'example' => '{'."\n" + .' "append": false,'."\n" + .' "lastChunk": false,'."\n" + .' "type": "text",'."\n" + .' "value": "result output chunk"'."\n" + .'}'], + ], + 'tools' => [ + 'title' => '工具使用列表', + 'description' => '工具使用列表', + 'type' => 'array', + 'items' => ['title' => '工具明细结构', 'description' => '工具明细结构', 'type' => 'object', 'example' => '{'."\n" + .' "arguments": {'."\n" + .' "confidence": "high",'."\n" + .' "intent": "analyser",'."\n" + .' "is_new_turn": true,'."\n" + .' "language": "en",'."\n" + .' "title": "Root Cause of Alert"'."\n" + .' },'."\n" + .' "id": "IntentRecognition",'."\n" + .' "name": "IntentRecognition",'."\n" + .' "status": "start",'."\n" + .' "toolCallId": "019bc1cb-adad"'."\n" + .'}'], + ], + 'agents' => [ + 'title' => '调用的Agent列表', + 'description' => '调用的Agent列表', + 'type' => 'array', + 'items' => ['title' => '调用的Agent详细内容', 'description' => '调用的Agent详细内容', 'type' => 'object', 'example' => '{'."\n" + .' "callId": "019bc1cb-adad",'."\n" + .' "id": "analyser",'."\n" + .' "inputs": ['."\n" + .' {'."\n" + .' "append": false,'."\n" + .' "lastChunk": false,'."\n" + .' "type": "text",'."\n" + .' "value": "Analyze this trace: TraceID=xxx"'."\n" + .' }'."\n" + .' ],'."\n" + .' "name": "analyser",'."\n" + .' "status": "start"'."\n" + .'}'], + ], + 'events' => [ + 'title' => '事件列表', + 'description' => '事件列表', + 'type' => 'array', + 'items' => ['title' => '事件详细内容', 'description' => '事件详细内容', 'type' => 'object', 'example' => '{'."\n" + .' "payload": {'."\n" + .' "error": {'."\n" + .' "code": "TASK_FAILED",'."\n" + .' "message": "Invalid task parameter",'."\n" + .' "suggestion": ""'."\n" + .' },'."\n" + .' "statistics": {'."\n" + .' "duration": 300000'."\n" + .' },'."\n" + .' "success": false'."\n" + .' },'."\n" + .' "type": "task_finished"'."\n" + .'}'], + ], + 'artifacts' => [ + 'title' => '产物产出信息', + 'description' => '产物产出信息', + 'type' => 'array', + 'items' => ['title' => '产物明细的结构', 'description' => '产物明细的结构', 'type' => 'object', 'example' => '{'."\n" + .' "artifactId": "019bc1cb-9600-703axxx",'."\n" + .' "name": "sql output",'."\n" + .' "description": "sql generation task result",'."\n" + .' "extensions": ["sql_generation_tool", "sql_diagnosis"],'."\n" + .' "metadata": {'."\n" + .' "model": "qwen3-coder-plus"'."\n" + .' },'."\n" + .' "parts": ['."\n" + .' {'."\n" + .' "text": "select * from table",'."\n" + .' "kind": "text"'."\n" + .' }'."\n" + .' ]'."\n" + .'}'], + ], + ], + ], + ], + 'traceId' => ['title' => '当前message请求的id数据'."\n" + .'根数据中第一个追踪ID', 'description' => '当前message请求的id数据'."\n" + .'根数据中第一个追踪ID', 'type' => 'string', 'example' => '21504600000008405622576e3b48'], + 'requestId' => ['title' => '当前message请求的id数据'."\n" + .'根数据中第一个RequestID', 'description' => '当前message请求的id数据'."\n" + .'根数据中第一个RequestID', 'type' => 'string', 'example' => '0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '发起会话', + 'summary' => '创建对话', + 'description' => '发起会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:CreateChat', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"messages\\": [\\n {\\n \\"version\\": \\"v0.1.0\\",\\n \\"parentCallId\\": \\"sess_abc123\\",\\n \\"callId\\": \\"call_search_001\\",\\n \\"role\\": \\"tool\\",\\n \\"seq\\": 1,\\n \\"timestamp\\": \\"1765000005\\",\\n \\"type\\": \\"done\\",\\n \\"detail\\": \\"test\\",\\n \\"contents\\": [\\n {\\n \\"append\\": false,\\n \\"lastChunk\\": false,\\n \\"type\\": \\"text\\",\\n \\"value\\": \\"result output chunk\\"\\n }\\n ],\\n \\"tools\\": [\\n {\\n \\"arguments\\": {\\n \\"confidence\\": \\"high\\",\\n \\"intent\\": \\"analyser\\",\\n \\"is_new_turn\\": true,\\n \\"language\\": \\"en\\",\\n \\"title\\": \\"Root Cause of Alert\\"\\n },\\n \\"id\\": \\"IntentRecognition\\",\\n \\"name\\": \\"IntentRecognition\\",\\n \\"status\\": \\"start\\",\\n \\"toolCallId\\": \\"019bc1cb-adad\\"\\n }\\n ],\\n \\"agents\\": [\\n {\\n \\"callId\\": \\"019bc1cb-adad\\",\\n \\"id\\": \\"analyser\\",\\n \\"inputs\\": [\\n {\\n \\"append\\": false,\\n \\"lastChunk\\": false,\\n \\"type\\": \\"text\\",\\n \\"value\\": \\"Analyze this trace: TraceID=xxx\\"\\n }\\n ],\\n \\"name\\": \\"analyser\\",\\n \\"status\\": \\"start\\"\\n }\\n ],\\n \\"events\\": [\\n {\\n \\"payload\\": {\\n \\"error\\": {\\n \\"code\\": \\"TASK_FAILED\\",\\n \\"message\\": \\"Invalid task parameter\\",\\n \\"suggestion\\": \\"\\"\\n },\\n \\"statistics\\": {\\n \\"duration\\": 300000\\n },\\n \\"success\\": false\\n },\\n \\"type\\": \\"task_finished\\"\\n }\\n ],\\n \\"artifacts\\": [\\n {\\n \\"artifactId\\": \\"019bc1cb-9600-703axxx\\",\\n \\"name\\": \\"sql output\\",\\n \\"description\\": \\"sql generation task result\\",\\n \\"extensions\\": [\\n \\"sql_generation_tool\\",\\n \\"sql_diagnosis\\"\\n ],\\n \\"metadata\\": {\\n \\"model\\": \\"qwen3-coder-plus\\"\\n },\\n \\"parts\\": [\\n {\\n \\"text\\": \\"select * from table\\",\\n \\"kind\\": \\"text\\"\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"traceId\\": \\"21504600000008405622576e3b48\\",\\n \\"requestId\\": \\"0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0\\"\\n}","type":"json"}]', + ], + 'CreateDigitalEmployee' => [ + 'summary' => '创建DigitalEmployee', + 'path' => '/digital-employee', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], + 'parameters' => [ + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '数字员工结构', + 'type' => 'object', + 'properties' => [ + 'defaultRule' => ['description' => '数字员工默认规则。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'description' => ['description' => '数字员工描述信息。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'aaa', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'displayName' => ['description' => '数字员工显示名称。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'digial-employee-test'."\n", 'maxLength' => 128, 'minLength' => 0, 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'roleArn' => ['description' => 'RAM 角色 ARN。', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => 'acs:ram::12345678912:role/testrole'."\n", 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'name' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + 'knowledges' => [ + 'description' => '知识库列表', + 'type' => 'object', + 'properties' => [ + 'bailian' => [ + 'description' => '百练知识库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '百练知识库列表。', + 'type' => 'object', + 'properties' => [ + 'workspaceId' => ['description' => '百练工作空间 ID。', 'type' => 'string', 'required' => false, 'example' => 'llm-xxxxx'."\n"], + 'indexId' => ['description' => '百练索引 ID。', 'type' => 'string', 'required' => false, 'example' => 'index-xxxx'."\n"], + 'region' => ['description' => '知识库地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'."\n"], + 'attributes' => ['description' => '知识库属性。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + 'required' => false, + ], + 'required' => false, + ], + 'sop' => [ + 'description' => 'SOP 知识库列表', + 'type' => 'array', + 'items' => ['description' => 'SOP 知识库', 'type' => 'object', 'required' => false, 'example' => ' {'."\n" + .' "type": "oss",'."\n" + .' "basePath": "docs/",'."\n" + .' "region": "cn-hangzhou",'."\n" + .' "endpoint": "oss-cn-hangzhou.aliyuncs.com",'."\n" + .' "bucket": "my-sop-bucket",'."\n" + .' "description": "sls sop"'."\n" + .' }'], + 'required' => false, + ], + ], + 'required' => false, + ], + 'resourceGroupId' => ['title' => '资源组 ID', 'description' => '资源组 ID', 'type' => 'string', 'required' => false, 'example' => 'rg-ae******ey'], + 'tags' => [ + 'title' => '标签', + 'description' => '标签', + 'type' => 'array', + 'items' => ['title' => '标签', 'description' => '标签', 'required' => false, '$ref' => '#/components/schemas/Tag'], + 'required' => false, + ], + 'attributes' => [ + 'title' => '属性', + 'type' => 'object', + 'deprecated' => false, + 'additionalProperties' => ['type' => 'string'], + 'readOnly' => false, + ], + 'toolPolicy' => [ + 'title' => '工具策略', + 'description' => '数字员工工具调用安全策略配置。', + 'type' => 'object', + 'properties' => [ + 'aliyun' => [ + 'description' => 'Aliyun MCP 工具调用安全策略配置。', + 'type' => 'object', + 'properties' => [ + 'enable' => ['description' => '是否启用 Aliyun MCP 工具策略。', 'type' => 'boolean', 'example' => 'true'], + 'statements' => [ + 'description' => 'Aliyun OpenAPI 工具策略语句列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单条 Aliyun OpenAPI 工具策略语句。', + 'type' => 'object', + 'properties' => [ + 'decision' => [ + 'description' => '命中该 API 后的执行策略。', + 'type' => 'string', + 'example' => 'user_ack', + 'enum' => ['deny', 'user_ack', 'allow'], + ], + 'product' => ['description' => '本条语句对应的 Aliyun OpenAPI 产品名。', 'type' => 'string', 'required' => false, 'example' => 'Sls'], + 'apiVersion' => ['description' => '本条语句对应的 Aliyun OpenAPI API 版本。', 'type' => 'string', 'required' => false, 'example' => '2020-12-30'], + 'actions' => [ + 'description' => 'Aliyun OpenAPI Action 列表，格式为 product:ApiName、product:Prefix* 或 product:*。', + 'type' => 'array', + 'items' => ['type' => 'string', 'example' => 'log:GetProject'], + 'example' => '["log:GetProject","log:CreateDashboard"]', + ], + ], + 'example' => '{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}', + ], + 'example' => '[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]', + ], + ], + 'example' => '{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}', + ], + ], + 'example' => '{"aliyun":{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}}', + ], + 'sandboxNetworkPolicy' => [ + 'title' => '沙箱网络策略', + 'description' => '数字员工沙箱网络 ACL 策略配置。', + 'type' => 'object', + 'properties' => [ + 'allowFqdns' => [ + 'description' => '允许访问的 FQDN 列表，最多 50 个。', + 'type' => 'array', + 'items' => ['type' => 'string'], + 'maxItems' => 50, + ], + 'allowCidrs' => [ + 'description' => '允许访问的 CIDR 或 IP 列表，最多 50 个。', + 'type' => 'array', + 'items' => ['type' => 'string'], + 'maxItems' => 50, + ], + 'enableAcl' => ['description' => '是否启用沙箱网络 ACL。', 'type' => 'boolean', 'example' => 'false'], + ], + 'example' => '{"allowFqdns":["api.example.com"],"allowCidrs":["1.2.3.0/24","8.8.8.8"],"enableAcl":false}', + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '3B311FD9-A60B-55E0-A896-A0C73*********'."\n"], + 'name' => ['description' => '数字员工名称。', 'type' => 'string', 'example' => 'test'], + ], + 'description' => '', + ], + ], + ], + 'title' => '创建数字员工', + 'description' => '创建数字员工', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + 'additionalActions' => [ + ['action' => 'ram:PassRole', 'validationType' => 'always'], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"3B311FD9-A60B-55E0-A896-A0C73*********\\\\n\\",\\n \\"name\\": \\"test\\"\\n}","type":"json"}]', + ], + 'CreateDigitalEmployeeSkill' => [ + 'path' => '/digitalEmployee/{name}/skill', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求 Body', + 'type' => 'object', + 'properties' => [ + 'skillName' => ['description' => '技能名称', 'type' => 'string', 'required' => true, 'example' => 'skill', 'minLength' => 1], + 'displayName' => ['description' => '技能显示名称', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'description' => ['description' => '技能描述', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'true'], + 'files' => [ + 'description' => '技能文件列表', + 'type' => 'array', + 'items' => [ + 'description' => '技能文件', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => '名称', 'type' => 'string', 'required' => false, 'example' => 'SKILL.md'."\n"], + 'content' => ['description' => '文件内容', 'type' => 'string', 'required' => false, 'example' => '---'."\n" + .'name: skill'."\n" + .'description: description'."\n" + .'---'."\n" + ."\n" + .'# skill '."\n" + ."\n" + .'skill test'], + ], + 'required' => false, + ], + 'required' => true, + ], + 'remark' => ['description' => '备注', 'type' => 'string', 'required' => false, 'example' => 'remark'], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => 'Id of the request', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'skillName' => ['description' => '技能名称', 'type' => 'string', 'example' => 'skill'], + ], + 'description' => '', + ], + ], + ], + 'title' => '创建技能', + 'summary' => '创建技能', + 'description' => '创建技能', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"skillName\\": \\"skill\\"\\n}","type":"json"}]', + ], + 'CreateMcpService' => [ + 'path' => '/digitalEmployee/{name}/mcpService', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test-agent', 'minLength' => 1], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'mcpServiceName' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'required' => true, 'example' => 'log-query', 'minLength' => 1], + 'displayName' => ['description' => 'MCP 服务显示名称。', 'type' => 'string', 'required' => false, 'example' => '日志查询'], + 'description' => ['description' => 'MCP 服务描述信息。', 'type' => 'string', 'required' => false, 'example' => '通过 MCP 调用日志查询工具。'], + 'enable' => ['description' => '是否启用 MCP 服务。', 'type' => 'boolean', 'required' => true, 'example' => 'true', 'default' => 'true'], + 'network' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'mode' => [ + 'description' => 'MCP 服务网络访问模式，支持 public 和 vpc。', + 'type' => 'string', + 'required' => true, + 'example' => 'public', + 'enum' => ['public', 'vpc'], + ], + 'vpcId' => ['description' => '专有网络 VPC ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-xxx'], + 'vswId' => ['description' => '交换机 ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-xxx'], + 'accessIp' => ['description' => 'VPC 网络下访问 MCP 服务的 IP 地址。', 'type' => 'string', 'required' => false, 'example' => '10.0.0.12'], + 'accessPort' => ['description' => 'VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '8080'], + 'securityGroupId' => ['description' => '安全组 ID。', 'type' => 'string', 'required' => false, 'example' => 'sg-xxx'], + 'gatewayId' => ['description' => '网关 ID。', 'type' => 'string', 'required' => false, 'example' => 'gw-xxx'], + 'mcpServerId' => ['description' => 'MCP Server 实例 ID。', 'type' => 'string', 'required' => false, 'example' => 'mcp-xxx'], + 'region' => ['description' => 'VPC 网络所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + 'required' => true, + ], + 'connection' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'platform' => [ + 'description' => 'MCP 服务平台类型，支持 AIGateway 和 Custom。', + 'type' => 'string', + 'required' => true, + 'enumValueTitles' => ['AIGateway' => 'AIGateway', 'Custom' => 'Custom'], + 'example' => 'Custom', + 'enum' => ['AIGateway', 'Custom'], + ], + 'transport' => [ + 'description' => 'MCP 服务传输协议，支持 http 和 sse。', + 'type' => 'string', + 'required' => true, + 'example' => 'http', + 'enum' => ['http', 'sse'], + ], + 'endpoint' => ['description' => 'MCP 服务访问地址。', 'type' => 'string', 'required' => true, 'example' => 'https://example.com/mcp'], + 'timeout' => ['description' => '请求 MCP 服务的超时时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5000'], + 'auth' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'type' => [ + 'description' => '认证类型，目前支持 bearer。', + 'type' => 'string', + 'required' => false, + 'example' => 'bearer', + 'enum' => ['bearer'], + ], + 'keyInfo' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'string', 'description' => '认证键值信息。', 'example' => 'example-token'], + 'example' => '{"token":"example-token"}', + ], + ], + 'required' => false, + ], + ], + 'required' => true, + ], + 'tools' => [ + 'description' => 'MCP 工具列表。', + 'type' => 'array', + 'items' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => 'MCP 工具名称。', 'type' => 'string', 'required' => true, 'example' => 'query_logs', 'minLength' => 1], + 'title' => ['description' => 'MCP 工具标题。', 'type' => 'string', 'required' => false, 'example' => '查询日志'], + 'displayName' => ['description' => 'MCP 工具显示名称。', 'type' => 'string', 'required' => false, 'example' => '日志查询工具'], + 'description' => ['description' => 'MCP 工具描述信息。', 'type' => 'string', 'required' => false, 'example' => '查询指定日志库中的日志。'], + 'inputSchema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => true, + 'additionalProperties' => ['type' => 'any', 'description' => 'MCP 工具输入 Schema 扩展字段。', 'example' => '{"type":"string"}'], + 'example' => '{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}', + ], + 'outputSchema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => 'MCP 工具输出 Schema 扩展字段。', 'example' => '{"type":"string"}'], + 'example' => '{"type":"object"}', + ], + 'icons' => [ + 'description' => 'MCP 工具图标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => '工具图标扩展字段。', 'example' => 'https://example.com/icon.png'], + 'example' => '[]', + ], + 'required' => false, + 'example' => '[]', + ], + 'execution' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => '工具执行配置扩展字段。', 'example' => '{}'], + 'example' => '{}', + ], + 'annotations' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => '工具注解扩展字段。', 'example' => '{}'], + 'example' => '{}', + ], + 'enable' => ['description' => '是否启用该 MCP 工具。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'confirm' => ['description' => '调用该 MCP 工具前是否需要用户确认。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + 'required' => false, + 'example' => '[{"name":"query_logs"}]', + ], + 'required' => true, + 'example' => '[{"name":"query_logs"}]', + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + 'mcpServiceName' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'example' => 'log-query'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建MCP服务', + 'summary' => '创建 MCP 服务', + 'description' => '创建MCP服务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\",\\n \\"mcpServiceName\\": \\"log-query\\"\\n}","type":"json"}]', + ], + 'CreateThread' => [ + 'path' => '/digitalEmployee/{name}/thread', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'title' => '请求参数', + 'description' => '请求参数', + 'type' => 'object', + 'properties' => [ + 'title' => ['description' => '会话标题', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'variables' => [ + 'description' => '会话属性', + 'type' => 'object', + 'properties' => [ + 'workspace' => ['description' => '工作空间名称。', 'type' => 'string', 'required' => false, 'example' => 'workspace'], + 'project' => ['description' => '日志服务项目名称', 'type' => 'string', 'required' => false, 'example' => 'project'], + ], + 'required' => false, + ], + 'attributes' => [ + 'title' => '属性内容', + 'description' => '属性内容', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['title' => '具体属性', 'description' => '具体属性', 'type' => 'string', 'example' => 'test'], + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'threadId' => ['description' => '会话 id', 'type' => 'string', 'example' => 'thread_id01'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建会话', + 'summary' => '创建会话', + 'description' => '创建会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:CreateThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"threadId\\": \\"thread_id01\\"\\n}","type":"json"}]', + ], + 'CreateTicket' => [ + 'path' => '/tickets', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], + 'parameters' => [ + [ + 'name' => 'expirationTime', + 'in' => 'query', + 'schema' => ['description' => '- 过期时间（秒），即内嵌页面 URL 链接过期时间，默认 86400 秒（一天），取值 0~2592000 秒（30 天）。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '86400'], + ], + [ + 'name' => 'accessTokenExpirationTime', + 'in' => 'query', + 'schema' => ['description' => '- 访问令牌过期时间（秒），即用户可以访问页面接口的过期时间，默认86400 秒（一天），取值 0~86400 秒（一天）。'."\n" + ."\n" + .'- 访问令牌过期时间是accessTokenExpirationTime、expirationTime 的最小值。'."\n" + ."\n" + .'- 若通过STS 调用，访问令牌过期时间（即用户可以访问页面接口的时间）是 accessTokenExpirationTime、expirationTime、STS 过期时间的最小值。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '600'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结构体', + 'type' => 'object', + 'properties' => [ + 'ticket' => ['title' => 'Id of the request', 'description' => '免登录票据', 'type' => 'string', 'example' => 'eyJ***************.eyJ******************.KUT****************'."\n"], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建免登录票据', + 'summary' => '创建票据', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateTicket', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"ticket\\": \\"eyJ***************.eyJ******************.KUT****************\\\\n\\"\\n}","type":"json"}]', + ], + 'DeleteDigitalEmployee' => [ + 'path' => '/digital-employee/{name}', + 'methods' => ['delete'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + ], + 'description' => '', + ], + ], + ], + 'title' => '删除数字员工', + 'summary' => '删除数字员工', + 'description' => '删除数字员工', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\"\\n}","type":"json"}]', + ], + 'DeleteDigitalEmployeeSkill' => [ + 'path' => '/digitalEmployee/{name}/skill/{skillName}', + 'methods' => ['delete'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'skillName', + 'in' => 'path', + 'schema' => ['description' => '技能名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => '0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0'], + ], + 'description' => '', + ], + ], + ], + 'title' => '删除技能', + 'summary' => '删除技能', + 'description' => '删除技能', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0\\"\\n}","type":"json"}]', + ], + 'DeleteMcpService' => [ + 'path' => '/digitalEmployee/{name}/mcpService/{mcpServiceName}', + 'methods' => ['delete'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test-agent', 'minLength' => 1], + ], + [ + 'name' => 'mcpServiceName', + 'in' => 'path', + 'schema' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'required' => true, 'example' => 'log-query', 'minLength' => 1], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除MCP服务', + 'summary' => '删除 MCP 服务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\"\\n}","type":"json"}]', + ], + 'DeleteThread' => [ + 'summary' => '删除会话', + 'path' => '/digitalEmployee/{name}/thread/{threadId}', + 'methods' => ['delete'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'threadId', + 'in' => 'path', + 'schema' => ['description' => '会话 id', 'type' => 'string', 'required' => true, 'example' => 'thread_id01'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '123-0F43-23423-AC43-34234'."\n"], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除会话', + 'description' => '删除会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"123-0F43-23423-AC43-34234\\\\n\\"\\n}","type":"json"}]', + ], + 'FetchRemoteMcpTools' => [ + 'summary' => '拉取远端 MCP 工具列表', + 'path' => '/mcptools', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], + 'parameters' => [ + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'network' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'mode' => [ + 'description' => 'MCP 服务网络访问模式，支持 public 和 vpc。', + 'type' => 'string', + 'required' => false, + 'example' => 'public', + 'enum' => ['public', 'vpc'], + ], + 'vpcId' => ['description' => '专有网络 VPC ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-xxx'], + 'vswId' => ['description' => '交换机 ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-xxx'], + 'accessIp' => ['description' => 'VPC 网络下访问 MCP 服务的 IP 地址。', 'type' => 'string', 'required' => false, 'example' => '10.0.0.12'], + 'accessPort' => ['description' => 'VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '8080'], + 'securityGroupId' => ['description' => '安全组 ID。', 'type' => 'string', 'required' => false, 'example' => 'sg-xxx'], + 'gatewayId' => ['description' => '网关 ID。', 'type' => 'string', 'required' => false, 'example' => 'gw-xxx'], + 'mcpServerId' => ['description' => 'MCP Server 实例 ID。', 'type' => 'string', 'required' => false, 'example' => 'mcp-xxx'], + 'region' => ['description' => 'VPC 网络所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + 'required' => false, + ], + 'connection' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'platform' => [ + 'description' => 'MCP 服务平台类型，支持 AIGateway 和 Custom。', + 'type' => 'string', + 'required' => false, + 'example' => 'Custom', + 'enum' => ['AIGateway', 'Custom'], + ], + 'transport' => [ + 'description' => 'MCP 服务传输协议，支持 http 和 sse。', + 'type' => 'string', + 'required' => true, + 'example' => 'http', + 'enum' => ['http', 'sse'], + ], + 'endpoint' => ['description' => 'MCP 服务访问地址。', 'type' => 'string', 'required' => true, 'example' => 'https://example.com/mcp'], + 'timeout' => ['description' => '请求 MCP 服务的超时时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5000'], + 'auth' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'type' => [ + 'description' => '认证类型，目前支持 bearer。', + 'type' => 'string', + 'required' => false, + 'example' => 'bearer', + 'enum' => ['bearer'], + ], + 'keyInfo' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'string', 'example' => 'example-token', 'description' => '认证键值信息。'], + 'example' => '{"token":"example-token"}', + ], + ], + 'required' => false, + ], + ], + 'required' => true, + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + 'tools' => ['description' => '远端 MCP 服务返回的 tools/list 原始响应。', 'type' => 'string', 'example' => '{"jsonrpc":"2.0","id":1,"result":{"tools":[]}}'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '拉取远端MCP工具列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:FetchRemoteMcpTools', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\",\\n \\"tools\\": \\"{\\\\\\"jsonrpc\\\\\\":\\\\\\"2.0\\\\\\",\\\\\\"id\\\\\\":1,\\\\\\"result\\\\\\":{\\\\\\"tools\\\\\\":[]}}\\"\\n}","type":"json"}]', + ], + 'GetArtifact' => [ + 'path' => '/digitalEmployee/{name}/artifact', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => [], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'artifactPath', + 'in' => 'query', + 'schema' => ['description' => '产物路径', 'type' => 'string', 'required' => true, 'example' => 'missions/mission-xxx/artifacts/2026-05/05-01/xxxx.md'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => ['description' => '产物内容', 'type' => 'string', 'format' => 'binary', 'example' => 'xxx'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取产物内容', + 'summary' => '获取产物内容', + 'description' => '获取产物内容', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetArtifact', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/artifact/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"\\"xxx\\"","type":"json"}]', + ], + 'GetDigitalEmployee' => [ + 'summary' => '获取数字员工', + 'path' => '/digital-employee/{name}', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'."\n"], + 'name' => ['description' => '数字员工名称。', 'type' => 'string', 'example' => 'test'], + 'defaultRule' => ['description' => '数字员工默认规则。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'description' => ['description' => '数字员工描述信息。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'createTime' => ['description' => '创建时间。', 'type' => 'string', 'format' => 'iso8601_normal', 'deprecated' => false, 'example' => '2025-03-11T08:21:58Z'."\n", 'pattern' => '', 'default' => ''], + 'displayName' => ['description' => '数字员工显示名称。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'maxLength' => 128, 'minLength' => 0, 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'updateTime' => ['description' => '修改时间。', 'type' => 'string', 'format' => 'iso8601_normal', 'deprecated' => false, 'example' => '2025-02-18T02:25:06Z'."\n", 'pattern' => '', 'default' => ''], + 'roleArn' => ['description' => 'RAM 角色 ARN。', 'type' => 'string', 'deprecated' => false, 'example' => 'acs:ram::12345678912:role/testrole', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'regionId' => ['description' => '代表地域ID的资源属性字段。', 'type' => 'string', 'example' => 'cn-beijing'."\n"], + 'knowledges' => [ + 'description' => '知识库列表', + 'type' => 'object', + 'properties' => [ + 'bailian' => [ + 'description' => '百练知识库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '百练知识库列表。', + 'type' => 'object', + 'properties' => [ + 'workspaceId' => ['description' => '百练工作空间 ID。', 'type' => 'string', 'example' => 'llm-xxxxx'."\n"], + 'indexId' => ['description' => '百练索引 ID。', 'type' => 'string', 'example' => 'index-xxxx'."\n"], + 'region' => ['description' => '知识库地域。', 'type' => 'string', 'example' => 'cn-beijing'."\n"], + 'attributes' => ['description' => '知识库属性。', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + 'sop' => [ + 'description' => 'SOP 知识库列表', + 'type' => 'array', + 'items' => ['description' => 'SOP 知识库', 'type' => 'object', 'example' => ' {'."\n" + .' "type": "oss",'."\n" + .' "basePath": "docs/",'."\n" + .' "region": "cn-hangzhou",'."\n" + .' "endpoint": "oss-cn-hangzhou.aliyuncs.com",'."\n" + .' "bucket": "my-sop-bucket",'."\n" + .' "description": "sls sop"'."\n" + .' }'], + ], + ], + ], + 'employeeType' => ['description' => '数字员工类型。', 'type' => 'string', 'example' => 'custom'], + 'tags' => [ + 'title' => '标签', + 'description' => '标签', + 'type' => 'array', + 'items' => ['title' => '标签', 'description' => '标签', '$ref' => '#/components/schemas/Tag'], + ], + 'resourceGroupId' => ['title' => '资源组 ID', 'description' => '资源组 ID', 'type' => 'string', 'example' => 'rg-ae******ey'], + 'attributes' => [ + 'title' => '属性', + 'description' => '属性', + 'type' => 'object', + 'deprecated' => false, + 'additionalProperties' => ['type' => 'string', 'description' => '属性', 'example' => '{}'], + 'readOnly' => false, + ], + 'toolPolicy' => [ + 'title' => '工具策略', + 'description' => '工具策略', + 'type' => 'object', + 'properties' => [ + 'aliyun' => [ + 'description' => 'Aliyun CLI 工具调用安全策略配置。', + 'type' => 'object', + 'properties' => [ + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'example' => 'true'], + 'statements' => [ + 'description' => 'Aliyun CLI 工具策略语句列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'decision' => [ + 'description' => '执行策略', + 'type' => 'string', + 'enumValueTitles' => ['allow' => 'allow', 'user_ack' => 'user_ack'], + 'example' => 'user_ack', + 'enum' => ['deny', 'user_ack', 'allow'], + ], + 'product' => ['description' => '云产品CODE。', 'type' => 'string', 'required' => true, 'example' => 'Sls'], + 'apiVersion' => ['description' => 'API版本。'."\n" + ."\n", 'type' => 'string', 'required' => true, 'example' => '2020-12-30'], + 'actions' => [ + 'description' => 'RAM action 列表', + 'type' => 'array', + 'items' => ['description' => 'RAM action', 'type' => 'string', 'example' => 'log:GetProject'], + 'example' => '["log:GetProject","log:CreateDashboard"]', + ], + ], + 'example' => '{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}', + 'description' => '单条 Aliyun OpenAPI 工具策略语句。', + ], + 'example' => '[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]', + ], + ], + 'example' => '{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}', + ], + ], + 'example' => '{"aliyun":{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}}', + ], + 'sandboxNetworkPolicy' => [ + 'title' => '沙箱网络策略', + 'description' => '数字员工沙箱网络 ACL 策略配置。', + 'type' => 'object', + 'properties' => [ + 'allowFqdns' => [ + 'description' => '允许访问的 FQDN 列表。', + 'type' => 'array', + 'items' => ['description' => '允许访问的 FQDN 列表。', 'type' => 'string', 'example' => 'api.example.com'], + 'maxItems' => 50, + ], + 'allowCidrs' => [ + 'description' => '允许访问的 CIDR 或 IP 列表。', + 'type' => 'array', + 'items' => ['description' => '允许访问的 CIDR 或 IP 列表。', 'type' => 'string', 'example' => '1.2.3.0/24'], + 'maxItems' => 50, + ], + 'enableAcl' => ['description' => '是否启用沙箱网络 ACL。', 'type' => 'boolean', 'example' => 'false'], + ], + 'example' => '{"allowFqdns":["api.example.com"],"allowCidrs":["1.2.3.0/24","8.8.8.8"],"enableAcl":false}', + ], + ], + 'description' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDigitalEmployee.NotFound', 'errorMessage' => 'The specified DigitalEmployee does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\\\n\\",\\n \\"name\\": \\"test\\",\\n \\"defaultRule\\": \\"test\\",\\n \\"description\\": \\"test\\",\\n \\"createTime\\": \\"2025-03-11T08:21:58Z\\\\n\\",\\n \\"displayName\\": \\"test\\",\\n \\"updateTime\\": \\"2025-02-18T02:25:06Z\\\\n\\",\\n \\"roleArn\\": \\"acs:ram::12345678912:role/testrole\\",\\n \\"regionId\\": \\"cn-beijing\\\\n\\",\\n \\"knowledges\\": {\\n \\"bailian\\": [\\n {\\n \\"workspaceId\\": \\"llm-xxxxx\\\\n\\",\\n \\"indexId\\": \\"index-xxxx\\\\n\\",\\n \\"region\\": \\"cn-beijing\\\\n\\",\\n \\"attributes\\": \\"test\\"\\n }\\n ],\\n \\"sop\\": [\\n {\\n \\"type\\": \\"oss\\",\\n \\"basePath\\": \\"docs/\\",\\n \\"region\\": \\"cn-hangzhou\\",\\n \\"endpoint\\": \\"oss-cn-hangzhou.aliyuncs.com\\",\\n \\"bucket\\": \\"my-sop-bucket\\",\\n \\"description\\": \\"sls sop\\"\\n }\\n ]\\n },\\n \\"employeeType\\": \\"custom\\",\\n \\"tags\\": [\\n {\\n \\"key\\": \\"test-key\\",\\n \\"value\\": \\"test-value\\"\\n }\\n ],\\n \\"resourceGroupId\\": \\"rg-ae******ey\\",\\n \\"attributes\\": {\\n \\"key\\": \\"{}\\"\\n },\\n \\"toolPolicy\\": {\\n \\"aliyun\\": {\\n \\"enable\\": true,\\n \\"statements\\": [\\n {\\n \\"decision\\": \\"user_ack\\",\\n \\"product\\": \\"Sls\\",\\n \\"apiVersion\\": \\"2020-12-30\\",\\n \\"actions\\": [\\n \\"log:GetProject\\"\\n ]\\n }\\n ]\\n }\\n },\\n \\"sandboxNetworkPolicy\\": {\\n \\"allowFqdns\\": [\\n \\"api.example.com\\"\\n ],\\n \\"allowCidrs\\": [\\n \\"1.2.3.0/24\\"\\n ],\\n \\"enableAcl\\": false\\n }\\n}","type":"json"}]', + 'title' => '获取数字员工', + 'description' => '获取数字员工', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + ], + ], + 'GetDigitalEmployeeSkill' => [ + 'summary' => '获取技能详情', + 'path' => '/digitalEmployee/{name}/skill/{skillName}', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'skillName', + 'in' => 'path', + 'schema' => ['description' => '技能名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'version', + 'in' => 'query', + 'schema' => ['description' => '历史版本号', 'type' => 'string', 'required' => false, 'example' => '1770386951147366810'."\n"], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => 'Id of the request', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'skillName' => ['description' => '技能名称', 'type' => 'string', 'example' => 'test'], + 'displayName' => ['description' => '技能显示名称', 'type' => 'string', 'example' => 'test'], + 'description' => ['description' => '技能描述信息', 'type' => 'string', 'example' => 'test'], + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'example' => 'true'], + 'createTime' => ['description' => '创建时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + 'updateTime' => ['description' => '更新时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + 'version' => ['description' => '版本号', 'type' => 'string', 'example' => '1770386951147366810'."\n"], + 'files' => [ + 'description' => '技能文件列表', + 'type' => 'array', + 'items' => [ + 'description' => '技能文件列表', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => '文件名称', 'type' => 'string', 'example' => 'SKILL.md'."\n"], + 'content' => ['description' => '文件内容', 'type' => 'string', 'example' => '---'."\n" + .'name: skill'."\n" + .'description: description'."\n" + .'---'."\n" + ."\n" + .'# skill '."\n" + ."\n" + .'skill test'], + ], + ], + ], + 'remark' => ['description' => '备注', 'type' => 'string', 'example' => 'remark'], + ], + 'description' => '', + ], + ], + ], + 'title' => '获取技能', + 'description' => '获取技能', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"skillName\\": \\"test\\",\\n \\"displayName\\": \\"test\\",\\n \\"description\\": \\"test\\",\\n \\"enable\\": true,\\n \\"createTime\\": \\"2026-02-06T14:09:11Z\\\\n\\",\\n \\"updateTime\\": \\"2026-02-06T14:09:11Z\\\\n\\",\\n \\"version\\": \\"1770386951147366810\\\\n\\",\\n \\"files\\": [\\n {\\n \\"name\\": \\"SKILL.md\\\\n\\",\\n \\"content\\": \\"---\\\\nname: skill\\\\ndescription: description\\\\n---\\\\n\\\\n# skill \\\\n\\\\nskill test\\"\\n }\\n ],\\n \\"remark\\": \\"remark\\"\\n}","type":"json"}]', + ], + 'GetMcpService' => [ + 'path' => '/digitalEmployee/{name}/mcpService/{mcpServiceName}', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test-agent', 'minLength' => 1], + ], + [ + 'name' => 'mcpServiceName', + 'in' => 'path', + 'schema' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'required' => true, 'example' => 'log-query', 'minLength' => 1], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + 'regionId' => ['description' => '当前请求地域。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'mcpService' => [ + 'description' => 'MCP 服务详情。', + 'type' => 'object', + 'properties' => [ + 'displayName' => ['description' => 'MCP 服务显示名称。', 'type' => 'string', 'example' => '日志查询'], + 'description' => ['description' => 'MCP 服务描述信息。', 'type' => 'string', 'example' => '通过 MCP 调用日志查询工具。'], + 'enable' => ['description' => '是否启用 MCP 服务。', 'type' => 'boolean', 'example' => 'true'], + 'network' => [ + 'description' => '网络连接信息。', + 'type' => 'object', + 'properties' => [ + 'mode' => [ + 'description' => 'MCP 服务网络访问模式，支持 public 和 vpc。', + 'type' => 'string', + 'example' => 'public', + 'enum' => ['public', 'vpc'], + ], + 'vpcId' => ['description' => '专有网络 VPC ID。', 'type' => 'string', 'example' => 'vpc-xxx'], + 'vswId' => ['description' => '交换机 ID。', 'type' => 'string', 'example' => 'vsw-xxx'], + 'accessIp' => ['description' => 'VPC 网络下访问 MCP 服务的 IP 地址。', 'type' => 'string', 'example' => '10.0.0.12'], + 'accessPort' => ['description' => 'VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。', 'type' => 'integer', 'format' => 'int64', 'example' => '8080'], + 'securityGroupId' => ['description' => '安全组 ID。', 'type' => 'string', 'example' => 'sg-xxx'], + 'gatewayId' => ['description' => '网关 ID。', 'type' => 'string', 'example' => 'gw-xxx'], + 'mcpServerId' => ['description' => 'MCP Server 实例 ID。', 'type' => 'string', 'example' => 'mcp-xxx'], + 'region' => ['description' => 'VPC 网络所在地域。', 'type' => 'string', 'example' => 'cn-hangzhou'], + ], + ], + 'connection' => [ + 'description' => 'MCP 服务连接配置。', + 'type' => 'object', + 'properties' => [ + 'platform' => [ + 'description' => 'MCP 服务平台类型，支持 AIGateway 和 Custom。', + 'type' => 'string', + 'example' => 'Custom', + 'enum' => ['AIGateway', 'Custom'], + ], + 'transport' => [ + 'description' => 'MCP 服务传输协议，支持 http 和 sse。', + 'type' => 'string', + 'example' => 'http', + 'enum' => ['http', 'sse'], + ], + 'endpoint' => ['description' => 'MCP 服务访问地址。', 'type' => 'string', 'example' => 'https://example.com/mcp'], + 'timeout' => ['description' => '请求 MCP 服务的超时时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '5000'], + 'auth' => [ + 'description' => 'MCP 服务认证配置。', + 'type' => 'object', + 'properties' => [ + 'type' => [ + 'description' => '认证类型，目前支持 bearer。', + 'type' => 'string', + 'example' => 'bearer', + 'enum' => ['bearer'], + ], + 'keyInfo' => [ + 'description' => '认证所需的键值信息。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'example' => 'example-token', 'description' => '认证键值信息。'], + 'example' => '{"token":"example-token"}', + ], + ], + ], + ], + ], + 'tools' => [ + 'description' => 'MCP 工具列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个 MCP 工具配置。', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => 'MCP 工具名称。', 'type' => 'string', 'example' => 'query_logs'], + 'title' => ['description' => 'MCP 工具标题。', 'type' => 'string', 'example' => '查询日志'], + 'displayName' => ['description' => 'MCP 工具显示名称。', 'type' => 'string', 'example' => '日志查询工具'], + 'description' => ['description' => 'MCP 工具描述信息。', 'type' => 'string', 'example' => '查询指定日志库中的日志。'], + 'inputSchema' => [ + 'description' => 'MCP 工具输入参数的 JSON Schema。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{"type":"string"}', 'description' => 'MCP 工具输入 Schema 扩展字段。'], + 'example' => '{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}', + ], + 'outputSchema' => [ + 'description' => 'MCP 工具输出结果的 JSON Schema。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{"type":"string"}', 'description' => 'MCP 工具输出 Schema 扩展字段。'], + 'example' => '{"type":"object"}', + ], + 'icons' => [ + 'description' => 'MCP 工具图标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个 MCP 工具配置。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => 'https://example.com/icon.png', 'description' => '工具图标扩展字段。'], + 'example' => '[]', + ], + 'example' => '[]', + ], + 'execution' => [ + 'description' => 'MCP 工具执行配置。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{}', 'description' => '工具执行配置扩展字段。'], + 'example' => '{}', + ], + 'annotations' => [ + 'description' => 'MCP 工具注解信息。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{}', 'description' => '工具注解扩展字段。'], + 'example' => '{}', + ], + 'enable' => ['description' => '是否启用该 MCP 工具。', 'type' => 'boolean', 'example' => 'true'], + 'confirm' => ['description' => '调用该 MCP 工具前是否需要用户确认。', 'type' => 'boolean', 'example' => 'false'], + ], + 'example' => '[{"name":"query_logs"}]', + ], + 'example' => '[{"name":"query_logs"}]', + ], + 'mcpServiceName' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'example' => 'log-query'], + ], + ], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询MCP服务', + 'summary' => '查询 MCP 服务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\",\\n \\"regionId\\": \\"cn-hangzhou\\",\\n \\"mcpService\\": {\\n \\"displayName\\": \\"日志查询\\",\\n \\"description\\": \\"通过 MCP 调用日志查询工具。\\",\\n \\"enable\\": true,\\n \\"network\\": {\\n \\"mode\\": \\"public\\",\\n \\"vpcId\\": \\"vpc-xxx\\",\\n \\"vswId\\": \\"vsw-xxx\\",\\n \\"accessIp\\": \\"10.0.0.12\\",\\n \\"accessPort\\": 8080,\\n \\"securityGroupId\\": \\"sg-xxx\\",\\n \\"gatewayId\\": \\"gw-xxx\\",\\n \\"mcpServerId\\": \\"mcp-xxx\\",\\n \\"region\\": \\"cn-hangzhou\\"\\n },\\n \\"connection\\": {\\n \\"platform\\": \\"Custom\\",\\n \\"transport\\": \\"http\\",\\n \\"endpoint\\": \\"https://example.com/mcp\\",\\n \\"timeout\\": 5000,\\n \\"auth\\": {\\n \\"type\\": \\"bearer\\",\\n \\"keyInfo\\": {\\n \\"key\\": \\"example-token\\"\\n }\\n }\\n },\\n \\"tools\\": [\\n {\\n \\"name\\": \\"query_logs\\",\\n \\"title\\": \\"查询日志\\",\\n \\"displayName\\": \\"日志查询工具\\",\\n \\"description\\": \\"查询指定日志库中的日志。\\",\\n \\"inputSchema\\": {\\n \\"key\\": \\"{\\\\\\"type\\\\\\":\\\\\\"string\\\\\\"}\\"\\n },\\n \\"outputSchema\\": {\\n \\"key\\": \\"{\\\\\\"type\\\\\\":\\\\\\"string\\\\\\"}\\"\\n },\\n \\"icons\\": [\\n {\\n \\"key\\": \\"https://example.com/icon.png\\"\\n }\\n ],\\n \\"execution\\": {\\n \\"key\\": \\"{}\\"\\n },\\n \\"annotations\\": {\\n \\"key\\": \\"{}\\"\\n },\\n \\"enable\\": true,\\n \\"confirm\\": false\\n }\\n ],\\n \\"mcpServiceName\\": \\"log-query\\"\\n }\\n}","type":"json"}]', + ], + 'GetThread' => [ + 'summary' => '获取会话', + 'path' => '/digitalEmployee/{name}/thread/{threadId}', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'threadId', + 'in' => 'path', + 'schema' => ['description' => '会话 id', 'type' => 'string', 'required' => true, 'example' => 'thread_id01'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'threadId' => ['description' => '会话 id', 'type' => 'string', 'example' => 'thread_id01'], + 'digitalEmployeeName' => ['description' => '数字员工名称', 'type' => 'string', 'example' => 'test'], + 'title' => ['description' => '会话标题', 'type' => 'string', 'example' => 'testLive'], + 'status' => ['description' => '会话状态', 'type' => 'string', 'example' => 'active'], + 'version' => ['description' => '版本', 'type' => 'integer', 'format' => 'int64', 'example' => '1231'], + 'createTime' => ['description' => '创建时间', 'type' => 'string', 'example' => '2025-12-19T15:19:55.040403272+08:00'."\n"], + 'updateTime' => ['description' => '更新时间', 'type' => 'string', 'example' => '2025-12-19T15:19:55.040403272+08:00'."\n"], + 'variables' => [ + 'description' => '会话属性', + 'type' => 'object', + 'properties' => [ + 'workspace' => ['description' => '工作空间名称。', 'type' => 'string', 'example' => 'test'], + 'project' => ['description' => 'SLS 项目名称', 'type' => 'string', 'example' => 'test'], + ], + ], + 'attributes' => [ + 'title' => '属性', + 'description' => '属性', + 'type' => 'object', + 'additionalProperties' => ['title' => '具体属性', 'description' => '具体属性', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取会话', + 'description' => '获取会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"threadId\\": \\"thread_id01\\",\\n \\"digitalEmployeeName\\": \\"test\\",\\n \\"title\\": \\"testLive\\",\\n \\"status\\": \\"active\\",\\n \\"version\\": 1231,\\n \\"createTime\\": \\"2025-12-19T15:19:55.040403272+08:00\\\\n\\",\\n \\"updateTime\\": \\"2025-12-19T15:19:55.040403272+08:00\\\\n\\",\\n \\"variables\\": {\\n \\"workspace\\": \\"test\\",\\n \\"project\\": \\"test\\"\\n },\\n \\"attributes\\": {\\n \\"key\\": \\"test\\"\\n }\\n}","type":"json"}]', + ], + 'GetThreadData' => [ + 'summary' => '获取会话数据', + 'path' => '/digitalEmployee/{name}/thread/{threadId}/data', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'threadId', + 'in' => 'path', + 'schema' => ['description' => '会话 id', 'type' => 'string', 'required' => true, 'example' => 'thread_id01'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['description' => '分页游标。', 'type' => 'string', 'required' => false, 'example' => 'xxxxxxxxxx'], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['description' => '返回会话数据最大数据，最大值:100', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'maxResults' => ['title' => '最大结果数量', 'description' => '最大结果数量', 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'data' => [ + 'title' => '消息数据', + 'description' => '消息数据', + 'type' => 'array', + 'items' => [ + 'title' => '消息数据', + 'description' => '消息数据', + 'type' => 'object', + 'properties' => [ + 'traceId' => ['title' => '当前message请求的id数据'."\n" + .'根数据中第一个追踪ID', 'description' => '当前message请求的id数据'."\n" + .'根数据中第一个追踪ID', 'type' => 'string', 'example' => '3b5287b717636040171772050d0095'."\n"], + 'requestId' => ['title' => '当前message请求的id数据'."\n" + .'根数据中第一个RequestID', 'description' => '当前message请求的id数据'."\n" + .'根数据中第一个RequestID', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'messages' => [ + 'title' => '会话的消息列表', + 'description' => '会话的消息列表', + 'type' => 'array', + 'items' => [ + 'title' => '消息数据明细结构', + 'description' => '消息数据明细结构', + 'type' => 'object', + 'properties' => [ + 'version' => ['title' => '消息数据的版本号', 'description' => '消息数据的版本号', 'type' => 'string', 'example' => 'v0.1.0'."\n"], + 'parentCallId' => ['title' => '上一层级执行ID', 'description' => '上一层级执行ID', 'type' => 'string', 'example' => '3b5287b7176360'], + 'callId' => ['title' => '当前执行ID', 'description' => '当前执行ID', 'type' => 'string', 'example' => '3b5287b7176360'], + 'role' => ['title' => '消息发起角色', 'description' => '消息发起角色', 'type' => 'string', 'example' => 'user'], + 'seq' => ['title' => '消息序列号', 'description' => '消息序列号', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'timestamp' => ['title' => 'timestamp / 纳秒', 'description' => 'timestamp / 纳秒', 'type' => 'string', 'example' => '1768702985000000000'], + 'type' => ['title' => '消息具体类型', 'description' => '消息具体类型', 'type' => 'string', 'example' => 'task_finished'], + 'detail' => ['title' => '消息明细', 'description' => '消息明细', 'type' => 'string', 'example' => 'context of model exceed'."\n"], + 'contents' => [ + 'title' => '内容信息', + 'description' => '内容信息', + 'type' => 'array', + 'items' => ['title' => '内容信息明细结构', 'description' => '内容信息明细结构', 'type' => 'object', 'example' => '{'."\n" + .' "append": false,'."\n" + .' "lastChunk": false,'."\n" + .' "type": "text",'."\n" + .' "value": "result output chunk"'."\n" + .'}'], + ], + 'tools' => [ + 'title' => '工具使用列表', + 'description' => '工具使用列表', + 'type' => 'array', + 'items' => ['title' => '工具明细结构', 'description' => '工具明细结构', 'type' => 'object', 'example' => '{'."\n" + .' "arguments": {'."\n" + .' "confidence": "high",'."\n" + .' "intent": "analyser",'."\n" + .' "is_new_turn": true,'."\n" + .' "language": "en",'."\n" + .' "title": "Root Cause of Alert"'."\n" + .' },'."\n" + .' "id": "IntentRecognition",'."\n" + .' "name": "IntentRecognition",'."\n" + .' "status": "start",'."\n" + .' "toolCallId": "019bc1cb-adad"'."\n" + .'}'], + ], + 'agents' => [ + 'title' => '调用的Agent列表', + 'description' => '调用的Agent列表', + 'type' => 'array', + 'items' => ['title' => '调用的Agent详细内容', 'description' => '调用的Agent详细内容', 'type' => 'object', 'example' => '{'."\n" + .' "callId": "019bc1cb-adad",'."\n" + .' "id": "analyser",'."\n" + .' "inputs": ['."\n" + .' {'."\n" + .' "append": false,'."\n" + .' "lastChunk": false,'."\n" + .' "type": "text",'."\n" + .' "value": "Analyze this trace: TraceID=xxx"'."\n" + .' }'."\n" + .' ],'."\n" + .' "name": "analyser",'."\n" + .' "status": "start"'."\n" + .'}'], + ], + 'events' => [ + 'title' => '事件列表', + 'description' => '事件列表', + 'type' => 'array', + 'items' => ['title' => '事件详细内容', 'description' => '事件详细内容', 'type' => 'object', 'example' => '{'."\n" + .' "payload": {'."\n" + .' "error": {'."\n" + .' "code": "TASK_FAILED",'."\n" + .' "message": "Invalid task parameter",'."\n" + .' "suggestion": ""'."\n" + .' },'."\n" + .' "statistics": {'."\n" + .' "duration": 300000'."\n" + .' },'."\n" + .' "success": false'."\n" + .' },'."\n" + .' "type": "task_finished"'."\n" + .'}'."\n"], + ], + 'artifacts' => [ + 'title' => '产物产出信息', + 'description' => '产物产出信息', + 'type' => 'array', + 'items' => ['title' => '产物明细的结构', 'description' => '产物明细的结构', 'type' => 'object', 'example' => '{'."\n" + .' "artifactId": "019bc1cb-9600-703axxx",'."\n" + .' "name": "sql output",'."\n" + .' "description": "sql generation task result",'."\n" + .' "extensions": ["sql_generation_tool", "sql_diagnosis"],'."\n" + .' "metadata": {'."\n" + .' "model": "qwen3-coder-plus"'."\n" + .' },'."\n" + .' "parts": ['."\n" + .' {'."\n" + .' "text": "select * from table",'."\n" + .' "kind": "text"'."\n" + .' }'."\n" + .' ]'."\n" + .'}'], + ], + ], + ], + ], + ], + ], + ], + 'nextToken' => ['title' => '分页参数，下一页信息', 'description' => '分页参数，下一页信息', 'type' => 'string', 'example' => 'xxxxxxxxx'], + 'requestId' => ['title' => '当前请求ID', 'description' => '当前请求ID', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'threadId' => ['title' => '当前会话ID', 'description' => '当前会话ID', 'type' => 'string', 'example' => 'thread_id01'], + 'digitalEmployeeName' => ['title' => '当前数字员工信息', 'description' => '当前数字员工信息', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取会话数据', + 'description' => '获取会话数据', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetThreadData', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"maxResults\\": 2,\\n \\"data\\": [\\n {\\n \\"traceId\\": \\"3b5287b717636040171772050d0095\\\\n\\",\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"messages\\": [\\n {\\n \\"version\\": \\"v0.1.0\\\\n\\",\\n \\"parentCallId\\": \\"3b5287b7176360\\",\\n \\"callId\\": \\"3b5287b7176360\\",\\n \\"role\\": \\"user\\",\\n \\"seq\\": 0,\\n \\"timestamp\\": \\"1768702985000000000\\",\\n \\"type\\": \\"task_finished\\",\\n \\"detail\\": \\"context of model exceed\\\\n\\",\\n \\"contents\\": [\\n {\\n \\"append\\": false,\\n \\"lastChunk\\": false,\\n \\"type\\": \\"text\\",\\n \\"value\\": \\"result output chunk\\"\\n }\\n ],\\n \\"tools\\": [\\n {\\n \\"arguments\\": {\\n \\"confidence\\": \\"high\\",\\n \\"intent\\": \\"analyser\\",\\n \\"is_new_turn\\": true,\\n \\"language\\": \\"en\\",\\n \\"title\\": \\"Root Cause of Alert\\"\\n },\\n \\"id\\": \\"IntentRecognition\\",\\n \\"name\\": \\"IntentRecognition\\",\\n \\"status\\": \\"start\\",\\n \\"toolCallId\\": \\"019bc1cb-adad\\"\\n }\\n ],\\n \\"agents\\": [\\n {\\n \\"callId\\": \\"019bc1cb-adad\\",\\n \\"id\\": \\"analyser\\",\\n \\"inputs\\": [\\n {\\n \\"append\\": false,\\n \\"lastChunk\\": false,\\n \\"type\\": \\"text\\",\\n \\"value\\": \\"Analyze this trace: TraceID=xxx\\"\\n }\\n ],\\n \\"name\\": \\"analyser\\",\\n \\"status\\": \\"start\\"\\n }\\n ],\\n \\"events\\": [\\n {\\n \\"payload\\": {\\n \\"error\\": {\\n \\"code\\": \\"TASK_FAILED\\",\\n \\"message\\": \\"Invalid task parameter\\",\\n \\"suggestion\\": \\"\\"\\n },\\n \\"statistics\\": {\\n \\"duration\\": 300000\\n },\\n \\"success\\": false\\n },\\n \\"type\\": \\"task_finished\\"\\n }\\n ],\\n \\"artifacts\\": [\\n {\\n \\"artifactId\\": \\"019bc1cb-9600-703axxx\\",\\n \\"name\\": \\"sql output\\",\\n \\"description\\": \\"sql generation task result\\",\\n \\"extensions\\": [\\n \\"sql_generation_tool\\",\\n \\"sql_diagnosis\\"\\n ],\\n \\"metadata\\": {\\n \\"model\\": \\"qwen3-coder-plus\\"\\n },\\n \\"parts\\": [\\n {\\n \\"text\\": \\"select * from table\\",\\n \\"kind\\": \\"text\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"nextToken\\": \\"xxxxxxxxx\\",\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"threadId\\": \\"thread_id01\\",\\n \\"digitalEmployeeName\\": \\"test\\"\\n}","type":"json"}]', + ], + 'ListArtifacts' => [ + 'summary' => '列出产物列表', + 'path' => '/digitalEmployee/{name}/artifacts', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'title' => '数字员工名称'], + ], + [ + 'name' => 'artifactPath', + 'in' => 'query', + 'schema' => ['description' => '产物路径', 'type' => 'string', 'required' => true, 'example' => 'missions/mission-xxx/artifacts/2026-05/05-01/', 'title' => '产物目录路径，相对于数字员工产物根目录'], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['description' => '最大返回结果数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10', 'title' => '本次返回的最大条数'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['description' => '下一次查询的令牌', 'type' => 'string', 'required' => false, 'example' => 'xxx', 'title' => '分页标记'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n", 'title' => '请求 ID'], + 'artifacts' => [ + 'description' => '产物列表', + 'type' => 'array', + 'items' => [ + 'description' => '产物', + 'type' => 'object', + 'properties' => [ + 'path' => ['description' => '路径', 'type' => 'string', 'example' => 'missions/mission-xxx/artifacts/2026-05/05-01/xxxx.md', 'title' => '产物路径'], + 'size' => ['description' => '大小', 'type' => 'integer', 'format' => 'int64', 'example' => '21950', 'title' => '文件大小，目录固定为 0，单位为字节'], + 'lastModified' => ['description' => '上次修改时间', 'type' => 'string', 'example' => '2026-04-30T16:03:54Z', 'title' => '文件最后修改时间'], + 'isDirectory' => ['description' => '是否是目录', 'type' => 'boolean', 'example' => 'false', 'title' => '是否为目录'], + ], + ], + 'title' => '产物文件或目录列表', + 'example' => '[{"path":"reports/summary.pdf","size":1024,"lastModified":"2026-05-25T08:00:00Z","isDirectory":false}]', + ], + 'nextToken' => ['description' => '下一次查询的令牌', 'type' => 'string', 'example' => 'xxx', 'title' => '下一页分页标记'], + 'maxResults' => ['description' => '最大返回结果数', 'type' => 'integer', 'format' => 'int32', 'example' => '10', 'title' => '本次请求的最大返回条数'], + ], + 'description' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出产物列表', + 'description' => '列出产物列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListArtifacts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/artifact/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"artifacts\\": [\\n {\\n \\"path\\": \\"missions/mission-xxx/artifacts/2026-05/05-01/xxxx.md\\",\\n \\"size\\": 21950,\\n \\"lastModified\\": \\"2026-04-30T16:03:54Z\\",\\n \\"isDirectory\\": false\\n }\\n ],\\n \\"nextToken\\": \\"xxx\\",\\n \\"maxResults\\": 10\\n}","type":"json"}]', + ], + 'ListDigitalEmployeeSkillVersions' => [ + 'summary' => '列出技能版本', + 'path' => '/digitalEmployee/{name}/skill/{skillName}/versions', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'skillName', + 'in' => 'path', + 'schema' => ['description' => '技能名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-A01D6CC3F4B8'."\n"], + 'data' => [ + 'description' => '过去的历史版本', + 'type' => 'array', + 'items' => [ + 'description' => '历史版本', + 'type' => 'object', + 'properties' => [ + 'skillName' => ['description' => '技能名称', 'type' => 'string', 'example' => 'test'], + 'displayName' => ['description' => '显示名称', 'type' => 'string', 'example' => 'test'], + 'description' => ['description' => '描述', 'type' => 'string', 'example' => 'test'], + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'example' => 'true'], + 'updateTime' => ['description' => '更新时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + 'version' => ['description' => '版本', 'type' => 'string', 'example' => '1770386951147366810'."\n"], + 'remark' => ['description' => '备注', 'type' => 'string', 'example' => 'remark'], + 'createTime' => ['description' => '创建时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'title' => '列出技能历史版本', + 'description' => '列出技能历史版本', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployeeSkillVersions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-A01D6CC3F4B8\\\\n\\",\\n \\"data\\": [\\n {\\n \\"skillName\\": \\"test\\",\\n \\"displayName\\": \\"test\\",\\n \\"description\\": \\"test\\",\\n \\"enable\\": true,\\n \\"updateTime\\": \\"2026-02-06T14:09:11Z\\\\n\\",\\n \\"version\\": \\"1770386951147366810\\\\n\\",\\n \\"remark\\": \\"remark\\",\\n \\"createTime\\": \\"2026-02-06T14:09:11Z\\\\n\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListDigitalEmployeeSkills' => [ + 'path' => '/digitalEmployee/{name}/skills', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['description' => 'MaxResults 本次请求所返回的最大记录条数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'example' => '10'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['description' => '下一页 token，为 null 表示没有下一页', 'type' => 'string', 'required' => false, 'example' => 'sjC5rekx93Ew7K7VcmI3wkBZBYQ-GphB2ilQu3zJCGxoZuicwyJznfo2riTjr-lq'], + ], + [ + 'name' => 'skillName', + 'in' => 'query', + 'schema' => ['description' => '技能名称', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => 'Id of the request', 'type' => 'string', 'example' => '0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0'."\n"], + 'total' => ['description' => '总记录数', 'type' => 'integer', 'format' => 'int64', 'example' => '15'], + 'maxResults' => ['description' => '最大返回结果数', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'nextToken' => ['description' => '下一次查询的令牌。', 'type' => 'string', 'example' => 'sjC5rekx93Ew7K7VcmI3wkBZBYQ-GphB2ilQu3zJCGxoZuicwyJznfo2riTjr-lq'."\n"], + 'skills' => [ + 'description' => '技能列表', + 'type' => 'array', + 'items' => [ + 'description' => '技能', + 'type' => 'object', + 'properties' => [ + 'skillName' => ['description' => '技能名称', 'type' => 'string', 'example' => 'test'], + 'displayName' => ['description' => '技能显示名称', 'type' => 'string', 'example' => 'test'], + 'description' => ['description' => '描述', 'type' => 'string', 'example' => 'test'], + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'example' => 'true'], + 'createTime' => ['description' => '创建时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + 'updateTime' => ['description' => '更新时间', 'type' => 'string', 'format' => 'iso8601_normal', 'example' => '2026-02-06T14:09:11Z'."\n"], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'title' => '列出技能', + 'summary' => '列出技能', + 'description' => '列出技能', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployeeSkills', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/*'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0\\\\n\\",\\n \\"total\\": 15,\\n \\"maxResults\\": 10,\\n \\"nextToken\\": \\"sjC5rekx93Ew7K7VcmI3wkBZBYQ-GphB2ilQu3zJCGxoZuicwyJznfo2riTjr-lq\\\\n\\",\\n \\"skills\\": [\\n {\\n \\"skillName\\": \\"test\\",\\n \\"displayName\\": \\"test\\",\\n \\"description\\": \\"test\\",\\n \\"enable\\": true,\\n \\"createTime\\": \\"2026-02-06T14:09:11Z\\\\n\\",\\n \\"updateTime\\": \\"2026-02-06T14:09:11Z\\\\n\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListDigitalEmployees' => [ + 'path' => '/digital-employee', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => '分页大小 默认值: 20 最大值: 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'example' => '10'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => '下一次查询的令牌。', 'type' => 'string', 'required' => false, 'example' => 'xxxxxx'], + ], + [ + 'name' => 'name', + 'in' => 'query', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'employeeType', + 'in' => 'query', + 'schema' => [ + 'description' => '数字员工类型。', + 'type' => 'string', + 'required' => false, + 'example' => 'custom', + 'enum' => ['system', 'custom'], + ], + ], + [ + 'name' => 'displayName', + 'in' => 'query', + 'schema' => ['description' => '数字员工显示名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'tags', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'title' => '标签', + 'description' => '标签', + 'type' => 'array', + 'items' => ['title' => '标签', 'description' => '标签', 'required' => false, '$ref' => '#/components/schemas/Tag'], + 'required' => false, + ], + ], + [ + 'name' => 'resourceGroupId', + 'in' => 'query', + 'schema' => ['title' => '资源组 ID', 'description' => '资源组 ID', 'type' => 'string', 'required' => false, 'example' => 'rg-ae******ey'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '8FDE2569-626B-5176-9844-28877A*****'."\n"], + 'nextToken' => ['description' => '下一次查询的令牌。', 'type' => 'string', 'example' => 'xxxxx'], + 'total' => ['description' => '总记录数', 'type' => 'integer', 'format' => 'int32', 'example' => '56'], + 'maxResults' => ['description' => '最大返回结果数', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'digitalEmployees' => [ + 'description' => '数字员工列表', + 'type' => 'array', + 'items' => [ + 'description' => '数字员工', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => '数字员工名称。', 'type' => 'string', 'example' => 'test'], + 'defaultRule' => ['description' => '数字员工默认规则。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'description' => ['description' => '数字员工描述信息。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'createTime' => ['description' => '创建时间。', 'type' => 'string', 'format' => 'iso8601_normal', 'deprecated' => false, 'example' => '2025-11-04T08:08:57Z'."\n", 'pattern' => '', 'default' => ''], + 'displayName' => ['description' => '数字员工显示名称。', 'type' => 'string', 'deprecated' => false, 'example' => 'test', 'maxLength' => 128, 'minLength' => 0, 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'updateTime' => ['description' => '修改时间。', 'type' => 'string', 'format' => 'iso8601_normal', 'deprecated' => false, 'example' => '2025-05-07T02:26:01Z'."\n", 'pattern' => '', 'default' => ''], + 'roleArn' => ['description' => 'RAM 角色 ARN。', 'type' => 'string', 'deprecated' => false, 'example' => 'acs:ram::12345678912:role/testrole'."\n", 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'knowledges' => [ + 'description' => '知识库列表', + 'type' => 'object', + 'properties' => [ + 'bailian' => [ + 'description' => '百练知识库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '百练知识库列表。', + 'type' => 'object', + 'properties' => [ + 'workspaceId' => ['description' => '百练工作空间 ID。', 'type' => 'string', 'example' => 'llm-xxxx'."\n"], + 'indexId' => ['description' => '百练索引 ID。', 'type' => 'string', 'example' => 'index-xxxx'."\n"], + 'region' => ['description' => '知识库地域。', 'type' => 'string', 'example' => 'cn-beijing'."\n"], + 'attributes' => ['description' => '知识库属性。', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + 'sop' => [ + 'description' => 'SOP 知识库列表', + 'type' => 'array', + 'items' => ['description' => 'SOP 知识库', 'type' => 'object', 'example' => '{'."\n" + .' "type": "oss",'."\n" + .' "basePath": "docs/",'."\n" + .' "region": "cn-hangzhou",'."\n" + .' "endpoint": "oss-cn-hangzhou.aliyuncs.com",'."\n" + .' "bucket": "my-sop-bucket",'."\n" + .' "description": "sls sop"'."\n" + .' }'], + ], + ], + ], + 'employeeType' => ['description' => '数字员工类型。', 'type' => 'string', 'example' => 'custom'], + 'resourceGroupId' => ['title' => '资源组 ID', 'description' => '资源组 ID', 'type' => 'string', 'example' => 'rg-ae******ey'], + 'tags' => [ + 'title' => '标签', + 'description' => '标签', + 'type' => 'array', + 'items' => ['title' => '标签', 'description' => '标签', '$ref' => '#/components/schemas/Tag'], + ], + 'attributes' => [ + 'type' => 'object', + 'deprecated' => false, + 'additionalProperties' => ['type' => 'string'], + 'readOnly' => false, + ], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'title' => '列出数字员工', + 'summary' => '列出数字员工', + 'description' => '列出数字员工', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployees', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"8FDE2569-626B-5176-9844-28877A*****\\\\n\\",\\n \\"nextToken\\": \\"xxxxx\\",\\n \\"total\\": 56,\\n \\"maxResults\\": 10,\\n \\"digitalEmployees\\": [\\n {\\n \\"name\\": \\"test\\",\\n \\"defaultRule\\": \\"test\\",\\n \\"description\\": \\"test\\",\\n \\"createTime\\": \\"2025-11-04T08:08:57Z\\\\n\\",\\n \\"displayName\\": \\"test\\",\\n \\"updateTime\\": \\"2025-05-07T02:26:01Z\\\\n\\",\\n \\"roleArn\\": \\"acs:ram::12345678912:role/testrole\\\\n\\",\\n \\"knowledges\\": {\\n \\"bailian\\": [\\n {\\n \\"workspaceId\\": \\"llm-xxxx\\\\n\\",\\n \\"indexId\\": \\"index-xxxx\\\\n\\",\\n \\"region\\": \\"cn-beijing\\\\n\\",\\n \\"attributes\\": \\"test\\"\\n }\\n ],\\n \\"sop\\": [\\n {\\n \\"type\\": \\"oss\\",\\n \\"basePath\\": \\"docs/\\",\\n \\"region\\": \\"cn-hangzhou\\",\\n \\"endpoint\\": \\"oss-cn-hangzhou.aliyuncs.com\\",\\n \\"bucket\\": \\"my-sop-bucket\\",\\n \\"description\\": \\"sls sop\\"\\n }\\n ]\\n },\\n \\"employeeType\\": \\"custom\\",\\n \\"resourceGroupId\\": \\"rg-ae******ey\\",\\n \\"tags\\": [\\n {\\n \\"key\\": \\"test-key\\",\\n \\"value\\": \\"test-value\\"\\n }\\n ],\\n \\"attributes\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListMcpServices' => [ + 'path' => '/digitalEmployee/{name}/mcpServices', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test-agent', 'minLength' => 1], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['description' => '本次查询返回的最大条数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '500', 'example' => '20'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['description' => '下一次查询的分页令牌。', 'type' => 'string', 'required' => false, 'example' => 'eyJvZmZzZXQiOjIwfQ=='], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + 'total' => ['description' => '符合查询条件的 MCP 服务总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'maxResults' => ['description' => '本次查询返回的最大条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'nextToken' => ['description' => '下一次查询的分页令牌。', 'type' => 'string', 'example' => 'eyJvZmZzZXQiOjIwfQ=='], + 'mcpServices' => [ + 'description' => 'MCP 服务分页结果。', + 'type' => 'object', + 'properties' => [ + 'mcpServiceList' => [ + 'description' => 'MCP 服务列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个 MCP 服务信息。', + 'type' => 'object', + 'properties' => [ + 'displayName' => ['description' => 'MCP 服务显示名称。', 'type' => 'string', 'example' => '日志查询'], + 'description' => ['description' => 'MCP 服务描述信息。', 'type' => 'string', 'example' => '通过 MCP 调用日志查询工具。'], + 'enable' => ['description' => '是否启用 MCP 服务。', 'type' => 'boolean', 'example' => 'true'], + 'network' => [ + 'description' => '网络连接信息。', + 'type' => 'object', + 'properties' => [ + 'mode' => [ + 'description' => 'MCP 服务网络访问模式，支持 public 和 vpc。', + 'type' => 'string', + 'example' => 'public', + 'enum' => ['public', 'vpc'], + ], + 'vpcId' => ['description' => '专有网络 VPC ID。', 'type' => 'string', 'example' => 'vpc-xxx'], + 'vswId' => ['description' => '交换机 ID。', 'type' => 'string', 'example' => 'vsw-xxx'], + 'accessIp' => ['description' => 'VPC 网络下访问 MCP 服务的 IP 地址。', 'type' => 'string', 'example' => '10.0.0.12'], + 'accessPort' => ['description' => 'VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。', 'type' => 'integer', 'format' => 'int64', 'example' => '8080'], + 'securityGroupId' => ['description' => '安全组 ID。', 'type' => 'string', 'example' => 'sg-xxx'], + 'gatewayId' => ['description' => '网关 ID。', 'type' => 'string', 'example' => 'gw-xxx'], + 'mcpServerId' => ['description' => 'MCP Server 实例 ID。', 'type' => 'string', 'example' => 'mcp-xxx'], + 'region' => ['description' => 'VPC 网络所在地域。', 'type' => 'string', 'example' => 'cn-hangzhou'], + ], + ], + 'connection' => [ + 'description' => 'MCP 服务连接配置。', + 'type' => 'object', + 'properties' => [ + 'platform' => [ + 'description' => 'MCP 服务平台类型，支持 AIGateway 和 Custom。', + 'type' => 'string', + 'example' => 'Custom', + 'enum' => ['AIGateway', 'Custom'], + ], + 'transport' => [ + 'description' => 'MCP 服务传输协议，支持 http 和 sse。', + 'type' => 'string', + 'example' => 'http', + 'enum' => ['http', 'sse'], + ], + 'endpoint' => ['description' => 'MCP 服务访问地址。', 'type' => 'string', 'example' => 'https://example.com/mcp'], + 'timeout' => ['description' => '请求 MCP 服务的超时时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '5000'], + 'auth' => [ + 'description' => 'MCP 服务认证配置。', + 'type' => 'object', + 'properties' => [ + 'type' => [ + 'description' => '认证类型，目前支持 bearer。', + 'type' => 'string', + 'example' => 'bearer', + 'enum' => ['bearer'], + ], + 'keyInfo' => [ + 'description' => '认证所需的键值信息。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'description' => '认证键值信息。', 'example' => 'example-token'], + 'example' => '{"token":"example-token"}', + ], + ], + ], + ], + ], + 'tools' => [ + 'description' => 'MCP 工具列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个 MCP 工具配置。', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => 'MCP 工具名称。', 'type' => 'string', 'example' => 'query_logs'], + 'title' => ['description' => 'MCP 工具标题。', 'type' => 'string', 'example' => '查询日志'], + 'displayName' => ['description' => 'MCP 工具显示名称。', 'type' => 'string', 'example' => '日志查询工具'], + 'description' => ['description' => 'MCP 工具描述信息。', 'type' => 'string', 'example' => '查询指定日志库中的日志。'], + 'inputSchema' => [ + 'description' => 'MCP 工具输入参数的 JSON Schema。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'description' => 'MCP 工具输入 Schema 扩展字段。', 'example' => '{"type":"string"}'], + 'example' => '{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}', + ], + 'outputSchema' => [ + 'description' => 'MCP 工具输出结果的 JSON Schema。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'description' => 'MCP 工具输出 Schema 扩展字段。', 'example' => '{"type":"string"}'], + 'example' => '{"type":"object"}', + ], + 'icons' => [ + 'description' => 'MCP 工具图标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个 MCP 工具配置。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'description' => '工具图标扩展字段。', 'example' => 'https://example.com/icon.png'], + 'example' => '[]', + ], + 'example' => '[]', + ], + 'execution' => [ + 'description' => 'MCP 工具执行配置。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{}', 'description' => '工具执行配置扩展字段。'], + 'example' => '{}', + ], + 'annotations' => [ + 'description' => 'MCP 工具注解信息。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'example' => '{}', 'description' => '工具注解扩展字段。'], + 'example' => '{}', + ], + 'enable' => ['description' => '是否启用该 MCP 工具。', 'type' => 'boolean', 'example' => 'true'], + 'confirm' => ['description' => '调用该 MCP 工具前是否需要用户确认。', 'type' => 'boolean', 'example' => 'false'], + ], + 'example' => '[{"name":"query_logs"}]', + ], + 'example' => '[{"name":"query_logs"}]', + ], + 'mcpServiceName' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'example' => 'log-query'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询MCP服务列表', + 'summary' => '查询 MCP 服务列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListMcpServices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\",\\n \\"total\\": 10,\\n \\"maxResults\\": 20,\\n \\"nextToken\\": \\"eyJvZmZzZXQiOjIwfQ==\\",\\n \\"mcpServices\\": {\\n \\"mcpServiceList\\": [\\n {\\n \\"displayName\\": \\"日志查询\\",\\n \\"description\\": \\"通过 MCP 调用日志查询工具。\\",\\n \\"enable\\": true,\\n \\"network\\": {\\n \\"mode\\": \\"public\\",\\n \\"vpcId\\": \\"vpc-xxx\\",\\n \\"vswId\\": \\"vsw-xxx\\",\\n \\"accessIp\\": \\"10.0.0.12\\",\\n \\"accessPort\\": 8080,\\n \\"securityGroupId\\": \\"sg-xxx\\",\\n \\"gatewayId\\": \\"gw-xxx\\",\\n \\"mcpServerId\\": \\"mcp-xxx\\",\\n \\"region\\": \\"cn-hangzhou\\"\\n },\\n \\"connection\\": {\\n \\"platform\\": \\"Custom\\",\\n \\"transport\\": \\"http\\",\\n \\"endpoint\\": \\"https://example.com/mcp\\",\\n \\"timeout\\": 5000,\\n \\"auth\\": {\\n \\"type\\": \\"bearer\\",\\n \\"keyInfo\\": {\\n \\"key\\": \\"example-token\\"\\n }\\n }\\n },\\n \\"tools\\": [\\n {\\n \\"name\\": \\"query_logs\\",\\n \\"title\\": \\"查询日志\\",\\n \\"displayName\\": \\"日志查询工具\\",\\n \\"description\\": \\"查询指定日志库中的日志。\\",\\n \\"inputSchema\\": {\\n \\"key\\": \\"{\\\\\\"type\\\\\\":\\\\\\"string\\\\\\"}\\"\\n },\\n \\"outputSchema\\": {\\n \\"key\\": \\"{\\\\\\"type\\\\\\":\\\\\\"string\\\\\\"}\\"\\n },\\n \\"icons\\": [\\n {\\n \\"key\\": \\"https://example.com/icon.png\\"\\n }\\n ],\\n \\"execution\\": {\\n \\"key\\": \\"{}\\"\\n },\\n \\"annotations\\": {\\n \\"key\\": \\"{}\\"\\n },\\n \\"enable\\": true,\\n \\"confirm\\": false\\n }\\n ],\\n \\"mcpServiceName\\": \\"log-query\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ListThreads' => [ + 'summary' => '列出会话', + 'path' => '/digitalEmployee/{name}/threads', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'status', + 'in' => 'query', + 'schema' => ['description' => '会话状态', 'type' => 'string', 'required' => false, 'example' => 'active'], + ], + [ + 'name' => 'threadId', + 'in' => 'query', + 'schema' => ['description' => '会话 id', 'type' => 'string', 'required' => false, 'example' => 'thread-123123'."\n"], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['description' => '最大返回结果数，最大值 200', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['description' => '分页 Token', 'type' => 'string', 'required' => false, 'example' => 'xxxxxx'], + ], + [ + 'name' => 'filter', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'description' => '查询的过滤条件，若不输入则查询该实例下所有的主题。', + 'type' => 'array', + 'items' => [ + 'description' => '查询的过滤条件，若不输入则查询该实例下所有的主题。', + 'type' => 'object', + 'properties' => [ + 'key' => ['description' => '过滤 key，当前支持 title、workspace、project', 'type' => 'string', 'required' => true, 'example' => 'title'], + 'value' => ['description' => '设置的值', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + [ + 'name' => 'includeMission', + 'in' => 'query', + 'schema' => ['title' => '是否包含mission创建的thread', 'description' => '是否包含mission创建的thread', 'type' => 'boolean', 'required' => false, 'default' => 'true'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'CD8BA7D6-995D-578D-9941-xxxx'."\n"], + 'threadId' => ['description' => '会话 id', 'type' => 'string', 'example' => 'thread-123123'."\n"], + 'total' => ['description' => '总数', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'maxResults' => ['description' => '最大返回结果数，最大值 200', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'threads' => [ + 'description' => '会话', + 'type' => 'array', + 'items' => [ + 'description' => '会话', + 'type' => 'object', + 'properties' => [ + 'threadId' => ['description' => '会话 id', 'type' => 'string', 'example' => 'thread-123123'."\n"], + 'digitalEmployeeName' => ['description' => '数字员工名称', 'type' => 'string', 'example' => 'test'], + 'title' => ['description' => '会话标题', 'type' => 'string', 'example' => 'test'], + 'status' => ['description' => '会话状态', 'type' => 'string', 'example' => 'active'], + 'version' => ['description' => '版本号', 'type' => 'integer', 'format' => 'int64', 'example' => '123123'], + 'variables' => [ + 'description' => '会话属性', + 'type' => 'object', + 'properties' => [ + 'workspace' => ['description' => '工作空间。', 'type' => 'string', 'example' => 'workspace'], + 'project' => ['description' => 'SLS project。', 'type' => 'string', 'example' => 'project'], + ], + ], + 'createTime' => ['description' => '创建时间', 'type' => 'string', 'example' => '2025-12-19T15:19:55.040403272+08:00'."\n"], + 'updateTime' => ['description' => '更新时间', 'type' => 'string', 'example' => '2025-12-19T15:19:55.040403272+08:00'."\n"], + 'attributes' => [ + 'title' => '属性', + 'description' => '属性', + 'type' => 'object', + 'additionalProperties' => ['title' => '具体属性', 'description' => '具体属性', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + ], + 'nextToken' => ['description' => '分页 Token', 'type' => 'string', 'example' => 'xxxxxxxxxx'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出会话', + 'description' => '列出会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:ListThreads', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"CD8BA7D6-995D-578D-9941-xxxx\\\\n\\",\\n \\"threadId\\": \\"thread-123123\\\\n\\",\\n \\"total\\": 1,\\n \\"maxResults\\": 20,\\n \\"threads\\": [\\n {\\n \\"threadId\\": \\"thread-123123\\\\n\\",\\n \\"digitalEmployeeName\\": \\"test\\",\\n \\"title\\": \\"test\\",\\n \\"status\\": \\"active\\",\\n \\"version\\": 123123,\\n \\"variables\\": {\\n \\"workspace\\": \\"workspace\\",\\n \\"project\\": \\"project\\"\\n },\\n \\"createTime\\": \\"2025-12-19T15:19:55.040403272+08:00\\\\n\\",\\n \\"updateTime\\": \\"2025-12-19T15:19:55.040403272+08:00\\\\n\\",\\n \\"attributes\\": {\\n \\"key\\": \\"test\\"\\n }\\n }\\n ],\\n \\"nextToken\\": \\"xxxxxxxxxx\\"\\n}","type":"json"}]', + ], + 'UpdateDigitalEmployee' => [ + 'path' => '/digital-employee/{name}', + 'methods' => ['patch'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'readAndWrite', + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '数字员工结构', + 'type' => 'object', + 'properties' => [ + 'defaultRule' => ['description' => '数字员工默认规则。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'description' => ['description' => '数字员工描述信息。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'test', 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'displayName' => ['description' => '数字员工显示名称。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'test', 'maxLength' => 128, 'minLength' => 0, 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'roleArn' => ['description' => 'RAM 角色 ARN。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'acs:ram::12345678912:role/testrole'."\n", 'pattern' => '', 'readOnly' => false, 'default' => ''], + 'knowledges' => [ + 'description' => '知识库列表', + 'type' => 'object', + 'properties' => [ + 'bailian' => [ + 'description' => '百练知识库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '百练知识库列表。', + 'type' => 'object', + 'properties' => [ + 'workspaceId' => ['description' => '百练工作空间 ID。', 'type' => 'string', 'required' => false, 'example' => 'llm-xxxx'."\n"], + 'indexId' => ['description' => '百练索引 ID。', 'type' => 'string', 'required' => false, 'example' => 'index-xxxx'."\n"], + 'region' => ['description' => '知识库地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'."\n"], + 'attributes' => ['description' => '知识库属性。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + 'required' => false, + ], + 'required' => false, + ], + 'sop' => [ + 'description' => 'SOP 知识库列表', + 'type' => 'array', + 'items' => ['description' => 'SOP 知识库', 'type' => 'object', 'required' => false, 'example' => '{'."\n" + .' "type": "oss",'."\n" + .' "basePath": "docs/",'."\n" + .' "region": "cn-hangzhou",'."\n" + .' "endpoint": "oss-cn-hangzhou.aliyuncs.com",'."\n" + .' "bucket": "my-sop-bucket",'."\n" + .' "description": "sls sop"'."\n" + .' }'], + 'required' => false, + ], + ], + 'required' => false, + ], + 'attributes' => [ + 'type' => 'object', + 'deprecated' => false, + 'additionalProperties' => ['type' => 'string'], + 'readOnly' => false, + ], + 'toolPolicy' => [ + 'description' => '数字员工工具调用安全策略配置。', + 'type' => 'object', + 'properties' => [ + 'aliyun' => [ + 'description' => 'Aliyun MCP 工具调用安全策略配置。', + 'type' => 'object', + 'properties' => [ + 'enable' => ['description' => '是否启用 Aliyun MCP 工具策略。', 'type' => 'boolean', 'example' => 'true'], + 'statements' => [ + 'description' => 'Aliyun OpenAPI 工具策略语句列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单条 Aliyun OpenAPI 工具策略语句。', + 'type' => 'object', + 'properties' => [ + 'decision' => [ + 'description' => '命中该 API 后的执行策略。', + 'type' => 'string', + 'example' => 'user_ack', + 'enum' => ['deny', 'user_ack', 'allow'], + ], + 'product' => ['description' => '本条语句对应的 Aliyun OpenAPI 产品名。', 'type' => 'string', 'required' => false, 'example' => 'Sls'], + 'apiVersion' => ['description' => '本条语句对应的 Aliyun OpenAPI API 版本。', 'type' => 'string', 'required' => false, 'example' => '2020-12-30'], + 'actions' => [ + 'description' => 'Aliyun OpenAPI Action 列表，格式为 product:ApiName、product:Prefix* 或 product:*。', + 'type' => 'array', + 'items' => ['type' => 'string', 'example' => 'log:GetProject'], + 'example' => '["log:GetProject","log:CreateDashboard"]', + ], + ], + 'example' => '{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}', + ], + 'example' => '[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]', + ], + ], + 'example' => '{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}', + ], + ], + 'example' => '{"aliyun":{"enable":true,"statements":[{"decision":"user_ack","product":"Sls","apiVersion":"2020-12-30","actions":["log:GetProject","log:CreateDashboard"]}]}}', + ], + 'sandboxNetworkPolicy' => [ + 'description' => '数字员工沙箱网络 ACL 策略配置。', + 'type' => 'object', + 'properties' => [ + 'allowFqdns' => [ + 'description' => '允许访问的 FQDN 列表，最多 50 个。', + 'type' => 'array', + 'items' => ['type' => 'string'], + 'maxItems' => 50, + ], + 'allowCidrs' => [ + 'description' => '允许访问的 CIDR 或 IP 列表，最多 50 个。', + 'type' => 'array', + 'items' => ['type' => 'string'], + 'maxItems' => 50, + ], + 'enableAcl' => ['description' => '是否启用沙箱网络 ACL。', 'type' => 'boolean', 'example' => 'false'], + ], + 'example' => '{"allowFqdns":["api.example.com"],"allowCidrs":["1.2.3.0/24","8.8.8.8"],"enableAcl":false}', + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0CEC5375-C554-562B-A65F-***'."\n"], + ], + 'description' => '', + ], + ], + ], + 'title' => '更新数字员工', + 'summary' => '更新数字员工', + 'description' => '更新数字员工', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0CEC5375-C554-562B-A65F-***\\\\n\\"\\n}","type":"json"}]', + ], + 'UpdateDigitalEmployeeSkill' => [ + 'summary' => '更新技能', + 'path' => '/digitalEmployee/{name}/skill/{skillName}', + 'methods' => ['put'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'skillName', + 'in' => 'path', + 'schema' => ['description' => '技能名称', 'type' => 'string', 'required' => true, 'example' => 'test', 'minLength' => 1], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'displayName' => ['description' => '显示名称', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'description' => ['description' => '描述信息', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'enable' => ['description' => '是否启用', 'type' => 'boolean', 'required' => true, 'example' => 'true'], + 'files' => [ + 'description' => '技能文件列表', + 'type' => 'array', + 'items' => [ + 'description' => '技能文件列表', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => '文件名称', 'type' => 'string', 'required' => false, 'example' => 'SKILL.md'."\n"], + 'content' => ['description' => '文件内容', 'type' => 'string', 'required' => false, 'example' => '---'."\n" + .'name: skill'."\n" + .'description: description'."\n" + .'---'."\n" + ."\n" + .'# skill '."\n" + ."\n" + .'skill test'], + ], + 'required' => false, + ], + 'required' => true, + ], + 'remark' => ['description' => '备注', 'type' => 'string', 'required' => false, 'example' => 'remark'], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '350779DC-980D-58FD-BECB-D2275D2487CA'."\n"], + ], + 'description' => '', + ], + ], + ], + 'title' => '更新技能', + 'description' => '更新技能', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + 'additionalActions' => [], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"350779DC-980D-58FD-BECB-D2275D2487CA\\\\n\\"\\n}","type":"json"}]', + ], + 'UpdateMcpService' => [ + 'path' => '/digitalEmployee/{name}/mcpService/{mcpServiceName}', + 'methods' => ['put'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'tenant'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称。', 'type' => 'string', 'required' => true, 'example' => 'test-agent', 'minLength' => 1], + ], + [ + 'name' => 'mcpServiceName', + 'in' => 'path', + 'schema' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'required' => true, 'example' => 'log-query', 'minLength' => 1], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'displayName' => ['description' => 'MCP 服务显示名称。', 'type' => 'string', 'required' => false, 'example' => '日志查询'], + 'description' => ['description' => 'MCP 服务描述信息。', 'type' => 'string', 'required' => false, 'example' => '通过 MCP 调用日志查询工具。'], + 'enable' => ['description' => '是否启用 MCP 服务。', 'type' => 'boolean', 'required' => true, 'example' => 'true'], + 'network' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'mode' => [ + 'description' => 'MCP 服务网络访问模式，支持 public 和 vpc。', + 'type' => 'string', + 'required' => true, + 'example' => 'public', + 'enum' => ['public', 'vpc'], + ], + 'vpcId' => ['description' => '专有网络 VPC ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-xxx'], + 'vswId' => ['description' => '交换机 ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-xxx'], + 'accessIp' => ['description' => 'VPC 网络下访问 MCP 服务的 IP 地址。', 'type' => 'string', 'required' => false, 'example' => '10.0.0.12'], + 'accessPort' => ['description' => 'VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '8080'], + 'securityGroupId' => ['description' => '安全组 ID。', 'type' => 'string', 'required' => false, 'example' => 'sg-xxx'], + 'gatewayId' => ['description' => '网关 ID。', 'type' => 'string', 'required' => false, 'example' => 'gw-xxx'], + 'mcpServerId' => ['description' => 'MCP Server 实例 ID。', 'type' => 'string', 'required' => false, 'example' => 'mcp-xxx'], + 'region' => ['description' => 'VPC 网络所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + 'required' => true, + ], + 'connection' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'platform' => [ + 'description' => 'MCP 服务平台类型，支持 AIGateway 和 Custom。', + 'type' => 'string', + 'required' => true, + 'example' => 'Custom', + 'enum' => ['AIGateway', 'Custom'], + ], + 'transport' => [ + 'description' => 'MCP 服务传输协议，支持 http 和 sse。', + 'type' => 'string', + 'required' => true, + 'example' => 'http', + 'enum' => ['http', 'sse'], + ], + 'endpoint' => ['description' => 'MCP 服务访问地址。', 'type' => 'string', 'required' => true, 'example' => 'https://example.com/mcp'], + 'timeout' => ['description' => '请求 MCP 服务的超时时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5000'], + 'auth' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'type' => [ + 'description' => '认证类型，目前支持 bearer。', + 'type' => 'string', + 'required' => false, + 'example' => 'bearer', + 'enum' => ['bearer'], + ], + 'keyInfo' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'string', 'description' => '认证键值信息。', 'example' => 'example-token'], + 'example' => '{"token":"example-token"}', + ], + ], + 'required' => false, + ], + ], + 'required' => true, + ], + 'tools' => [ + 'description' => 'MCP 工具列表。', + 'type' => 'array', + 'items' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'name' => ['description' => 'MCP 工具名称。', 'type' => 'string', 'required' => true, 'example' => 'query_logs', 'minLength' => 1], + 'title' => ['description' => 'MCP 工具标题。', 'type' => 'string', 'required' => false, 'example' => '查询日志'], + 'displayName' => ['description' => 'MCP 工具显示名称。', 'type' => 'string', 'required' => false, 'example' => '日志查询工具'], + 'description' => ['description' => 'MCP 工具描述信息。', 'type' => 'string', 'required' => false, 'example' => '查询指定日志库中的日志。'], + 'inputSchema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => true, + 'additionalProperties' => ['type' => 'any', 'example' => '{"type":"string"}', 'description' => 'MCP 工具输入 Schema 扩展字段。'], + 'example' => '{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}', + ], + 'outputSchema' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'example' => '{"type":"string"}', 'description' => 'MCP 工具输出 Schema 扩展字段。'], + 'example' => '{"type":"object"}', + ], + 'icons' => [ + 'description' => 'MCP 工具图标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'example' => 'https://example.com/icon.png', 'description' => '工具图标扩展字段。'], + 'example' => '[]', + ], + 'required' => false, + 'example' => '[]', + ], + 'execution' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'example' => '{}', 'description' => '工具执行配置扩展字段。'], + 'example' => '{}', + ], + 'annotations' => [ + 'description' => '请求体参数。', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => '工具注解扩展字段。', 'example' => '{}'], + 'example' => '{}', + ], + 'enable' => ['description' => '是否启用该 MCP 工具。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'confirm' => ['description' => '调用该 MCP 工具前是否需要用户确认。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + 'required' => false, + 'example' => '[{"name":"query_logs"}]', + ], + 'required' => true, + 'example' => '[{"name":"query_logs"}]', + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '接口返回数据。', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '0B9377D9-C56B-5C2E-A8A4-************'], + 'mcpServiceName' => ['description' => 'MCP 服务名称。', 'type' => 'string', 'example' => 'log-query'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新MCP服务', + 'summary' => '更新 MCP 服务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"0B9377D9-C56B-5C2E-A8A4-************\\",\\n \\"mcpServiceName\\": \\"log-query\\"\\n}","type":"json"}]', + ], + 'UpdateThread' => [ + 'summary' => '更新会话', + 'path' => '/digitalEmployee/{name}/thread/{threadId}', + 'methods' => ['put'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'name', + 'in' => 'path', + 'schema' => ['description' => '数字员工名称', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'threadId', + 'in' => 'path', + 'schema' => ['description' => '会话 id', 'type' => 'string', 'required' => true, 'example' => 'thread-12313'."\n"], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'title' => '请求参数', + 'description' => '请求参数', + 'type' => 'object', + 'properties' => [ + 'title' => ['description' => '会话标题', 'type' => 'string', 'required' => false, 'example' => 'title'], + 'status' => [ + 'description' => '会话状态', + 'type' => 'string', + 'required' => false, + 'example' => 'active', + 'enum' => ['active', 'archived', 'failed', 'suspended', 'cancelled', 'unknown'], + ], + 'attributes' => [ + 'title' => '属性', + 'description' => '属性', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['title' => '具体属性', 'description' => '具体属性', 'type' => 'string', 'example' => 'test'], + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '264C3E89-XXXX-XXXX-XXXX-CE9C2196C7DC'], + 'threadId' => ['description' => '会话 id', 'type' => 'string', 'example' => 'thread-12313'."\n"], + 'version' => ['description' => '版本号', 'type' => 'integer', 'format' => 'int64', 'example' => '123123'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新会话', + 'description' => '更新会话', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"264C3E89-XXXX-XXXX-XXXX-CE9C2196C7DC\\",\\n \\"threadId\\": \\"thread-12313\\\\n\\",\\n \\"version\\": 123123\\n}","type":"json"}]', + ], + ], + 'endpoints' => [ + ['regionId' => 'cn-beijing', 'regionName' => '华北2（北京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'starops.cn-beijing.aliyuncs.com', 'endpoint' => 'starops.cn-beijing.aliyuncs.com', 'vpc' => 'starops-vpc.cn-beijing.aliyuncs.com'], + ['regionId' => 'ap-southeast-1', 'regionName' => '新加坡', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'starops.ap-southeast-1.aliyuncs.com', 'endpoint' => 'starops.ap-southeast-1.aliyuncs.com', 'vpc' => 'starops-vpc.ap-southeast-1.aliyuncs.com'], + ], + 'errorCodes' => [], + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ram' => [ + 'productCode' => 'STAROps', + 'productName' => '全域智能运维平台 STAROps', + 'ramCodes' => ['starops'], + 'ramLevel' => '资源级', + 'ramConditions' => [], + 'ramActions' => [ + [ + 'apiName' => 'UpdateThread', + 'description' => '更新会话', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + [ + 'apiName' => 'UpdateDigitalEmployeeSkill', + 'description' => '更新技能', + 'operationType' => 'update', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:UpdateDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + ], + [ + 'apiName' => 'DeleteMcpService', + 'description' => '删除MCP服务', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + [ + 'apiName' => 'UpdateMcpService', + 'description' => '更新MCP服务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + [ + 'apiName' => 'GetDigitalEmployee', + 'description' => '获取数字员工', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + [ + 'apiName' => 'ListArtifacts', + 'description' => '列出产物列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListArtifacts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/artifact/*'], + ], + ], + ], + [ + 'apiName' => 'ListDigitalEmployeeSkillVersions', + 'description' => '列出技能历史版本', + 'operationType' => 'list', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployeeSkillVersions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + ], + [ + 'apiName' => 'FetchRemoteMcpTools', + 'description' => '拉取远端MCP工具列表', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:FetchRemoteMcpTools', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetMcpService', + 'description' => '查询MCP服务', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + [ + 'apiName' => 'CreateDigitalEmployee', + 'description' => '创建数字员工', + 'operationType' => 'create', + 'additionalActions' => [ + ['action' => 'ram:PassRole', 'validationType' => 'always'], + ], + 'ramAction' => [ + 'action' => 'starops:CreateDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + [ + 'apiName' => 'GetArtifact', + 'description' => '获取产物内容', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetArtifact', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/artifact/*'], + ], + ], + ], + [ + 'apiName' => 'CreateTicket', + 'description' => '创建免登录票据', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateTicket', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateDigitalEmployeeSkill', + 'description' => '创建技能', + 'operationType' => 'create', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:CreateDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + ], + [ + 'apiName' => 'DeleteDigitalEmployeeSkill', + 'description' => '删除技能', + 'operationType' => 'delete', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:DeleteDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + ], + [ + 'apiName' => 'GetThread', + 'description' => '获取会话', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + [ + 'apiName' => 'ListDigitalEmployees', + 'description' => '列出数字员工', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployees', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/*'], + ], + ], + ], + [ + 'apiName' => 'CreateThread', + 'description' => '创建会话', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:CreateThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/*'], + ], + ], + ], + [ + 'apiName' => 'UpdateDigitalEmployee', + 'description' => '更新数字员工', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'starops:UpdateDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + [ + 'apiName' => 'DeleteThread', + 'description' => '删除会话', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteThread', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteDigitalEmployee', + 'description' => '删除数字员工', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'starops:DeleteDigitalEmployee', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + [ + 'apiName' => 'ListThreads', + 'description' => '列出会话', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:ListThreads', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/*'], + ], + ], + ], + [ + 'apiName' => 'GetDigitalEmployeeSkill', + 'description' => '获取技能', + 'operationType' => 'get', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:GetDigitalEmployeeSkill', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ], + ], + ], + [ + 'apiName' => 'ListMcpServices', + 'description' => '查询MCP服务列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'starops:ListMcpServices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/*'], + ], + ], + ], + [ + 'apiName' => 'GetThreadData', + 'description' => '获取会话数据', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'starops:GetThreadData', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ], + ], + ], + [ + 'apiName' => 'CreateMcpService', + 'description' => '创建MCP服务', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'starops:CreateMcpService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ], + ], + ], + [ + 'apiName' => 'CreateChat', + 'description' => '发起会话', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'starops:CreateChat', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ], + ], + ], + [ + 'apiName' => 'ListDigitalEmployeeSkills', + 'description' => '列出技能', + 'operationType' => 'list', + 'additionalActions' => [], + 'ramAction' => [ + 'action' => 'starops:ListDigitalEmployeeSkills', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'STAROps', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/*'], + ], + ], + ], + ], + 'resourceTypes' => [ + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/{#skillName}'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/{#mcpServiceName}'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/artifact/*'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/*/mcpservice/*'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/*'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/*'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployee', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/mcpservice/*'], + ['validationType' => 'always', 'resourceType' => 'DigitalEmployeeSkill', 'arn' => 'acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}/skill/*'], + ], + ], +]; |