查询智能体连接详情

查询一个智能体连接的非敏感配置。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/connections/{connection_id}

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

输入示例

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/connections/$CONNECTION_ID" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

此接口没有额外请求参数。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "id": "connection_01",
    "workspace_id": "workspace_example",
    "name": "MCP 服务",
    "status": "draft",
    "kind": "mcp_server",
    "endpoint_uri": "https://mcp.example.com",
    "auth_type": "none",
    "visibility": "private",
    "version": 1,
    "created_at": "2026-10-14T00:00:00Z",
    "updated_at": "2026-10-14T00:00:00Z",
    "config": {
      "transport": "http-streaming"
    }
  }
}

字段说明

字段	类型	说明
code	integer	请求处理成功时为 0。
data	object	响应数据。
data.id	string	连接 ID。
data.workspace_id	string	所属工作区 ID。
data.name	string	连接名称。
data.description	string	说明。未设置时可省略。
data.status	string	当前状态。取值：draft、active、disabled、archived。
data.kind	string	连接类型。取值：model_api、huggingface、mcp_server、http_api、external_drive、object_storage、database、webhook、channel。
data.endpoint_uri	string	服务端点地址。
data.auth_type	string	认证方式。取值：none、api_key、bearer_token、oauth2、basic、custom_headers、service_account、client_certificate。
data.credential_ref	string	已保存凭据的引用，不是明文密钥。未设置时可省略。
data.capabilities	string（字符串数组）	可用能力列表。未设置时可省略。
data.owner_user_id	string	所属用户标识。未设置时可省略。
data.visibility	string	可见范围。取值：private、workspace。
data.config	object	非敏感配置，字段随连接或通道类型变化。未设置时可省略。
data.last_test_status	string	最近测试状态，取 succeeded 或 failed。未设置时可省略。取值：succeeded、failed。
data.last_tested_at	string	最近测试时间，采用 RFC 3339 格式。未设置时可省略。
data.last_test_error	string	最近测试的错误说明。未设置时可省略。
data.version	integer	当前版本号。
data.labels	object	标签键值对。未设置时可省略。
data.annotations	object	扩展注解。未设置时可省略。
data.metadata	object	扩展元数据。未设置时可省略。
data.created_by	string	创建者标识。未设置时可省略。
data.updated_by	string	最近更新者标识。未设置时可省略。
data.created_at	string	创建时间，采用 RFC 3339 格式。
data.updated_at	string	最近更新时间，采用 RFC 3339 格式。

错误响应

响应示例

{
  "code": 3,
  "message": "connection not found"
}

字段说明

字段	类型	说明
code	integer	错误代码。
message	string	面向调用者的错误信息。

最后更新于 2026 年 10 月 19 日