用途:通过 Higress Console API(运行于 http://127.0.0.1:8001)管理 Higress AI 网关,涵盖消费者、AI 路由、LLM 提供商与 MCP 服务器。认证使用 Session Cookie,而非 Basic Auth。
环境变量:容器内已预配置 AGENTTEAMS_ADMIN_USER、AGENTTEAMS_ADMIN_PASSWORD、AGENTTEAMS_AI_GATEWAY_DOMAIN、HIGRESS_COOKIE_FILE,可直接在 bash 中使用。请求时用 curl -b "${HIGRESS_COOKIE_FILE}" 携带 Cookie;Cookie 过期可 POST /session/login 重新登录。
主要能力:
- 消费者管理:GET/POST/PUT/DELETE /v1/consumers,支持 key-auth 凭证;消费者无 version 字段,更新用 GET-改-PUT 模式。
- AI 路由管理:使用独立 API /v1/ai/routes(不要用 /v1/routes)。系统初始有 default-ai-route,无 modelPredicates。新增提供商路由时需配置 domains、upstreams、modelPredicates、authConfig,并同步更新默认路由的 modelPredicates 以避免歧义。AI 路由有 version 字段,PUT 前先 GET。
- LLM 提供商配置:GET/POST/PUT /v1/ai/providers,支持 qwen 原生类型与 openai 兼容类型,可配置 tokens、protocol、modelMapping、rawConfigs 等;提供商有 version 字段。
- MCP 服务器管理:创建、更新、列出、删除及消费者访问控制,详见 mcp-server-management 技能。
限制与注意:认证插件首次配置约需 40 秒,后续变更约 10 秒;AI 路由与提供商有 version 字段,PUT 前须 GET 最新版本;消费者无 version 字段。MCP 服务器细节需参考另一技能。