Cognitive Services-erőforrás csatolása egy készségkészlet a Azure SearchAttach a Cognitive Services resource with a skillset in Azure Search

Az AI-algoritmusok a dokumentumok dúsításához használt kognitív indexelési folyamatokat hajtják Azure Search.AI algorithms drive the cognitive indexing pipelines used for document enrichment in Azure Search. Ezek az algoritmusok az Azure Cognitive Services-erőforrásokon alapulnak, Computer Vision többek között a képelemzéshez és az optikai karakterfelismeréshez (OCR) és text Analytics az entitások felismeréséhez, a fő kifejezés kinyeréséhez és egyéb dúsításokhoz. .These algorithms are based on Azure Cognitive Services resources, including Computer Vision for image analysis and optical character recognition (OCR) and Text Analytics for entity recognition, key phrase extraction, and other enrichments. A dokumentum-dúsítási célokra Azure Search által használt algoritmusokat a rendszer egy készségkészlethelyeziel, és egy indexelő az indexelés során hivatkozik rá.As used by Azure Search for document enrichment purposes, the algorithms are wrapped inside a skill, placed in a skillset, and referenced by an indexer during indexing.

A korlátozott számú dokumentumot ingyenesen bővítheti.You can enrich a limited number of documents for free. Az is előfordulhat, hogy számlázható Cognitive Services erőforrást is csatolhat egy készségkészlet nagyobb és gyakoribb számítási feladatokhoz.Or, you can attach a billable Cognitive Services resource to a skillset for larger and more frequent workloads. Ebből a cikkből megtudhatja, hogyan csatolhat számlázható Cognitive Services-erőforrásokat a dokumentumok gazdagítása érdekében Azure Search indexeléssorán.In this article, you'll learn how to attach a billable Cognitive Services resource to enrich documents during Azure Search indexing.

Megjegyzés

A számlázható események közé tartoznak a Cognitive Services API-k és a képek kinyerésének meghívása a dokumentum repedési szakaszának részeként Azure Search.Billable events include calls to Cognitive Services APIs and image extraction as part of the document-cracking stage in Azure Search. Nem számítunk fel díjat a dokumentumokból kinyert szövegből vagy a Cognitive Servicest nem meghívó ismeretekből.There is no charge for text extraction from documents or for skills that do not call Cognitive Services.

A számlázható képességek végrehajtása az Cognitive Services utólagos elszámolású áronérhető el.Execution of billable skills is at the Cognitive Services pay-as-you go price. A képek kinyerésének díjszabását a Azure Search díjszabását ismertető oldalontekintheti meg.For image extraction pricing, see the Azure Search pricing page.

Azonos régióra vonatkozó követelménySame-region requirement

A Azure Search és az Azure Cognitive Services ugyanazon a régión belül kell lennie.We require that Azure Search and Azure Cognitive Services exist within the same region. Ellenkező esetben az üzenet futtatása a következő időpontban történik:"Provided key is not a valid CognitiveServices type key for the region of your search service."Otherwise, you will get this message at run time: "Provided key is not a valid CognitiveServices type key for the region of your search service."

Egy szolgáltatás nem helyezhető át a régiók között.There is no way to move a service across regions. Ha ezt a hibaüzenetet kapja, hozzon létre egy új Cognitive Services-erőforrást ugyanabban a régióban, mint Azure Search.If you get this error, you should create a new Cognitive Services resource in the same region as Azure Search.

Megjegyzés

Néhány beépített képesség nem regionális Cognitive Services alapul (például a szöveges fordítási képességre).Some built-in skills are based on non-regional Cognitive Services (for example, the Text Translation Skill). Vegye figyelembe, hogy ha ezen ismeretek bármelyikét hozzáadjuk a készségkészlet, hogy az adatai nem garantáltak maradnak ugyanabban a régióban, mint a Azure Search vagy Cognitive Services erőforrás.Be aware that if you add any of these skills to your skillset that your data is not guaranteed to stay in the same region as your Azure Search or Cognitive Services resource. További részletekért tekintse meg a szolgáltatás állapota lapot .See the service status page for more details.

