summaryrefslogtreecommitdiff
path: root/data/zh_cn/starops
diff options
context:
space:
mode:
authorZhineng Li <im@zhineng.li>2026-07-12 17:11:17 +0800
committerZhineng Li <im@zhineng.li>2026-07-12 17:11:17 +0800
commit1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch)
tree5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/starops
parent7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff)
downloadafterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz
afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip
update APIs 20260712
Diffstat (limited to 'data/zh_cn/starops')
-rw-r--r--data/zh_cn/starops/2026-04-28/api-docs.php3750
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/*'],
+ ],
+ ],
+];
generated by cgit v1.2.3 (git 2.46.0) at 2026-07-12 18:37:33 +0000