Számlázható erőforrás csatolása egy készségkészlethez az Azure AI Keresés-ben

Ha beépített készségeket használ a AI-bővítéshez Azure AI Keresés, kis számú dokumentumot ingyenesen bővíthet, indexenként akár napi 20 tranzakciót is. Nagyobb vagy gyakoribb számítási feladatok esetén egy számlázható Microsoft Foundry-erőforrást kell csatolnia a készséghalmazához.

Azure AI Keresés dedikált, belsőleg üzemeltetett erőforrásokat használ az Foundry Tools által támogatott beépített képességek végrehajtásához, és kizárólag számlázási célokra igényel egy Foundry-erőforrást. Kivételt képez a Azure Tartalomértés képesség, amely az erőforrást a számlázáshoz és a feldolgozáshoz is használja.

Az Foundry eszköztár erőforrása hozzáférést biztosít több szolgáltatáshoz a Foundry Toolsban. Amikor azt egy készségkészletben adja meg, a Microsoft a következő szolgáltatások használatáért számolhat fel díjat:

• Azure Vision in Foundry Tools képelemzéshez, optikai karakterfelismeréshez (OCR) és multimodális beágyazásokhoz.
• Azure Nyelv az Öntödei eszközökben nyelvfelismeréshez, entitásfelismeréshez, hangulatelemzéshez és kulcskifejezések kinyeréséhez.
• Azure Translator az Foundry Tools-ban gépi szövegfordításhoz.

A készségkészletek feldolgozását az egyes képességek alapjául szolgáló szolgáltatásnak kell kiszámláznia. Azure AI Keresés a Foundry Tools díjait egyetlen Foundry erőforrásba összesíti. Ha például a Image Analysis és Language Detection készségeket használja, a Azure Vision és Azure Nyelv díja ugyanazon a számlán jelenik meg az Foundry-erőforráshoz. Minden más erőforrást külön számlázunk.

A Foundry-erőforrás csatolásához adja meg a kapcsolati információkat a modulkészletben. Kulcsalapú vagy kulcs nélküli megközelítést is használhat.

Előfeltételek

• Nyilvános végponton keresztüli kapcsolat, kivéve, ha a keresési szolgáltatás megfelel a Foundry-erőforráshoz való privát kapcsolatok létrehozási dátumára, rétegére és régiójára vonatkozó követelményeknek.

• Egy API-típussal rendelkező AIServices. Az API-típust az erőforrás Overview lapján ellenőrizheti a Azure portálon:

  Képernyőkép az Azure portálon található API típusú tulajdonságról.

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

Felügyelt identitással és engedélyekkel csatolhat egy Foundry-erőforrást. Ennek a megközelítésnek az az előnye, hogy a számlázás kulcs nélküli, és nincsenek régiókövetelményei.

A kulcsokhoz hasonlóan az erőforrásról megadott adatok számlázásra, nem kapcsolatokra szolgálnak. Az Azure AI Keresés által az Foundry Toolshoz a beépített készségek feldolgozásához küldött összes API-kérés belső marad, és az Microsoft kezeli.

Kulcs nélküli kapcsolaton keresztüli számlázás:

1. A Azure AI Keresés szolgáltatásban konfiguráljon egy felügyelt identitást. A rendszer által hozzárendelt és a felhasználó által hozzárendelt identitások egyaránt támogatottak.

2. A Foundry-erőforráson rendelje hozzá a Cognitive Services felhasználói szerepkört a keresési szolgáltatás felügyelt identitásához.

