Připojení prostředku Azure AI s více službami k sadě dovedností ve službě Azure AI Search

Při konfiguraci volitelného kanálu rozšiřování AI ve službě Azure AI Search můžete zdarma rozšířit malý počet dokumentů omezených na 20 transakcí na index. U větších a častějších úloh byste měli připojit fakturovatelný prostředek Azure AI s více službami.

Účet s více službami poskytuje místo jednotlivých služeb kolekci služeb Azure AI. Účet má přidružený klíč prostředku. Tento klíč je zadaný v sadě dovedností Azure AI Search a umožňuje Microsoftu účtovat poplatky za používání těchto služeb:

• Azure AI Vision pro analýzu obrázků, optické rozpoznávání znaků (OCR) a multimodální vkládání textu a obrázků
• Jazyk Azure AI pro rozpoznávání jazyka, rozpoznávání entit, analýzu mínění a extrakci klíčových frází
• Azure AI Speech pro převod řeči na text a text na řeč
• Azure AI Translator pro strojový překlad textu

Klíč se používá pro fakturaci, ne pro připojení. Klíč v sadě dovedností musíte poskytnout i v případě, že v připojení používáte jiné mechanismy, jako jsou přiřazení rolí a spravované identity.

Tip

Azure poskytuje infrastrukturu pro monitorování fakturace a rozpočtů. Další informace o monitorování služeb Azure AI najdete v tématu Plánování a správa nákladů na služby Azure AI.

Získání klíče prostředku pro účet Azure AI s více službami

1. Přihlaste se k portálu Azure.

2. Ve stejné oblasti jako vyhledávací služba vytvořte prostředek Azure AI s více službami.

3. Získejte klíč prostředku ze stránky Klíče prostředků>a koncového bodu.

Přidání klíče prostředku do sady dovedností

Klíč ke sadě dovedností můžete přidat pomocí webu Azure Portal, rozhraní REST API nebo sady Azure SDK.

Pokud necháte vlastnost nezadanou, vaše vyhledávací služba se pokusí používat bezplatné rozšiřování, které jsou pro indexer k dispozici každý den. Provádění fakturovatelných dovedností se zastaví při 20 transakcích za volání indexeru a v historii provádění indexeru se zobrazí zpráva Vypršení časového limitu.

Azure Portal

Přidejte klíč k definici sady dovedností:

• Pokud používáte Průvodce importem dat, vytvořte nebo vyberte účet Azure AI. Průvodce přidá klíč prostředku k definici sady dovedností.

• Pro novou nebo existující sadu dovedností zadejte klíč v definici sady dovedností.

  

REST

1. Použijte rozhraní API pro vytvoření nebo aktualizaci sady dovedností a v textu požadavku zadejte cognitiveServices čá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": "<your key goes here>"
    }
}

.NET SDK

Následující fragment kódu pochází z azure-search-dotnet-samples a oříznou se kvůli stručnosti.

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

Odebrání klíče

Rozšiřování jsou fakturovatelné operace. Pokud už nepotřebujete volat služby Azure AI, podle těchto pokynů odeberte klíč služby s více službami a zabraňte použití externího prostředku. Bez klíče se sada dovedností vrátí k výchozímu přidělení 20 bezplatných transakcí na indexer za den. Provádění fakturovatelných dovedností se zastaví při 20 transakcích a při použití přidělení se v historii provádění indexeru zobrazí zpráva Vypršení časového limitu.

Azure Portal

1. Přihlaste se k portálu Azure.

2. V části Sady dovedností správy > vyhledávání vyberte ze seznamu sadu dovedností.

   

3. Posuňte se k oddílu v souboru obsahujícím "cognitiveServices".

4. Odstraňte hodnotu klíče z JSON a uložte sadu dovedností.

   

REST

1. Získejte sadu dovedností, abyste měli úplnou definici.

2. Formulujte žádost o aktualizaci sady dovedností a zadejte definici JSON sady dovedností.

3. Odeberte klíč v textu definice a pak odešlete požadavek:

   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": ""
       }
   }
   

   Alternativně můžete nastavit cognitiveServices na hodnotu null:

   "cognitiveServices": null,
   

Jak se klíč používá

Fakturace založená na klíčích platí, když volání rozhraní API do prostředků služeb Azure AI překročí 20 volání rozhraní API na indexer za den. Indexer můžete resetovat a obnovit počet rozhraní API.

Klíč se používá pro fakturaci, ale ne pro připojení operací rozšiřování. V případě připojení se vyhledávací služba připojí přes interní síť k prostředku služeb Azure AI umístěnému ve stejné fyzické oblasti. Většina oblastí, které nabízejí Azure AI Search, nabízí také další služby Azure AI, jako je jazyk. Pokud se pokusíte rozšířit AI v oblasti, která nemá obě služby, zobrazí se tato zpráva: "Zadaný klíč není platným klíčem typu CognitiveServices pro oblast vyhledávací služby."

V současné době vyžaduje fakturace předdefinovaných dovedností veřejné připojení z Azure AI Search k jiné službě Azure AI. Zakázání přístupu k veřejné síti přeruší fakturaci. Pokud je zakázání veřejných sítí požadavek, můžete nakonfigurovat vlastní dovednosti webového rozhraní API implementované pomocí funkce Azure, která podporuje privátní koncové body, a přidat prostředek služeb Azure AI do stejné virtuální sítě. Tímto způsobem můžete volat prostředek služeb Azure AI přímo z vlastní dovednosti pomocí privátních koncových bodů.

