Többszolgáltatásos Azure AI-erőforrás csatolása egy készségkészlethez az Azure AI Searchben

Ha opcionális AI-bővítési folyamatot konfigurál az Azure AI Searchben, korlátozott számú dokumentumot ingyenesen bővíthet. A nagyobb és gyakoribb számítási feladatokhoz többszolgáltatásos Azure AI-erőforrást kell csatolnia.

A többszolgáltatásos erőforrások az Azure AI-szolgáltatások egy készletére hivatkoznak ajánlatként, nem pedig egyedi szolgáltatásokra, egyetlen API-kulccsal biztosított hozzáféréssel. Ez a kulcs egy készségkészletben van megadva, és lehetővé teszi a Microsoft számára, hogy díjat számítsunk fel az alábbi szolgáltatások használatáért:

• Azure AI Vision képelemzéshez és optikai karakterfelismeréshez (OCR)
• Azure AI Language nyelv nyelvfelismeréshez, entitásfelismeréshez, hangulatelemzéshez és kulcskifejezés-kinyeréshez
• Azure AI Speech szöveghez és szövegfelolvasáshoz
• Azure AI Translator gépi szövegfordításhoz

Tipp.

Az Azure infrastruktúrát biztosít a számlázás és a költségvetések figyeléséhez. Az Azure AI-szolgáltatások monitorozásáról további információt az Azure AI-szolgáltatások költségeinek megtervezése és kezelése című témakörben talál.

Az erőforráskulcs beállítása

Az Azure Portal, a REST API vagy az Azure SDK használatával számlázható erőforrást csatolhat egy készségkészlethez.

Ha nem adja meg a tulajdonságot, a keresési szolgáltatás napi rendszerességgel megkísérli használni az indexelő számára elérhető ingyenes bővítéseket. A számlázható képességek végrehajtása indexelőhívásonként 20 tranzakciónál leáll, és az indexelőzmények végrehajtási előzményeiben megjelenik egy "Időtúllépés" üzenet.

Azure Portal

1. Jelentkezzen be az Azure Portalra.

2. Többszolgáltatásos Azure AI-erőforrás létrehozása a keresési szolgáltatással azonos régióban.

3. Adja hozzá a kulcsot egy készségkészlet-definícióhoz:

   • Ha az Adatok importálása varázslót használja, a második lépésben adja meg az "AI-bővítések hozzáadása" billentyűt.

   • Ha hozzáadja a kulcsot egy új vagy meglévő készségkészlethez, adja meg a kulcsot az Azure AI-szolgáltatások lapján.

   

REST

1. Többszolgáltatásos Azure AI-erőforrás létrehozása a keresési szolgáltatással azonos régióban.

2. Hozzon létre vagy frissítsen egy készségkészletet, és adja meg cognitiveServices a készségkészlet-kérelem törzsének szakaszát:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
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>"
    }
}

.NET SDK

A következő kódrészlet az azure-search-dotnet-samples kódrészletből származik, és rövidítésre van vágva.

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);

A kulcs eltávolítása

A bővítés számlázható műveletek. Ha már nem kell meghívnia az Azure AI-szolgáltatásokat, kövesse ezeket az utasításokat a többrégiós kulcs eltávolításához és a külső erőforrás használatának megakadályozásához. A kulcs nélkül a képességkészlet naponta 20 ingyenes tranzakció alapértelmezett kiosztására tér vissza indexelőnként. A számlázható képességek végrehajtása 20 tranzakciónál leáll, és az indexelőzmények végrehajtási előzményei között megjelenik egy "Időtúllépés" üzenet, amikor a foglalás fel van használva.

Azure Portal

1. Jelentkezzen be az Azure Portalra , és nyissa meg a keresési szolgáltatás áttekintési oldalát.

2. A Képességkészletek csoportban válassza ki az eltávolítani kívánt kulcsot tartalmazó készségkészletet.

   

3. Görgessen a fájl végéhez.

4. Távolítsa el a kulcsot a JSON-ból, és mentse a készségkészletet.

   