3. Konfiguráljon egy készségkészletet a felügyelt identitás használatára. Használhatja a Azure portált, a Skillsets – Létrehozás vagy frissítés (REST API) legújabb stabil verzióját, vagy a szintaxist biztosító Azure SDK csomagot.

   • @odata.type mindig #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl Az Foundry-erőforrás végpontja. A https://<resource-name>.services.ai.azure.com vagy https://<resource-name>.cognitiveservices.azure.com formátumot is használhatja, mindkettő a Kulcsok és végpont lapon érhető el a Azure portálon.

   • Más tulajdonságok a felügyelt identitás típusára vonatkoznak, ahogyan az alábbi REST API-példákban is látható.

   • Rendszer által hozzárendelt felügyelt identitás
   • Felhasználó által hozzárendelt felügyelt identitás

   Íme egy minta készségkészlet-konfiguráció a rendszer által hozzárendelt felügyelt identitáshoz. Ebben a forgatókönyvben a identity-t a null-re kell állítania.

   POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
   api-key: [admin-key]
   Content-Type: application/json
   
   {
     "name": "my-skillset",
     "skills": [
       // Skills definition goes here
     ],
     "cognitiveServices": {
       "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
       "description": "A sample configuration for a system-assigned managed identity.",
       "subdomainUrl": "https://[resource-name].services.ai.azure.com",
       "identity": null
     }
   }
   

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

Alapértelmezés szerint az Azure AI Keresés a tranzakciókat egy Foundry-erőforrás kulcsával számlázza. Ez a megközelítés általánosan elérhető. Használhatja a Azure portált, egy stabil REST API-verziót vagy egy azzal egyenértékű Azure SDK, hogy hozzáadja a kulcsot egy készségkészlethez.

Két támogatott kulcstípus létezik:

• #Microsoft.Azure.Search.CognitiveServicesByKey meghívja a regionális végpontot.
• #Microsoft.Azure.Search.AIServicesByKey meghívja az altartományt. Ezt a típust azért javasoljuk, mert támogatja a megosztott privát hivatkozásokat, és a keresési szolgáltatáshoz képest nem rendelkezik regionális követelményekkel.

Az Foundry-erőforrásnak ugyanabban a régióban kell lennie, mint a keresési szolgáltatásnak. Válasszon egy Azure AI Keresés régiót, amely a Foundry Tools integrációját biztosítja, amelyet a AI-bővítés oszlop jelez. Az azonos régióra vonatkozó követelményről további információt a kulcs használata című témakörben talál.

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

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json
{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "A sample configuration for key-based billing.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "key": "{your-billable-resource-key}"
    }
}

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 Foundry Toolst, kövesse ezeket az utasításokat a kulcs eltávolításához és az Foundry-erőforrás használatának megakadályozásához.

Kulcs nélkül a készségkészlet visszaáll az indexelőknek napi 20 ingyenes tranzakció alapértelmezett kiosztására. A számlázható készségek végrehajtása 20 tranzakciónál leáll, és megjelenik egy "Időtúllépés" üzenet az indexelő végrehajtási előzményei között, amikor az erőforrás felhasználásra kerül.

A kulcs használata

A számlázás akkor lép érvénybe, ha egy Foundry-erőforráshoz érkező 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űveletekhez kapcsolódó kapcsolatokhoz nem.

Kulcsalapú kapcsolatok esetén a keresési szolgáltatás a belső hálózaton keresztül csatlakozik egy azonos fizikai régióban található Foundry-erőforráshoz. A Azure AI Keresés kínáló régiók többsége más Azure szolgáltatásokat is kínál. 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."

Kulcs nélküli kapcsolatok esetén a keresési szolgáltatás identitás- és szerepkör-hozzárendeléssel hitelesít, és egy Foundry-erőforrást céloz meg. Az erőforrás teljes körű URI-ként van megadva, az URI pedig egy egyedi altartományt tartalmaz.

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 akkor is, ha magánvégrehajtási környezetet használ, Azure AI Keresés továbbra is a belsőleg kiépített erőforrásait használja az összes képességnövelés végrehajtásához.

Nyilvános kapcsolatra vonatkozó követelmények

A keresési szolgáltatás létrehozásának időpontjától, a tarifacsomagtól és a régiótól függően a beépített készségek számlázása nyilvános kapcsolatot igényelhet az Azure AI Keresés részéről a Foundry-erőforráshoz. 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álhat egy Custom Web API-t egy Azure függvénnyel, amely támogatja a privát végpontokat. Adja hozzá a Foundry erőforrást ugyanahhoz a VNET-hez. Ebben a forgatókönyvben az Foundry-erőforrást 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