Poznámka:

Některé předdefinované dovednosti jsou založené na jiných než regionálních službách Azure AI (například dovednost překladu textu). Použití neregionální dovednosti znamená, že vaše žádost může být obsluhována v jiné oblasti než v oblasti Azure AI Search. Další informace o neregionálních službách najdete na stránce služby Azure AI podle oblastí .

Zvláštní případy s klíčovými požadavky

Služba Azure AI Search měří vlastní vyhledávání entit , nikoli služby Azure AI, ale vyžaduje klíč prostředku azure AI pro více služeb k odemknutí transakcí nad 20 na indexer za den. Pouze pro tuto dovednost klíč prostředku odblokuje počet transakcí, ale nesouvisí s fakturací.

Bezplatné rozšiřování

Rozšiřování AI nabízí malé množství bezplatného zpracování fakturovatelných obohacení, abyste mohli provádět krátká cvičení, aniž byste museli připojit prostředek Azure AI s více službami. Bezplatné rozšiřování jsou 20 dokumentů za den na indexer. Pokud chcete zopakovat cvičení, můžete indexer resetovat.

Některé rozšiřování jsou vždy zdarma:

• Pomocné dovednosti, které nevolají služby Azure AI (konkrétně podmíněné, extrakce dokumentů, tvarovač, sloučení textu a rozdělení textu), se neúčtují.

• Extrakce textu z dokumentů PDF a jiných souborů aplikace je nefakturovatelná. Extrahování textu, ke kterému dochází během prolomení dokumentu, není obohacením umělé inteligence, ale dochází k němu během rozšiřování AI, a proto je zde uvedeno.

Fakturovatelné obohacení

Během rozšiřování AI služba Azure AI Search volá rozhraní API služeb Azure AI pro integrované dovednosti založené na azure AI Vision, Translatoru a jazyce Azure AI.

Mezi fakturovatelné integrované dovednosti, které umožňují volání back-endu do služeb Azure AI, patří Entity Linking, Entity Recognition, Image Analysis, Extrakce klíčových frází, Rozpoznávání jazyka, OCR, Detekce identifikovatelných osobních údajů(PII), Mínění a Překlad textu.

Extrakce obrázků je operace Azure AI Search, ke které dochází, když se dokumenty před rozšiřováním prolomí. Extrakce obrázků je fakturovatelná na všech úrovních s výjimkou 20 bezplatných denních extrahování na úrovni Free. Náklady na extrakci obrázků se vztahují na soubory obrázků uvnitř objektů blob, vložené obrázky v jiných souborech (PDF a jiné soubory aplikací) a pro obrázky extrahované pomocí extrakce dokumentů. Ceny extrakce obrázků najdete na stránce s cenami služby Azure AI Search.

Tip

Pokud chcete snížit náklady na zpracování sady dovedností, povolte přírůstkové rozšiřování mezipaměti a opakovaně používejte všechny rozšiřování, které nejsou ovlivněné změnami sady dovedností. Ukládání do mezipaměti vyžaduje Azure Storage (viz ceny , ale kumulativní náklady na spouštění sad dovedností jsou nižší, pokud je možné znovu použít existující rozšíření, zejména pro sady dovedností, které používají extrakci a analýzu obrázků.

Příklad: Odhad nákladů

Pokud chcete odhadnout náklady spojené s indexováním služby Azure AI Search, začněte tím, jak vypadá průměrný dokument, abyste mohli spustit některá čísla. Můžete například odhadnout:

• 1 000 SOUBORŮ PDF.
• Každý ze šesti stránek.
• Jeden obrázek na stránku (6 000 obrázků)
• 3 000 znaků na stránku

Předpokládejme kanál, který se skládá z prolomení dokumentů každého SOUBORU PDF, extrakce obrázků a textu, optického rozpoznávání znaků (OCR) obrázků a rozpoznávání entit organizací.

Ceny uvedené v tomto článku jsou hypotetické. Používají se k ilustraci procesu odhadu. Vaše náklady můžou být nižší. Skutečnou cenu transakcí najdete v tématu Ceny služeb Azure AI.

1. Pro prolomení dokumentu s textem a obsahem obrázku je v současné době extrakce textu zdarma. U 6 000 obrázků předpokládejme, že každý 1 000 obrázků extrahovaných 1 000 USD. To jsou náklady na tento krok ve výši 6,00 USD.

2. Pro OCR 6 000 obrázků v angličtině používá kognitivní dovednost OCR nejlepší algoritmus (DescribeText). Za předpokladu, že náklady na 2,50 USD za 1 000 obrázků, které se mají analyzovat, byste za tento krok zaplatili 15,00 USD.

3. Pro extrakci entit byste měli na stránce celkem tři textové záznamy. Každý záznam má 1 000 znaků. Tři textové záznamy na stránku vynásobené 6 000 stránkami se rovnají 18 000 textovým záznamům. Za předpokladu, že 2,00 USD za 1 000 textových záznamů bude tento krok stát 36,00 USD.

Dohromady byste zaplatili přibližně 57,00 USD na ingestování 1 000 dokumentů PDF tohoto typu s popsanou sadou dovedností.

Další kroky

• Stránka s cenami služby Azure AI Search
• Definování sady dovedností
• Vytvoření sady dovedností (REST)
• Jak mapovat rozšířená pole