Aktualizace sady dovedností (rozhraní REST API služby Azure AI Search)

  • Článek

Existující sadu dovedností a úložiště znalostí můžete aktualizovat pomocí http PUT a zadat název sady dovedností, která se má aktualizovat, v identifikátoru URI požadavku.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=[api-version]
  Content-Type: application/json
  api-key: [admin key]

Poznámka

Sady dovedností jsou základem rozšiřování AI ve službě Azure AI Search. Bezplatný prostředek je k dispozici pro omezené zpracování, ale pro větší a častější úlohy se vyžaduje fakturovatelný prostředek služeb Cognitive Services. Další informace najdete v tématu Připojení prostředku služeb Cognitive Services k sadě dovedností Azure AI Search.

Parametry identifikátoru URI

Parametr Popis
název služby Povinná hodnota. Nastavte ho na jedinečný, uživatelem definovaný název vaší vyhledávací služby.
název sady dovedností Povinná hodnota. Identifikátor URI požadavku určuje název sady dovedností, která se má aktualizovat.
verze-api Povinná hodnota. Aktuální stabilní verze je api-version=2020-06-30. Další verze najdete v tématu Verze rozhraní API .
disableCacheReprocessingChangeDetection Nepovinný parametr. Používá se pro přírůstkové rozšiřování (false ve výchozím nastavení). Pokud chcete zabránit aktualizacím existujících dokumentů na základě aktuální akce, nastavte na true hodnotu . Další informace najdete v tématu Správa mezipaměti.

Hlavičky požadavku

Následující tabulka popisuje požadovanou a volitelnou hlavičku požadavku.

Pole Description
Typ obsahu Povinná hodnota. Nastavte tuto možnost na application/json
klíč rozhraní API Volitelné, pokud používáte role Azure a v požadavku je k dispozici nosný token, jinak se vyžaduje klíč. Klíč api-key je jedinečný, systémem vygenerovaný řetězec, který ověřuje požadavek na vaši vyhledávací službu. Žádosti o aktualizaci musí obsahovat hlavičku nastavenou api-key na klíč správce (na rozdíl od klíče dotazu). Podrobnosti najdete v tématu Připojení ke službě Azure AI Search pomocí ověřování pomocí klíče .

Text požadavku

Syntaxe textu požadavku je stejná jako u příkazu Vytvořit sadu dovedností.

Při aktualizaci existující sady dovedností se celá definice nahradí obsahem textu požadavku. Obecně platí, že nejlepším vzorem pro aktualizace je načtení definice sady dovedností pomocí get, úprava a následná aktualizace pomocí PUT.

Odpověď

V případě úspěšného požadavku by se měl zobrazit stavový kód 201 Vytvořeno.

Ve výchozím nastavení bude text odpovědi obsahovat json pro definici sady dovedností, která byla vytvořena. Pokud je ale hlavička žádosti Prefer nastavená na return=minimal, text odpovědi bude prázdný a stavový kód úspěchu bude "204 Žádný obsah" místo "201 Vytvořeno". To platí bez ohledu na to, jestli se k vytvoření sady dovedností používá PUT nebo POST.

Příklady

Příklad: Aktualizace sady dovedností

Následující příklad aktualizuje sadu dovedností používanou k rozšíření kolekce finančních dokumentů.

PUT https://[servicename].search.windows.net/skillsets/financedocenricher?api-version=2020-06-30
api-key: [admin key]
Content-Type: application/json

Text požadavku je dokument JSON. Tato konkrétní sada dovedností používá dvě dovednosti asynchronně, nezávisle zpracovávají podstatu /document/content jako dvě různé transformace. Alternativně můžete nasměrovat výstup jedné transformace tak, aby byl vstupem jiné transformace. Další informace najdete v tématu Jak definovat sadu dovedností.

{
  "name": "financedocenricher",
  "description": 
  "An updated version of a skillset used to extract sentiment from financial records, extract company names, and then find additional information about each company mentioned. This version changes the target names.",
  "skills":
  [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "categories": [ "Organization" ],
      "defaultLanguageCode": "en",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "companies"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "score",
          "targetName": "positivityscore"
        }
      ]
    },
  ],
  "cognitiveServices": 
  {
  "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
  "description": "mycogsvcs resource in West US 2",
  "key": "<your key goes here>"
  }
}

Příklad: Odebrání klíče služeb Cognitive Services

Pokud chcete aktualizovat existující sadu dovedností a odebrat klíč služeb Cognitive Services, který je k ní připojený, upravte cognitiveServices oddíl nastavením @odata.type na #Microsoft.Azure.Search.DefaultCognitiveServices.

{
  "name": "financedocenricher"
  "skills":
  [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "categories": [ "Organization" ],
      "defaultLanguageCode": "en",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "companies"
        }
      ]
    },
  ],
  "cognitiveServices": 
  {
  "@odata.type": "#Microsoft.Azure.Search.DefaultCognitiveServices"
  }
}

Viz také