更新 MCP 服務。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
starops:UpdateMcpService |
update |
*DigitalEmployee
|
無 | 無 |
請求文法
PUT /digitalEmployee/{name}/mcpService/{mcpServiceName} HTTP/1.1
路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| name |
string |
是 |
數位員工名稱。 |
test-agent |
| mcpServiceName |
string |
是 |
MCP 服務名稱。 |
log-query |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| body |
object |
否 |
請求體參數。 |
|
| displayName |
string |
否 |
MCP 服務顯示名稱。 |
日志查询 |
| description |
string |
否 |
MCP 服務描述資訊。 |
通过 MCP 调用日志查询工具。 |
| enable |
boolean |
是 |
是否啟用 MCP 服務。 |
true |
| network |
object |
是 |
請求體參數。 |
|
| mode |
string |
是 |
MCP 服務網路存取模式,支援 public 和 vpc。 |
public |
| vpcId |
string |
否 |
專有網路 VPC ID。 |
vpc-xxx |
| vswId |
string |
否 |
交換機 ID。 |
vsw-xxx |
| accessIp |
string |
否 |
VPC 網路下存取 MCP 服務的 IP 位址。 |
10.0.0.12 |
| accessPort |
integer |
否 |
VPC 網路下存取 MCP 服務的連接埠,取值範圍為 1 到 65535。 |
8080 |
| securityGroupId |
string |
否 |
安全性群組 ID。 |
sg-xxx |
| gatewayId |
string |
否 |
閘道 ID。 |
gw-xxx |
| mcpServerId |
string |
否 |
MCP Server 執行個體 ID。 |
mcp-xxx |
| region |
string |
否 |
VPC 網路所在地域。 |
cn-hangzhou |
| connection |
object |
是 |
請求體參數。 |
|
| platform |
string |
是 |
MCP 服務平台類型,支援 AIGateway 和 Custom。 |
Custom |
| transport |
string |
是 |
MCP 服務傳輸協定,支援 http 和 sse。 |
http |
| endpoint |
string |
是 |
MCP 服務存取位址。 |
https://example.com/mcp |
| timeout |
integer |
否 |
請求 MCP 服務的逾時時間,單位為毫秒。 |
5000 |
| auth |
object |
否 |
請求體參數。 |
|
| type |
string |
否 |
認證類型,目前支援 bearer。 |
bearer |
| keyInfo |
object |
否 |
請求體參數。 |
{"token":"example-token"} |
|
string |
否 |
認證鍵值資訊。 |
example-token |
|
| tools |
array<object> |
是 |
MCP 工具列表。 |
[{"name":"query_logs"}] |
|
array<object> |
否 |
請求體參數。 |
[{"name":"query_logs"}] |
|
| name |
string |
是 |
MCP 工具名稱。 |
query_logs |
| title |
string |
否 |
MCP 工具標題。 |
查询日志 |
| displayName |
string |
否 |
MCP 工具顯示名稱。 |
日志查询工具 |
| description |
string |
否 |
MCP 工具描述資訊。 |
查询指定日志库中的日志。 |
| inputSchema |
object |
是 |
請求體參數。 |
{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]} |
|
any |
否 |
MCP 工具输入 Schema 扩展字段。 |
{"type":"string"} |
|
| outputSchema |
object |
否 |
請求體參數。 |
{"type":"object"} |
|
any |
否 |
MCP 工具输出 Schema 扩展字段。 |
{"type":"string"} |
|
| icons |
array<object> |
否 |
MCP 工具圖示列表。 |
[] |
|
object |
否 |
請求體參數。 |
[] |
|
|
any |
否 |
工具图标扩展字段。 |
https://example.com/icon.png |
|
| execution |
object |
否 |
請求體參數。 |
{} |
|
any |
否 |
工具执行配置扩展字段。 |
{} |
|
| annotations |
object |
否 |
請求體參數。 |
{} |
|
any |
否 |
工具注解扩展字段。 |
{} |
|
| enable |
boolean |
否 |
是否啟用該 MCP 工具。 |
true |
| confirm |
boolean |
否 |
呼叫該 MCP 工具前是否需要使用者確認。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
介面回傳資料。 |
||
| requestId |
string |
請求 ID。 |
0B9377D9-C56B-5C2E-A8A4-************ |
| mcpServiceName |
string |
MCP 服務名稱。 |
log-query |
樣本
正常返回樣本
JSON格式
{
"requestId": "0B9377D9-C56B-5C2E-A8A4-************",
"mcpServiceName": "log-query"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。