SuperAPI AI 工具集

konnect-ai-gateway

智能体与模型

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能用于对 Konnect AI Gateway 进行分层故障排查,定位请求路径、提供商定向、AI 策略与 AI 运行时可见性中最窄的失败层。适用于 AI 网关运营工作流,不适用于通用提示词工程、提供商 SDK 调试或模型质量评估。

主要能力:优先使用共享的 kong-konnect MCP 服务器实时检查控制平面、Gateway 实体与 LLM 分析界面;涉及 token 用量、延迟或 AI 请求健康时,优先使用 LLM 专用分析而非通用 API 分析。实现时保留仓库既定的声明式工具链:deck-gateway 用于 Gateway 实体 GitOps,terraform-konnect 用于 HCL 管理的 Konnect AI Gateway 资源,terraform-kong-gateway 用于自管理 HCL,kongctl-declarative 仅在仓库已采用该路径时使用。若实时 Konnect 状态重要但 kong-konnect MCP 未连接,应尽早说明并改用仓库配置或用户提供的产物。若阻塞点是通用网关可达性、发布或路由/服务健康而非 AI 层,应尽早移交给 konnect-gateway-triage。

使用方式:按需加载参考文档,不要默认全部加载——references/provider-routing.md 用于模型/提供商选择、路由定向、回退或提供商特定请求行为;references/guardrails-and-policy-intent.md 用于流量技术正常但策略意图、提示词塑造或治理行为异常;references/observability-and-cost-signals.md 用于 token、延迟、AI 专用分析或运营可见性问题。检查顺序:先分类报告,再证明基线 AI 流量路径,随后在策略之前解决提供商或模型定向,证明代理后再评估策略层,AI 运行时问题使用 LLM 分析,区分 Kong 侧治理与提供商行为,最后返回最窄的 AI 失败域。

适用场景与限制:适用于 AI 网关运营排查;需注意 AI Gateway 首先是 Gateway 表面,路由、服务与插件放置仍然重要;提示词与响应护栏扩展的是可用的 AI 代理路径而非替代它;LLM 分析应视为独立于通用 API 分析的运行时表面;技术上成功的提供商响应仍可能违反策略意图;提供商侧拒绝、配额或模型行为可穿过健康的 AI Gateway 路径。具体收费、价格与平台细节暂未提供。