You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Azure自定义连接器x-ms-dynamic-schema动态架构不生效问题咨询

Azure自定义连接器x-ms-dynamic-schema不渲染问题修复方案

出现动态schema仅显示body参数名不渲染字段的情况,按以下步骤修改OpenAPI定义即可解决:

  • 补全获取动态schema接口的响应结构定义
    原GetActionSchema接口的200响应仅声明了通用object类型,连接器无法提前识别返回结构,修改为匹配实际返回的格式:
/api/v1/actions/{actionId}:
    get:
      description: Gets the schema of the selected action
      summary: Get's the schema of the selected action
      operationId: GetActionSchema
      parameters:
      - {name: actionId, in: path, required: true, type: string, x-ms-summary: Select Action}
      responses:
        '200':
          description: OK
          schema:
            type: object
            properties:
              parameters:
                type: object
                description: 动态表单参数集合
                additionalProperties:
                  type: object
                  properties:
                    description:
                      type: string
                    required:
                      type: boolean
                    type:
                      type: string
                    position:
                      type: integer
  • 校验动态schema返回值格式
    返回的parameters字段下的每个子属性必须严格符合OpenAPI 2.0规范:
    • 数组类型必须明确声明items属性指定数组元素类型
    • 对象类型如果有固定子属性需要声明properties结构
    • 不要使用连接器不支持的自定义类型或格式
  • 清除缓存重新测试
    修改完OpenAPI定义并更新自定义连接器后,需要删除工作流/应用中旧的ExecuteSTAction操作实例,重新添加该操作,选择对应action后等待2-3秒即可渲染出完整的动态表单字段。

截图

内容的提问来源于stack exchange,提问作者David Meu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.23 14:36:02