Ingyenes erőforrások használataUse Free resources

A kognitív keresési oktatóanyag és a gyors üzembe helyezési feladatok elvégzéséhez korlátozott, ingyenes feldolgozási lehetőség használható.You can use a limited, free processing option to complete the cognitive search tutorial and quickstart exercises.

Az ingyenes (korlátozott dúsítású) erőforrások napi 20 dokumentumra korlátozódnak.Free (Limited enrichments) resources are restricted to 20 documents per day, per subscription.

  1. Nyissa meg az adatimportálás varázslót:Open the Import data wizard:

    Az adatimportálás varázsló megnyitásaOpen the Import data wizard

  2. Válasszon ki egy adatforrást, és folytassa a kognitív keresés hozzáadásával (opcionális) .Choose a data source and continue to Add cognitive search (Optional). A varázsló lépésenkénti útmutatója: Importálás, indexelés és lekérdezés a portál Tools használatával.For a step-by-step walkthrough of this wizard, see Import, index, and query by using portal tools.

  3. Bontsa ki a csatolás Cognitive Services elemet, majd válassza az ingyenes (korlátozott dúsítások) lehetőséget:Expand Attach Cognitive Services and then select Free (Limited enrichments):

    Kibontott csatolás Cognitive Services szakaszExpanded Attach Cognitive Services section

  4. Folytassa a következő lépéssel, bővítsea bővítéseket.Continue to the next step, Add Enrichments. A portálon elérhető képességek leírását lásd : 2. lépés: Kognitív ismeretek hozzáadása a kognitív keresési útmutatóban.For a description of skills available in the portal, see Step 2: Add cognitive skills in the cognitive search quickstart.

Számlázható erőforrások használataUse billable resources

A napi 20-nál több frissítést létrehozó munkaterhelések esetében ügyeljen arra, hogy számlázható Cognitive Services erőforrást csatoljon.For workloads that create more than 20 enrichments per day, make sure to attach a billable Cognitive Services resource. Azt javasoljuk, hogy mindig csatoljon számlázható Cognitive Services-erőforrást, még akkor is, ha soha nem kívánja hívni a Cognitive Services API-k.We recommend that you always attach a billable Cognitive Services resource, even if you never intend to call Cognitive Services APIs. Egy erőforrás csatolása felülbírálja a napi korlátot.Attaching a resource overrides the daily limit.

