用途:针对 Genesys Cloud Platform API 的 Swagger 2.0 schema 提供 jq 查询模式,帮助提取接口端点信息。schema 包含 1900 多个端点和 4305 个定义,文件 19MB 以上。
主要能力:搜索匹配端点、确认指定端点是否存在、提取完整操作详情(operationId、summary、description、权限、参数)。
使用方式:首次使用前须在本技能目录执行 ./scripts/download-schema.sh 下载 schema.json,并设置 SCHEMA="<resolved-skill-directory>/schema.json"。查询须遵循四步工作流:先用 jq 搜索端点(限制 15-20 个结果),再确认确切路径存在,然后提取操作详情,最后按模板回复。步骤 1-3 为独立查询,应在单条消息中并行执行。示例搜索:jq -r '.paths | keys | map(select(test("KEYWORD"; "i"))) | .[0:15] | .[]' "$SCHEMA";提取示例:jq '.paths["/api/v2/exact/path"]["METHOD"] | {operationId, summary, description, permissions: ."x-inin-requires-permissions", parameters: [.parameters[]? | {name, in, required, type, description}]}' "$SCHEMA"。
适用场景:用户询问 Genesys Cloud API 端点、权限、参数或响应格式时。
限制:禁止基于 REST 惯例假定端点存在、猜测路径或未经查询就推荐端点;验证失败须说明端点不存在于 schema 中。回复须使用结构化模板。官方文本未提供更多收费、平台与效果信息。