查询连接器服务目录¶
读取智能体资源中心的连接器服务及当前配置标志。该目录包含搜索、监控、集群和邮箱服务,不是数据连接器实例列表。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/connector-catalog
调用前准备¶
按AI Studio取得当前环境的个人访问令牌和工作区ID。当前有效角色须获准执行相应操作。
查询参数¶
curl --get "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/connector-catalog" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
当前环境的目标工作区ID,与请求头一致。 |
|
string |
是 |
当前环境的工作区ID。 |
|
string |
是 |
当前环境的个人访问令牌。 |
无分页、名称或provider筛选参数。示例的八个configured均为false,仅表示示例工作区尚无启用配置。
成功响应¶
{
"code": 0,
"data": {
"items": [
{
"provider": "bocha",
"name": "博查 Web Search",
"description": "配置博查 API Key 后使用网页搜索。",
"configured": false
},
{
"provider": "tavily",
"name": "Tavily Web Search",
"description": "配置 Tavily API Key 后使用网页搜索。",
"configured": false
},
{
"provider": "brave",
"name": "Brave Search",
"description": "配置 Brave Search Subscription Token 后使用网页搜索。",
"configured": false
},
{
"provider": "deepseek",
"name": "DeepSeek",
"description": "配置工作区 DeepSeek Search/Fetch 服务后搜索和获取公开网页。",
"configured": false
},
{
"provider": "grafana",
"name": "Grafana",
"description": "Grafana 健康状态、数据源、Prometheus 和 Loki 查询能力。",
"configured": false
},
{
"provider": "kubernetes",
"name": "Kubernetes",
"description": "Kubernetes Namespace、Node、Pod、Deployment、Service 和 Event 读取能力。",
"configured": false
},
{
"provider": "mail",
"name": "标准邮箱",
"description": "通过标准 IMAP/SMTP 收取和发送邮件。",
"configured": false
},
{
"provider": "qq_mail",
"name": "QQ 邮箱",
"description": "通过 IMAP/SMTP 连接 QQ 邮箱,读取、搜索邮件并查看附件。",
"configured": false
}
]
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0。 |
|
object(对象数组) |
当前目录条目;接口不分页。 |
|
string |
服务提供方标识,用于后续选择连接器。 |
|
string |
按当前语言返回的服务名称。 |
|
string |
按当前语言返回的服务说明。 |
|
boolean |
当前工作区存在该provider的active/channel配置时为true;不是连通测试结果。 |
错误响应¶
HTTP / code |
条件与处理 |
|---|---|
400 / 2 |
工作区标识无效等参数错误。 |
403 / 5 |
当前授权拒绝。 |
503 / 15 |
连接器或授权依赖不可用。 |
认证阶段还可返回字符串code/msg;具体说明见错误与环境。
最后更新于