用途:这是 Pipefy 解析策略(Tier 2)中的技能,用于在专用操作失败或不存在时,先理解 API 结构再直接执行 GraphQL。Tier 1 是专用操作,Tier 2 是本技能的内省加 execute_graphql,Tier 3 是直接 HTTP 回退(见 pipefy-api-fallback)。
主要能力:提供多个操作。只读的 introspect_type 返回类型结构(字段、inputFields、enumValues),introspect_query 和 introspect_mutation 返回根查询/变更的参数与返回类型,search_schema 按关键字搜索类型名与描述,get_organization 和 list_organizations 用于获取组织信息(名称、计划、UUID、成员数、pipe 数),list_organizations 无需 id,是组织发现的入口。execute_graphql 非只读,用于执行任意 GraphQL。
使用方式:发现变更签名时,先用 search_schema keyword="label" 搜索,再 introspect_mutation mutation_name="createLabel",然后 introspect_type type_name="CreateLabelInput",最后用 execute_graphql 执行。introspect 的 max_depth 默认 1,设为 2 以上可内联解析引用的输入/输出类型;标量不会展开。search_schema 可用 kind 过滤(OBJECT、INPUT_OBJECT、ENUM、SCALAR、INTERFACE、UNION)。资料还给出多个回退配方,例如查询卡片标题、发现 extra_input 可选键、通过 pipe(id) 找组织 uuid、更新选择字段选项、检查阶段转换规则等。
限制:应优先使用专用操作,它们会校验输入、处理分页并统一格式化错误;execute_graphql 仅作为回退。若专用写入报告失败,应先重读目标确认写入未生效再重试,结果不确定时应停止,避免重复创建数据。introspect_mutation 较昂贵(拉取全部根变更字段并在客户端过滤);introspect_type 返回 null 通常是类型名大小写问题。原始 HTTP 端点默认为 https://app.pipefy.com/graphql。