Csak olyan készségekért kell fizetnie, amelyek meghívja a Cognitive Services API-k.You're charged only for skills that call the Cognitive Services APIs. Nem számítunk fel díjat az Egyéni készségekért, vagy olyan készségekért, mint a szöveges egyesítés, a szöveges osztóés a formáló, amelyek nem API-alapúak.You're not billed for custom skills, or skills like text merger, text splitter, and shaper, which aren't API-based.

  1. Nyissa meg az adatimportálás varázslót, válasszon ki egy adatforrást, és folytassa a kognitív keresés hozzáadásával (opcionális) .Open the Import data wizard, choose a data source, and continue to Add cognitive search (Optional).

  2. Bontsa ki a csatolás Cognitive Services elemet, majd válassza az új Cognitive Services erőforrás létrehozásalehetőséget.Expand Attach Cognitive Services and then select Create new Cognitive Services resource. Megnyílik egy új lap, ahol létrehozhatja az erőforrást:A new tab opens so that you can create the resource:

    Cognitive Services erőforrás létrehozásaCreate a Cognitive Services resource

  3. A hely listában válassza ki azt a régiót, ahol a Azure Search szolgáltatás található.In the Location list, select the region where your Azure Search service is located. Ügyeljen arra, hogy ezt a régiót használja a teljesítmény szempontjából.Make sure to use this region for performance reasons. Ezen régió használata esetén a kimenő sávszélességgel kapcsolatos díjak is megadhatók a régiók között.Using this region also voids outbound bandwidth charges across regions.

  4. A díjszabási réteg listában válassza a S0 lehetőséget a Cognitive Services-funkciók teljes gyűjteményének beszerzéséhez, beleértve a jövőképet és a nyelvi funkciókat is, amelyek a Azure Search által használt előre meghatározott ismereteket használják.In the Pricing tier list, select S0 to get the all-in-one collection of Cognitive Services features, including the Vision and Language features that back the predefined skills used by Azure Search.

    A S0 szinten a Cognitive Services díjszabási oldalántalálhat meghatározott számítási feladatokra vonatkozó díjszabást.For the S0 tier, you can find rates for specific workloads on the Cognitive Services pricing page.

    • Győződjön meg arról, hogy az ajánlat kiválasztása listán a Cognitive Services van kiválasztva.In the Select Offer list, make sure Cognitive Services is selected.
    • A nyelvi szolgáltatások területen az text Analytics standard díjszabása az AI-indexelésre vonatkozik.Under Language features, the rates for Text Analytics Standard apply to AI indexing.
    • A látási funkciók területen Computer Vision S1 díjszabása érvényes.Under Vision features, the rates for Computer Vision S1 apply.
  5. Válassza a Létrehozás lehetőséget az új Cognitive Services erőforrás kiépítéséhez.Select Create to provision the new Cognitive Services resource.

  6. Térjen vissza az előző lapra, amely tartalmazza az adatimportálás varázslót.Return to the previous tab, which contains the Import data wizard. Válassza a frissítés lehetőséget a Cognitive Services erőforrás megjelenítéséhez, majd válassza ki az erőforrást:Select Refresh to show the Cognitive Services resource, and then select the resource:

    Cognitive Services erőforrás kiválasztásaSelect the Cognitive Services resource

  7. Bontsa ki a dúsítások hozzáadása szakaszt az adatain futtatni kívánt kognitív képességek kiválasztásához.Expand the Add Enrichments section to select the specific cognitive skills that you want to run on your data. Fejezze be a varázsló hátralévő részét.Complete the rest of the wizard. A portálon elérhető képességek leírását lásd : 2. lépés: Kognitív ismeretek hozzáadása a kognitív keresési útmutatóban.For a description of skills available in the portal, see Step 2: Add cognitive skills in the cognitive search quickstart.

Meglévő készségkészlet csatolása Cognitive Services erőforráshozAttach an existing skillset to a Cognitive Services resource

Ha rendelkezik meglévő készségkészlet, csatolhatja azt egy új vagy egy másik Cognitive Services erőforráshoz.If you have an existing skillset, you can attach it to a new or different Cognitive Services resource.

  1. A szolgáltatás áttekintése lapon válassza a szakértelmével:On the Service overview page, select Skillsets:

    Szakértelmével lapSkillsets tab

  2. Válassza ki a készségkészlet nevét, majd válasszon ki egy meglévő erőforrást, vagy hozzon létre újat.Select the name of the skillset, and then select an existing resource or create a new one. A módosítások jóváhagyásához kattintson az OK gombra .Select OK to confirm your changes.

    Készségkészlet-erőforrások listájaSkillset resource list

    Ne feledje, hogy az ingyenes (korlátozott dúsítású) beállítás naponta 20 dokumentumra korlátozza a dokumentumokat, és az új Cognitive Services erőforrás létrehozása lehetőséggel új számlázható erőforrást építhet ki.Remember that the Free (Limited enrichments) option limits you to 20 documents daily, and that you can use Create new Cognitive Services resource to provision a new billable resource. Ha új erőforrást hoz létre, válassza a frissítés lehetőséget a Cognitive Services erőforrások listájának frissítéséhez, majd válassza ki az erőforrást.If you create a new resource, select Refresh to refresh the list of Cognitive Services resources, and then select the resource.

Cognitive Services programozott csatolásaAttach Cognitive Services programmatically