REST

1. Szerezze be a Skillsetet , hogy a teljes definícióval rendelkezzen.

2. Fogalmazzon meg egy frissítési készségkészlet-kérést , amely megadja a képességkészlet JSON-definícióját.

3. Távolítsa el a kulcsot a definíció törzsében, majd küldje el a kérést:

   PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
   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": ""
       }
   }
   

   Másik lehetőségként beállíthatja a "cognitiveServices" értéket null értékre:

   "cognitiveServices": null,
   

A kulcs használata

A kulcsalapú számlázás akkor érvényes, ha az Azure AI-szolgáltatások erőforrásaiba irányuló API-hívások száma indexelőnként meghaladja a napi 20 API-hívást.

A kulcs a számlázáshoz használatos, de a bővítési műveletek kapcsolataihoz nem. Kapcsolatok esetén a keresési szolgáltatás a belső hálózaton keresztül csatlakozik egy azure AI-szolgáltatási erőforráshoz, amely ugyanabban a fizikai régióban található. Az Azure AI Search szolgáltatást kínáló legtöbb régió más Azure AI-szolgáltatásokat is kínál, például a Language szolgáltatást. Ha olyan régióban próbál mesterséges intelligenciát bővíteni, amely nem rendelkezik mindkét szolgáltatással, a következő üzenet jelenik meg: "A megadott kulcs nem érvényes CognitiveServices-típuskulcs a keresési szolgáltatás régiójához".

A beépített képességek számlázásához jelenleg nyilvános kapcsolat szükséges az Azure AI Search és egy másik Azure AI-szolgáltatás között. A nyilvános hálózati hozzáférés letiltása megszakítja a számlázást. Ha a nyilvános hálózatok letiltása követelmény, konfigurálhatja a privát végpontokat támogató Azure-függvényekkel implementált egyéni webes API-képességet, és hozzáadhatja az Azure AI-szolgáltatások erőforrását ugyanahhoz a VNET-hez. Ily módon az Azure AI-szolgáltatások erőforrását közvetlenül az egyéni képességből hívhatja meg privát végpontok használatával.

Megjegyzés:

Egyes beépített készségek nem regionális Azure AI-szolgáltatásokon alapulnak (például a szövegfordítási képességen). A nem regionális szakértelem használata azt jelenti, hogy a kérés az Azure AI Search régiótól eltérő régióban is kiszolgálható. A nem regionális szolgáltatásokkal kapcsolatos további információkért tekintse meg az Azure AI-szolgáltatások termékét régiónkénti oldalon.

Fő követelmények – speciális esetek

Az egyéni entitáskeresést az Azure AI Search méri, nem az Azure AI-szolgáltatások, de egy többszolgáltatásos Azure AI-erőforráskulcsra van szükség a tranzakciók indexelőnkénti napi 20-on túli feloldásához. Csak ebben a képességben az erőforráskulcs feloldja a tranzakciók számát, de nem kapcsolódik a számlázáshoz.

Ingyenes gazdagítások

Az AI-bővítés kis mennyiségű ingyenes feldolgozást biztosít a számlázható dúsításokhoz, így rövid gyakorlatokat végezhet anélkül, hogy többszolgáltatásos Azure AI-erőforrást kellene csatolnia. Az ingyenes bővítés naponta 20 dokumentum, indexelőnként. Ha ismételni szeretne egy gyakorlatot, alaphelyzetbe állíthatja az indexelőt a számláló alaphelyzetbe állításához.

Egyes gazdagítások mindig ingyenesek:

• Az Azure AI-szolgáltatásokat (azaz feltételes, dokumentumkinyerési, alakzatkezelő, szövegegyesítési és szövegfelosztási képességeket) nem nevező segédprogramok nem számlázhatók.

• A PDF-dokumentumokból és más alkalmazásfájlokból való szövegkivétel nem engedélyezett. A dokumentum repedése során előforduló szövegkinyerés nem AI-bővítés, hanem az AI-bővítés során történik, ezért itt jegyezzük fel.

