按新配置查询系统智能体 GitHub 项目¶

提交 GitHub 通道配置并查询可用于系统智能体配置的项目。请求不会保存该配置。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/system-agent-setups/{agent_id}/github-projects

调用前准备¶

准备个人访问令牌、目标工作区 ID 和系统智能体 ID。

请求体¶

将示例中的 $WORKSPACE_ID、$AGENT_ID、$AI_STUDIO_API_KEY、$GITHUB_ACCESS_TOKEN 替换为实际值。

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/system-agent-setups/$AGENT_ID/github-projects" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg token "$GITHUB_ACCESS_TOKEN" '{config:{owner:"matrixorigin",repository:"matrixflow"},secrets:{access_token:$token}}')"

参数说明

参数	类型	是否必填	说明
`workspace_id`	string	是	所属工作区 ID。
`agent_id`	string	是	智能体 ID。

请求体

字段	类型	是否必填	说明
`name`	string	否	通道名称。此查询不会保存该值。
`description`	string	否	通道说明。此查询不会保存该值。
`config`	object	是	GitHub 通道配置，例如仓库所属组织和仓库名称。
`config.owner`	string	对象提供时	所有者。不能为空。
`config.repository`	string	对象提供时	仓库名称。不能为空。
`config.base_url`	string	否	企业 GitHub 服务地址。
`secrets`	object	是	GitHub 通道所需的密钥配置。此查询只用于读取项目，不会保存密钥。
`secrets.access_token`	string	对象提供时	GitHub 访问令牌。不能为空。

config.owner、config.repository 与 secrets.access_token 必须提供。config.base_url 可用于企业 GitHub 地址。令牌仅通过安全环境变量构造请求，不要写进示例文件或日志。

成功响应¶

响应示例

{
  "code": 0,
  "data": {
    "items": []
  }
}

字段说明

字段	类型	说明
`data.items`	object（对象数组）	与提交配置匹配的项目。
`data.items[].project_id`	string	GitHub项目 ID。
`data.items[].owner`	string	所有者。
`data.items[].owner_type`	string	所有者类型。
`data.items[].number`	integer	编号。
`data.items[].title`	string	标题。
`data.items[].url`	string	地址。
`data.items[].host`	string	主机。

错误响应¶

响应示例

{
  "code": 2,
  "message": "invalid request"
}

字段说明

请求配置缺少仓库所有者、仓库名称或访问令牌时，返回参数错误。

最后更新于 2026 年 10 月 19 日