将 Azure AI 多服务资源附加到 Azure AI 搜索中的技能组

1. 登录 Azure 门户。

2. 在搜索服务所在的同一区域中创建 Azure AI 多服务资源。

3. 从“资源”>“密钥和终结点”页获取资源密钥。

4. 向技能组定义添加密钥：

   • 如果使用导入数据向导，请创建或选择 Azure AI 帐户。 该向导会将资源密钥添加到技能集定义。

   • 对于新的或现有的技能集，请提供技能集定义中的密钥。

1. 使用创建或更新技能集 API，指定请求正文中的 cognitiveServices 部分：

PUT https://[servicename].search.azure.cn/skillsets/[skillset name]?api-version=2024-07-01
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

以下代码片段来自 azure-search-dotnet-samples，为简洁起见，已进行剪裁。

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
IConfigurationRoot configuration = builder.Build();

string searchServiceUri = configuration["SearchServiceUri"];
string adminApiKey = configuration["SearchServiceAdminApiKey"];
string cognitiveServicesKey = configuration["CognitiveServicesKey"];

SearchIndexerClient indexerClient = new SearchIndexerClient(new Uri(searchServiceUri), new AzureKeyCredential(adminApiKey));

// Create the skills
Console.WriteLine("Creating the skills...");
OcrSkill ocrSkill = CreateOcrSkill();
MergeSkill mergeSkill = CreateMergeSkill();

// Create the skillset
Console.WriteLine("Creating or updating the skillset...");
List<SearchIndexerSkill> skills = new List<SearchIndexerSkill>();
skills.Add(ocrSkill);
skills.Add(mergeSkill);

SearchIndexerSkillset skillset = CreateOrUpdateDemoSkillSet(indexerClient, skills, cognitiveServicesKey);

1. 登录到 Azure 门户。

2. 在“搜索管理 > 技能集”下，从列表中选择技能集。

   

3. 滚动到文件中包含 "cognitiveServices" 的部分。

4. 从 JSON 中删除密钥值并保存技能集。

   

1. 获取技能组，以便获得完整定义。

2. 制定更新技能组请求，提供技能组的 JSON 定义。

3. 删除定义正文中的密钥，然后发送请求：

   PUT https://[servicename].search.azure.cn/skillsets/[skillset name]?api-version=2024-07-01
   api-key: [admin key]
   Content-Type: application/json
   {
       "name": "skillset name",
       "skills": 
       [
         {
           "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
           "categories": [ "Organization" ],
           "defaultLanguageCode": "en",
           "inputs": [
             {
               "name": "text", "source": "/document/content"
             }
           ],
           "outputs": [
             {
               "name": "organizations", "targetName": "organizations"
             }
           ]
         }
       ],
       "cognitiveServices": {
           "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
           "description": "mycogsvcs",
           "key": ""
       }
   }
   

   或者，可以将“cognitiveServices”设置为 null：

   "cognitiveServices": null,