Számlázható gazdagodások

Az AI-bővítés során az Azure AI Search meghívja az Azure AI-szolgáltatások API-jait az Azure AI Vision, Translator és Azure AI Nyelvre épülő beépített készségekhez.

Az Azure AI-szolgáltatások háttérbeli hívásait végző számlázható beépített képességek közé tartozik az entitás-összekapcsolás, az entitásfelismerés, a képelemzés, a kulcskifejezések kinyerése, a nyelvészlelés, az OCR, a személyazonosítási adatok (PII) észlelése, a hangulat és a szövegfordítás.

A rendszerkép-kinyerés egy Azure AI Search-művelet, amely akkor fordul elő, ha a dokumentumok megrepednek a dúsítás előtt. A rendszerkép-kinyerés minden szinten számlázható, kivéve az ingyenes szinten 20 ingyenes napi extrakciót. A képkinyerési költségek a blobokon belüli képfájlokra, a más fájlokba beágyazott képekre (PDF- és egyéb alkalmazásfájlokra), valamint a Dokumentumkinyerés használatával kinyert képekre vonatkoznak. A rendszerkép-kinyerési díjszabásért tekintse meg az Azure AI Search díjszabási oldalát.

Tipp.

A képességkészletek feldolgozásának költségeinek csökkentése érdekében engedélyezze a növekményes bővítést (előzetes verzió) a képességkészlet módosításai által nem érintett gazdagodások gyorsítótárazásához és újrafelhasználásához. A gyorsítótárazáshoz Azure Storage szükséges (lásd a díjszabást , de a képességkészletek végrehajtásának összesített költsége alacsonyabb, ha a meglévő bővítéseket újra lehet használni, különösen a képkinyerést és -elemzést használó képességkészletek esetében.

Példa: Költségek becslése

Az Azure AI Search indexelésével kapcsolatos költségek becsléséhez kezdje azzal, hogy egy átlagos dokumentum hogyan néz ki, így futtathat néhány számot. Előfordulhat például, hogy hozzávetőlegesen:

• 1000 PDF.
• Egyenként hat oldal.
• Oldalanként egy kép (6000 kép).
• 3000 karakter oldalanként.

Tegyük fel, hogy egy folyamat, amely az egyes PDF-fájlok dokumentumrepedéséből, a képek és szövegek kinyeréséből, a képek optikai karakterfelismeréséből (OCR) és a szervezetek entitásfelismeréséből áll.

A cikkben szereplő árak hipotetikusak. A becslési folyamat szemléltetésére szolgálnak. A költségek alacsonyabbak lehetnek. A tranzakciók tényleges árával kapcsolatban lásd az Azure AI-szolgáltatások díjszabását.

1. A szöveg- és képtartalommal rendelkező dokumentumok feltörése esetén a szöveg kinyerése jelenleg ingyenes. 6000 kép esetén 1 usd-t kell feltételezni minden 1000 kinyert képhez. Ennek a lépésnek a költsége 6,00 usd.

2. 6000 képből álló OCR esetén az OCR kognitív képessége a legjobb algoritmust (DescribeText) használja. Feltételezve, hogy 1000 elemzendő kép 2,50 dollárba kerül, ezért a lépésért 15,00 dollárt kell fizetnie.

3. Az entitások kinyerése esetén oldalanként összesen három szöveges rekordot kell létrehoznia. Minden rekord 1000 karakter hosszúságú. Oldalanként három szöveges rekord szorozva 6000 oldallal, amely 18 000 szöveges rekordot eredményez. Feltételezve, hogy 1000 szöveges rekordonként 2,00 usd, ez a lépés 36,00 dollárba kerül.

Ha mindezt összeadja, körülbelül 57,00 dollárt kell fizetnie 1000 ilyen típusú PDF-dokumentum betöltéséért a leírt készségkészlettel.

További lépések

• Az Azure AI Search díjszabási oldala
• Készségkészlet definiálása
• Képességkészlet létrehozása (REST)
• Bővített mezők leképezése