Ha programozott módon definiálja a készségkészlet, vegyen fel egy cognitiveServices szakaszt a készségkészlet.When you're defining the skillset programmatically, add a cognitiveServices section to the skillset. Ebben a szakaszban adja meg a készségkészlet társítandó Cognitive Services erőforrás kulcsát.In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. Ne feledje, hogy az erőforrásnak ugyanabban a régióban kell lennie, mint a Azure Search erőforrásnak.Remember that the resource must be in the same region as your Azure Search resource. Adja meg a és a #Microsoft.Azure.Search.CognitiveServicesByKeyértékeit is. @odata.typeAlso include @odata.type, and set it to #Microsoft.Azure.Search.CognitiveServicesByKey.

A következő példa ezt a mintát mutatja be.The following example shows this pattern. Figyelje meg a definíció végén található szakaszt.cognitiveServicesNotice the cognitiveServices section at the end of the definition.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2019-05-06
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.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>"
    }
}

Példa: Költségek megbecsléseExample: Estimate costs

A kognitív keresési indexeléshez kapcsolódó költségek kiszámításához Kezdje azzal, hogy egy átlagos dokumentum hogyan néz ki, így néhány számot futtathat.To estimate the costs associated with cognitive search indexing, start with an idea of what an average document looks like so you can run some numbers. Például megközelítheti a következőket:For example, you might approximate:

  • 1 000 PDF-fájlok.1,000 PDFs.
  • Hat oldal.Six pages each.
  • Oldalanként egy kép (6 000 lemezkép).One image per page (6,000 images).
  • 3 000 karakter/oldal.3,000 characters per page.

Tegyük fel, hogy egy olyan folyamat, amely az egyes PDF-fájlokból, képekből és szöveg-kivonásokból, optikai karakterfelismerésből (OCR) és a szervezetek entitás-felismerésével kapcsolatos dokumentumok repedését tartalmazza.Assume a pipeline that consists of document cracking of each PDF, image and text extraction, optical character recognition (OCR) of images, and entity recognition of organizations.

A cikkben szereplő díjak feltételezettek.The prices shown in this article are hypothetical. A becslési folyamat szemléltetésére szolgálnak.They're used to illustrate the estimation process. A költségek alacsonyabbak lehetnek.Your costs could be lower. A tranzakciók tényleges áraival kapcsolatban lásd: Cognitive Services díjszabása.For the actual prices of transactions, see See Cognitive Services pricing.

  1. Szöveg-és képtartalommal való repedés esetén a szöveg kibontása jelenleg ingyenes.For document cracking with text and image content, text extraction is currently free. 6 000-lemezkép esetén tegyük fel, hogy $1 minden kinyert 1 000-lemezképhez.For 6,000 images, assume $1 for every 1,000 images extracted. Ez a lépés a $6,00-as díj.That's a cost of $6.00 for this step.

  2. Az 6 000-es rendszerképek optikai KARAKTERFELISMERÉSi képességei a legjobb algoritmust használják (DescribeText).For OCR of 6,000 images in English, the OCR cognitive skill uses the best algorithm (DescribeText). Ennek a lépésnek a $2,50/1 000 rendszerképekkel való elemzését feltételezve kell $15,00 fizetnie.Assuming a cost of $2.50 per 1,000 images to be analyzed, you would pay $15.00 for this step.

  3. Az entitások kinyeréséhez oldalanként összesen három szöveges rekord van.For entity extraction, you'd have a total of three text records per page. Minden rekord 1 000 karakterből áll.Each record is 1,000 characters. Oldalanként három szöveges rekord, szorozva az 6 000-lapokkal, 18 000 szöveges rekordokkal.Three text records per page multiplied by 6,000 pages equals 18,000 text records. Az $2,00-as 1 000-es szöveges rekordok esetében ennek a lépésnek a díja $36,00.Assuming $2.00 per 1,000 text records, this step would cost $36.00.

Mindezt együttesen a $57,00-es számú 1 000-es PDF-dokumentumot kell fizetnie a leírt készségkészlet.Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of this type with the described skillset.

További lépésekNext steps