SuperAPI AI 工具集

gateway-plugin-datakit

部署与运维

查看项目

更新于 10-15 23:47

技能介绍

用途:帮助把编排需求转化为正确的 Kong DataKit 流程,或调试已有流程,避免混入通用 Gateway 或声明式工具指导。核心推理范围包括阶段选择、节点选择、DAG 结构、连接形态、缓存或 vault 需求以及调试策略。

主要能力:优先在已拥有该流程的产物上工作。若仓库中已有 deck、kong.yaml 或其他声明式配置下的 DataKit YAML,则就地编辑;若依赖当前 Konnect 状态且可用 kong-konnect MCP,则用它检查已附加的插件实例,确认问题在保存的配置还是仓库副本;若仅涉及 DataKit 流程行为,则留在本技能内,仅当工作主要变为 decK、kongctl 或 Terraform 打包时再移交。

参考文件按分支加载:references/node-reference.md 用于选择节点类型、检查必填字段或确认节点与隐式对象可读写内容;references/patterns.md 用于把用户工作流转化为扇出合并、认证注入、缓存、XML 转换、动态 URL 或头部变更等起始流程形态;references/resources-and-debugging.md 用于缓存或 vault 资源、实时调试追踪、部署拓扑或版本门控行为。本地已有 YAML 时可运行 scripts/validate_datakit_flow.py 做确定性检查。

使用方式:先分类请求,确认流程运行在 access 还是 response 阶段,确认插件应修改 service_request、修改 response 还是用 exit 短路,确认附加边界(service、route、consumer、consumer group 或 global)。再把任务缩减为小 DAG,列出必须发生的外部调用、转换、门控与写入,用最少节点保持清晰,独立调用节点默认并发。按行为而非示例选节点:HTTP 用 call,重塑用 jq,条件路径用 branch,查找或存储用 cache,Kong 内部用 property,仅需提前终止时用 exit。用 input 或 inputs 显式连接,仅在节点需要时添加 resources.cache 或 resources.vault,优先使用 vault 支持的密钥而非硬编码凭据。调试从第一个断裂边开始,结构问题先跑校验器,实时执行问题启用 DataKit 调试模式并检查追踪中最早的 NODE_ERROR 或 NODE_CANCELED 上游原因。

限制与注意:隐式节点是阶段绑定的接口而非普通节点,request 与 service_request 属于 access,service_response 与 response 属于 response;branch 只控制调度哪些命名节点,不替代数据依赖;cache 与 vault 节点缺少匹配的 resources.* 配置则不完整;非 2xx 的 call 响应通常是流程错误,不要假设下游存在响应体;部分能力受版本门控,面向旧网关时需先验证支持。本地文件校验命令为 python3 plugins/kong-konnect/skills/gateway-plugin-datakit/scripts/validate_datakit_flow.py <yaml-path>。当工作变为声明式 Gateway 文件集成、diff 或 apply 时移交 deck-gateway;变为 Terraform 提供者 schema 或状态行为时移交 terraform-kong-gateway 或 terraform-konnect;仓库已用 kongctl plan 或 apply 时移交 kongctl-declarative。