Custom Entity Lookup a Azure AI Keresés méri, de egy Foundry-erőforráskulcsra van szükség a napi 20-t meghaladó tranzakciók indexelőnkénti feloldásához. Ennél a funkciónál a tranzakciók számát felszabadítja az erőforráskulcs, de nem kapcsolódik a számlázáshoz.

Ingyenes gazdagítások

Az AI-alapú dúsítás lehetőséget ad arra, hogy kisebb mennyiségű ingyenes feldolgozást végezzünk a jellemzően számlázott dúsítások során, így rövid feladatokat elvégezhetünk anélkül, hogy külső erőforrásokat kellene csatolnunk. Indexerenként naponta 20 dokumentum az ingyenes bővítmények. Ha ismételni szeretne egy gyakorlatot, visszaállíthatja az indexelőt, hogy alaphelyzetbe hozza a számlálót.

Egyes gazdagítások mindig ingyenesek:

• Az utilitások képességei, amelyek nem hívják az Öntödei eszközöket (nevezetesen a Conditional, Document Extraction, Shaper, Text Merge és Text Split képességek), nem számlázhatók.

• A PDF-dokumentumokból és más alkalmazásfájlokból való szövegkivétel díjmentes. A dokumentumfelbontás során történő szövegkinyerés nem AI-bővítés, hanem az AI-bővítés során történik, ezért itt kerül megemlítésre.

Számlázható gazdagodások

Az AI-bővítés során az Azure AI Keresés API-ket hív meg beépített készségekre, amelyek az Azure Visionre, az Azure Language-re és az Azure Translatorra alapoznak.

A külső szolgáltatásokra irányuló háttérhívásokat kezdeményező számlázható beépített képességek a következők:

• Entitás csatolása
• Entitásfelismerés
• Képelemzés
• Kulcskifejezések kinyerése
• Nyelvfelismerés
• OCR
• Személyazonosításra alkalmas adatok (PII) észlelése
• Hangulat
• Szövegfordítás
• Azure Vision multimodális beágyazások (előzetes verzió)

A Azure Vision multimodális beágyazási modell által támogatott query-time vectorizer szintén számlázható bővítés.

A kép kinyerése egy Azure AI Keresés művelet, amely akkor fordul elő, ha a dokumentumok megrepednek a dúsítás előtt. A képkinyerés minden tarifacsomagon díjköteles, kivéve az ingyenes csomagon, ahol 20 ingyenes napi extrakció érhető el. A képkinyerési költségek a blobokon belüli képfájlokra, más fájlokba beágyazott képekre (PDF- és egyéb alkalmazásfájlokra) és a Dokumentumkinyerés használatával kinyert képekre vonatkoznak. A kép kinyerési díjszabását a Azure AI Keresés díjszabási oldalán talál.

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

Az ebben a szakaszban szereplő árak hipotetikusak, és a becslési folyamat szemléltetésére szolgálnak. A költségek alacsonyabbak lehetnek. A tranzakciók tényleges árát az Foundry Tools díjszabásában találja.

Az Azure AI Keresés indexeléshez kapcsolódó költségek becsléséhez kezdje azzal, hogy elképzeli, hogyan néz ki egy átlagos dokumentum, így számításokat végezhet. Előfordulhat például, hogy hozzávetőlegesen:

• 1 000 PDF-ek
• Hat oldal egyenként
• Oldalanként egy kép (6000 kép)
• 3000 karakter oldalanként

Feltételezzük, hogy van egy folyamat, amely az egyes PDF-fájlok dokumentum feldolgozásából, a képek és szövegek kinyeréséből, a képek OCR-éből és a szervezetek entitásfelismeréséből áll.

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.

Kapcsolódó tartalom

• Azure AI Keresés díjszabási oldal
• Hogyan definiáljuk a készségkészletet
• Képességkészlet létrehozása (REST)
• Bővített mezők leképezése