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, kis számú dokumentumot ingyenesen bővíthet, indexenként naponta legfeljebb 20 tranzakcióval. 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 fiókok az egyes szolgáltatások helyett Azure AI-szolgáltatások gyűjteményét biztosítják. Az Azure AI Search-képességkészletben lévő fiók biztosítása lehetővé teszi a Microsoft számára, hogy díjat számítson fel az alábbi szolgáltatások használatáért:

• Az Azure AI Vision képelemzéshez, optikai karakterfelismeréshez (OCR) és multimodális szövegekhez és képek beágyazásához.
• 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

A készségkészletben meg kell adnia a kapcsolati adatokat az Azure AI több erőforráshoz. Az Azure AI Search nem használja a kapcsolatot a képességkészlet számítási feladataihoz, de a kapcsolatot használja az erőforrás számlázási mérőszámainak eléréséhez. Így az Azure AI-szolgáltatások fiókját a számlázáshoz, nem pedig a készségek feldolgozásához használják. Az Azure AI Search külön dedikált erőforrásokat használ a készségek feldolgozásához.

Használhat egy kulcsot a kapcsolaton, vagy implementálhat egy kulcs nélküli megközelítést, amely jelenleg előzetes verzióban érhető el.

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.

Előfeltételek

• Kapcsolat nyilvános végponton keresztül, kivéve, ha a keresési szolgáltatás megfelel a többszolgáltatásos Azure AI-fiókhoz való privát kapcsolatok létrehozási dátumára, rétegére és régiójára vonatkozó követelményeknek.

Feljegyzés

Ha az Azure AI-erőforrás privát végpont használatára van konfigurálva, az Azure AI Search megosztott privát hivatkozással tud csatlakozni, ha a keresési szolgáltatás 2024. április 3. után jött létre, és olyan régióban található, amely nagyobb számítási kapacitást biztosít, és támogatott szinten van. További információkért tekintse meg a megosztott privát hivatkozások használatára vonatkozó követelményeket.

Számlázás kulcs nélküli kapcsolaton keresztül

Feljegyzés

Ez a funkció jelenleg nyilvános előzetes verzióban érhető el. Ez az előzetes verzió szolgáltatásszintű szerződés nélkül érhető el, és éles számítási feladatokhoz nem ajánlott. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

Az Azure Portal vagy újabb előzetes VERZIÓJÚ REST API-k és béta SDK-csomagok használatával felügyelt identitással és engedélyekkel csatolhat többszolgáltatásos Azure AI-erőforrást. Ennek a megközelítésnek az az előnye, hogy a számlázás kulcs nélküli, és nincs függősége a régióktól.

1. Az Azure AI Search konfigurálása felügyelt identitás használatára.

2. Az Azure AI többszolgáltatásos erőforrásán rendelje hozzá az identitást a Cognitive Services felhasználói szerepköréhez.

3. Az Azure Portal vagy a Skillset 2024-11-01-preview REST API vagy a szintaxist biztosító Azure SDK bétacsomag használatával konfiguráljon egy képességkészletet identitás használatára:

   • A kapcsolaton használt felügyelt identitás a keresési szolgáltatáshoz tartozik.
   • Az identitás lehet rendszer által felügyelt vagy felhasználó által hozzárendelt.
   • Az identitásnak Cognitive Services-felhasználói engedélyekkel kell rendelkeznie az Azure AI-erőforráshoz.
   • @odata.type mindig #Microsoft.Azure.Search.AIServicesByIdentity.
   • subdomainUrl az Azure AI többszolgáltatásos erőforrásának végpontja. Bármely régióban lehet, amelyet az Azure AI Search és az Azure AI-szolgáltatások közösen támogatnak .

A kulcsokhoz hasonlóan az Azure AI Services-erőforrással kapcsolatos adatok számlázásra, nem kapcsolatokra szolgálnak. Az Azure AI Search által az Azure AI-szolgáltatásokra irányuló, beépített készségek feldolgozására irányuló API-kérések továbbra is belsőek és a Microsoft által felügyeltek.

