如何向Azure AI Search的Custom Web API Skill传递参数

要同时传递动态的文档属性、静态布尔值和列表参数，你需要在Custom Web API Skill的**输入(Inputs)**区域使用JSON格式定义参数结构，结合动态路径表达式和静态值表达式来实现：

输入配置示例 #

[
  {
    "name": "document_content",
    "source": "/document/content"
  },
  {
    "name": "enable_processing",
    "source": "=true"
  },
  {
    "name": "target_keywords",
    "source": "=['azure', 'search', 'cognitive']"
  }
]

配置说明 #

• 动态文档属性：直接使用/document/[属性名]作为source，比如/document/content会提取当前文档的content字段值。
• 静态布尔值：用=true或=false的表达式形式，等号表示这是静态值，无需解析文档路径。
• 静态列表：用=[元素1, 元素2, ...]的表达式形式，直接定义JSON数组作为静态参数传递。

API接收的请求格式 #

Azure AI Search会将这些参数打包成标准技能请求格式发送到你的Web API，示例请求体如下：

{
  "values": [
    {
      "recordId": "1",
      "data": {
        "document_content": "文档的实际内容",
        "enable_processing": true,
        "target_keywords": ["azure", "search", "cognitive"]
      }
    }
  ]
}

门户操作步骤 #

1. 在Azure AI Search的技能集编辑页面，添加或打开Custom Web API Skill配置界面。
2. 找到**输入(Inputs)**区域，若默认是可视化编辑，切换到JSON编辑模式（通常有"编辑JSON"按钮）。
3. 按照上述示例编写输入JSON，替换成你的实际参数名、文档属性和静态值。
4. 完成API URL、密钥、输出字段等其他配置后，保存技能集即可。

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