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

Článek
11/19/2024

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. Poskytnutí účtu v sadě dovedností Azure AI Search 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

V sadě dovedností musíte poskytnout informace o připojení k více prostředkům Azure AI. Azure AI Search nepoužívá připojení pro úlohy sady dovedností, ale používá připojení pro přístup k měřičům fakturace prostředku. Váš účet služeb Azure AI se proto používá k fakturaci, nikoli ke zpracování dovedností. Azure AI Search používá k zpracování dovedností samostatné vyhrazené prostředky.

V připojení můžete použít klíč nebo implementovat přístup bez klíčů, který je aktuálně ve verzi Preview.

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.

Požadavky

Připojení přes veřejný koncový bod, pokud vaše vyhledávací služba nesplňuje požadavky na datum vytvoření, úroveň a oblast pro privátní připojení k účtu azure AI s více službami.

Poznámka:

Pokud je váš prostředek Azure AI nakonfigurovaný tak, aby používal privátní koncový bod, azure AI Search se může připojit pomocí sdíleného privátního propojení , pokud byla vyhledávací služba vytvořená po 3. dubnu 2024 a je v oblasti, která poskytuje vyšší výpočetní výkon a je na podporované úrovni. Další informace najdete v požadavcích na používání sdílených privátních propojení.

Vyúčtování prostřednictvím připojení bez klíčů

Poznámka:

Tato funkce je v současné době ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučuje se pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Pomocí webu Azure Portal nebo novějších rozhraní REST API a balíčků beta sady SDK můžete připojit prostředek azure AI s více službami pomocí spravované identity a oprávnění. Výhodou tohoto přístupu je, že fakturace je bezklíčová a nemá žádnou závislost na oblastech.

Nakonfigurujte Azure AI Search tak, aby používala spravovanou identitu.
Na prostředku Azure AI s více službami přiřaďte identitu k roli uživatele služeb Cognitive Services.
Pomocí webu Azure Portal nebo sady dovedností 2024-11-01-preview nebo beta balíčku sady Azure SDK, který poskytuje syntaxi, nakonfigurujte sadu dovedností tak, aby používala identitu:
- Spravovaná identita použitá v připojení patří do vyhledávací služby.
- Identita může být spravovaná systémem nebo přiřazená uživatelem.
- Identita musí mít oprávnění uživatele služeb Cognitive Services k prostředku Azure AI.
- @odata.type je vždy #Microsoft.Azure.Search.AIServicesByIdentity.
- subdomainUrl je koncový bod vašeho prostředku Azure AI s více službami. Může být v libovolné oblasti, která je společně podporovaná službami Azure AI Search a Azure AI.

Stejně jako u klíčů se podrobnosti o prostředku azure AI Services používají pro fakturaci, ne pro připojení. Všechny požadavky rozhraní API vytvořené službou Azure AI Search do služeb Azure AI pro integrované zpracování dovedností jsou i nadále interní a spravované Microsoftem.

Příklad: spravovaná identita přiřazená systémem

Identita je nastavená na hodnotu 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říklad: spravovaná identita přiřazená uživatelem

Identita je nastavená na ID prostředku spravované identity přiřazené uživatelem. Pokud chcete najít existující spravovanou identitu přiřazenou uživatelem, přečtěte si téma Správa spravovaných identit přiřazených uživatelem.

Pro spravovanou identitu přiřazenou uživatelem nastavte @odata.type vlastnosti a userAssignedIdentity vlastnosti.

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

Faktura prostřednictvím klíče prostředku

Azure AI Search může také účtovat transakce pomocí klíče prostředku Azure AI s více službami. Tento přístup je výchozí a je obecně dostupný. Klíč ke sadě dovedností můžete přidat pomocí webu Azure Portal, rozhraní REST API nebo sady Azure SDK.

Existují dva podporované typy klíčů: #Microsoft.Azure.Search.CognitiveServicesByKey které volají regionální koncový bod a "#Microsoft.Azure.Search.AIServicesByKey který volá subdoménu. Doporučujeme používat AIServicesByKey podporu sdílených privátních propojení a možnost fungovat bez regionálních požadavků vzhledem k vyhledávací službě.

Pokud necháte vlastnost nezadanou cognitiveServices , 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.

Přihlaste se k portálu Azure.
Ve stejné oblasti jako vyhledávací služba vytvořte prostředek Azure AI s více službami.
Získejte klíč prostředku ze stránky Klíče prostředků>a koncového bodu.
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í.

Poznámka:

Azure Portal aktuálně automaticky připojí klíč typu #Microsoft.Azure.Search.CognitiveServicesByKey.

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-11-01-Preview
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.AIServicesByKey",
        "description": "mycogsvcs",
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
        "key": "<your key goes here>"
    }
}

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
REST

Přihlaste se k portálu Azure.
V části Sady dovedností správy > vyhledávání vyberte ze seznamu sadu dovedností.
Posuňte se k oddílu v souboru obsahujícím "cognitiveServices".
Odstraňte hodnotu klíče z JSON a uložte sadu dovedností.

Získejte sadu dovedností, abyste měli úplnou definici.
Formulujte žádost o aktualizaci sady dovedností a zadejte definici JSON sady dovedností.

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 se projeví, 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.

Připojení bez klíčů a klíčů se používají 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."

Indexery je možné nakonfigurovat tak, aby běžely v privátním spouštěcím prostředí pro vyhrazené zpracování pomocí pouze vyhledávacích uzlů vaší vlastní vyhledávací služby. I když používáte prostředí privátního spouštění, Azure AI Search stále využívá svůj interně zřízený prostředek azure AI s více službami k obohacení všech dovedností.

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í .

Požadavky na veřejné připojení

V závislosti na tom, kdy byla vaše vyhledávací služba vytvořena a její úroveň a oblast, může fakturace předdefinovaných dovedností vyžadovat veřejné připojení z Azure AI Search k více službám Azure AI. Zakázání přístupu k veřejné síti přeruší fakturaci v některých scénářích. Zkontrolujte požadavky na připojení prostřednictvím sdíleného privátního propojení a zjistěte, jestli vaše vyhledávací služba vyžaduje veřejné připojení.

Pokud nemůžete použít veřejnou síť, 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ů.

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.

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.
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.
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í.

Sdílet prostřednictvím

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

Požadavky

Vyúčtování prostřednictvím připojení bez klíčů

Příklad: spravovaná identita přiřazená systémem

Příklad: spravovaná identita přiřazená uživatelem

Faktura prostřednictvím klíče prostředku

Odebrání klíče

Jak se klíč používá

Požadavky na veřejné připojení

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

Bezplatné rozšiřování

Fakturovatelné obohacení

Příklad: Odhad nákladů

Další kroky

Váš názor

Další materiály