使用M365 Agents Toolkit声明式Agent连接Azure Logic Apps时遇处理错误

我使用M365 Agents Toolkit创建了声明式代理（Declarative Agent），通过OpenAPI配置了连接Azure Logic Apps的动作。该Logic Apps通过HTTP请求触发工作流：

• 调用时自适应卡片（Adaptive Card）的请求体输入格式正确，但确认运行后提示处理错误
• 用Insomnia调用相同端点和请求体JSON可正常运行，但代理确认运行时，网络监控显示未发起任何出站请求
• 已尝试重新关联动作与代理、禁用并重新启用Logic Apps、重新部署代理，问题依旧

附上OpenAPI YAML配置：

openapi: 3.0.4
info:
  title: <LogicAppName> - Subset
  description: Azure Logic App.
  version: 1.0.0.0
servers:
  - url: https://<azure>/workflows/<WorkflowId>/triggers
paths:
  /<TriggerName>/paths/invoke:
    post:
      description: This calls a logic app with the specific url and passes the data. This will <info>.
      operationId: <TriggerName>_invoke
      parameters:
        - name: api-version
          in: query
          required: true
          schema:
            type: string
            enum: ['2016-10-01']
          description: The API version to use for this operation.
        - name: sp
          in: query
          required: true
          schema:
            type: string
            enum: ['/triggers/<TiggerName>/run']
          description: The specific operation to run.
        - name: sv
          in: query
          required: true
          schema:
            type: string
            enum: ['1.0']
          description: The version of the service to use.
        - name: sig
          in: query
          required: true
          schema: 
            type: string
            enum: ['<SIG>']
          description: The signature for the request.
      requestBody:
        description: The request body.
        content:
          application/json:
            schema:
              type: object
              properties:
                <request body>
      responses:
        '200':
          description: The Logic App Response.
          content:
            application/json:
              schema:
                type: object
        default:
          description: The Logic App Response.
          content:
            application/json:
              schema:
                type: object
components: { }

可能的问题及排查方向 #

• OpenAPI配置拼写错误：检查sp参数的enum值中的<TiggerName>，此处存在拼写错误（应为TriggerName），参数不匹配会直接导致代理无法生成合法请求，进而不发起出站请求。
• 请求体Schema定义不完整：OpenAPI中properties下仅保留了<request body>占位符，未明确实际字段结构。M365代理无法解析完整的请求体模板，会导致请求构造失败，终止出站请求。需替换为实际的请求体字段定义，例如：

  properties:
    userEmail:
      type: string
    requestContent:
      type: object
  

• 参数约束过严：api-version、sv等参数使用enum固定值，若代理传递参数时出现细微差异（如格式、大小写），会触发参数校验失败，请求被拦截。可尝试将enum改为const以明确固定值，或者放宽约束：

  schema:
    type: string
    const: '2016-10-01'
  

• 代理权限与网络限制：确认M365代理所在环境具备访问Azure Logic Apps端点的网络权限（如防火墙、代理服务器未阻止出站请求）；同时检查代理所用身份是否拥有调用该Logic Apps的权限（Insomnia使用的身份与代理身份可能不同）。
• 代理动作触发逻辑缺失：声明式代理可能需要明确的指令关联动作触发逻辑，需检查代理配置中，自适应卡片的确认按钮是否正确绑定到OpenAPI定义的<TriggerName>_invoke操作，确保触发时会执行请求发送逻辑。

内容的提问来源于stack exchange，提问作者user31174201