Példa: rendszer által hozzárendelt felügyelt identitás

Az identitás értéke null.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
} 

Példa: felhasználó által hozzárendelt felügyelt identitás

Az identitás a felhasználó által hozzárendelt felügyelt identitás erőforrás-azonosítójára van állítva. A felhasználó által hozzárendelt felügyelt identitások megkereséséhez lásd : Felhasználó által hozzárendelt felügyelt identitások kezelése.

Felhasználó által hozzárendelt felügyelt identitás esetén állítsa be a tulajdonságokat és a @odata.type userAssignedIdentity tulajdonságokat.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": {   
            "@odata.type":  "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": ""/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"" 
        }
    } 
}

Számlázás erőforráskulcson keresztül

Az Azure AI Search az Azure AI többszolgáltatásos erőforráskulcsával is díjat számíthat fel a tranzakciókért. Ez az alapértelmezett megközelítés, és általánosan elérhető. Az Azure Portal, a REST API vagy az Azure SDK használatával hozzáadhatja a kulcsot egy készségkészlethez.

Csak a kulcsot kell hozzáadnia, nem az altartományt vagy a végpontot. Ha nem adja meg a cognitiveServices 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 Portalra

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. Kérje le az erőforráskulcsot az Erőforráskulcsok>és a végpont lapról.

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

   • Ha adatimportálási varázslót használ, hozza létre vagy válassza ki az Azure AI-fiókot. A varázsló hozzáadja az erőforráskulcsot a készségkészlet definíciójához.

   • Új vagy meglévő készségkészlet esetén adja meg a kulcsokat a készségkészlet definíciójában.

REST

1. Használja a Skillset létrehozása vagy frissítése API-t, és cognitiveServices adja meg a kérés törzsének szakaszát:

PUT https://[servicename].search.windows.net/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>"
    }
}

.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öbbszolgáltatásos 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 Portalra

1. Jelentkezzen be az Azure Portalra.

2. A Keresési felügyeleti > képességek csoportban válasszon ki egy készségkészletet a listából.

   

3. Görgessen a fájlt tartalmazó szakaszhoz "cognitiveServices".

4. Törölje a kulcsértéket 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=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": ""
       }
   }
   

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

   "cognitiveServices": null,
   

A kulcs használata

A számlázás akkor lép érvénybe, ha az Azure AI-szolgáltatások erőforrásaihoz irányuló API-hívások száma indexelőnként meghaladja a napi 20 API-hívást. Az indexelő alaphelyzetbe állításával visszaállíthatja az API-k számát.

A kulcs nélküli és kulcsalapú kapcsolatok a számlázáshoz használatosak, 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".

Az indexelők úgy konfigurálhatók, hogy privát végrehajtási környezetben fussanak dedikált feldolgozásra a saját keresési szolgáltatás keresési csomópontjaival. Még ha privát végrehajtási környezetet is használ, az Azure AI Search továbbra is a belsőleg kiépített Többszolgáltatásos Azure AI-erőforrást használja az összes képességnövelés végrehajtásához.

Feljegyzé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.

Nyilvános kapcsolatra vonatkozó követelmények

Attól függően, hogy mikor jött létre a keresési szolgáltatás, valamint annak szintje és régiója, a beépített képességek számlázása nyilvános kapcsolatot igényelhet az Azure AI Search és az Azure AI multi-service között. A nyilvános hálózati hozzáférés letiltása bizonyos esetekben megszakítja a számlázást. Tekintse át a megosztott privát hivatkozáson keresztüli kapcsolatokra vonatkozó követelményeket annak megállapításához, hogy a keresési szolgáltatás nyilvános kapcsolatot igényel-e.

Ha nem tudja használni a nyilvános hálózatot, 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 virtuális hálózathoz. 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.

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 a gyorsítótárazáshoz és az olyan gazdagodások újbóli felhasználásához, amelyek nem érintik a készségkészlet módosításait. 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.

Következő 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