Připojte fakturovatelný prostředek k sadě dovedností v Azure AI Vyhledávač

Pokud používáte integrované dovednosti pro rozšiřování AI v Azure AI Vyhledávač, můžete zdarma rozšířit malý počet dokumentů až o 20 transakcí na index za den. U větších nebo častějších úloh byste měli k skillset připojit fakturovatelný prostředek Microsoft Foundry.

Azure AI Vyhledávač používá vyhrazené a interně hostované prostředky k provádění integrovaných dovedností založených na nástrojích Foundry a vyžaduje prostředek Foundry výhradně pro účely fakturace. Výjimkou je funkce Azure Content Understanding, která používá váš prostředek pro fakturaci i zpracování.

Prostředek Foundry poskytuje přístup k více službám v nástrojích Foundry. Když ji zadáte v sadě dovedností, Microsoft vám může účtovat poplatky za používání následujících služeb:

• Azure Vision in Foundry Tools pro analýzu obrazu, optické rozpoznávání znaků (OCR) a multimodální vkládání.
• Azure Language in Foundry Tools pro detekci jazyka, rozpoznávání entit, analýzu sentimentu a extrakci klíčových frází.
• Azure Translator v nástrojích Foundry pro strojový překlad textu.

Zpracování sady dovedností se účtuje podkladové službě každé dovednosti. Azure AI Vyhledávač konsoliduje účtování za nástroje Foundry do jediného prostředku Foundry. Pokud například použijete dovednosti Image Analysis a Language Detection, poplatky za Azure Vision a Azure Language se zobrazí na stejné faktuře za váš prostředek Foundry. Všechny ostatní prostředky se účtují nezávisle.

Pokud chcete připojit prostředek Foundry, zadejte informace o připojení v sadě dovedností. Můžete použít přístup založený na klíčích nebo bez klíčů.

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í, vrstvu a oblast pro privátní připojení k prostředku Foundry.

• Prostředek Foundry s typem AIServices rozhraní API. Druh rozhraní API můžete ověřit na stránce Overview prostředku na portálu Azure:

  

Vyúčtování prostřednictvím bezklíčového připojení

Spravovanou identitu a oprávnění můžete použít k připojení prostředku Foundry. Výhodou tohoto přístupu je, že fakturace je bezklíčová a nemá požadavky na oblast.

Stejně jako u klíčů se podrobnosti o prostředku používají pro fakturaci, ne pro připojení. Všechny požadavky rozhraní API prováděné Azure AI Vyhledávač pro nástroje Foundry pro integrované zpracování dovedností zůstávají interní a spravované společností Microsoft.

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

1. Ve službě Azure AI Vyhledávač konfigurujte spravovanou identitu. Podporují se identity přiřazené systémem i uživatelem.

2. V prostředku Foundry přiřaďte roli uživatele služeb Cognitive Services spravované identitě vyhledávací služby.

3. Nakonfigurujte sadu dovedností tak, aby používala spravovanou identitu. Můžete použít portál Azure, nejnovější stabilní verzi Skillsets – Vytvoření nebo aktualizace (REST API) nebo balíček Azure SDK, který poskytuje syntaxi.

   • @odata.type je vždy #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl je koncový bod vašeho zdroje Foundry. Na portálu Azure můžete použít formát https://<resource-name>.services.ai.azure.com nebo https://<resource-name>.cognitiveservices.azure.com, z nichž obě jsou dostupné na stránce Klíče a koncového bodu.

   • Další vlastnosti jsou specifické pro typ spravované identity, jak je znázorněno v následujících příkladech rozhraní REST API.

   • Spravovaná identita přiřazená systémem
   • Spravovaná identita přiřazená uživatelem

   Tady je ukázková konfigurace sady dovedností pro spravovanou identitu přiřazenou systémem. V tomto scénáři je nutné nastavit identity hodnotu null.

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

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

Ve výchozím nastavení si Azure AI Vyhledávač účtuje poplatky za transakce pomocí klíče zdroje Foundry. Tento přístup je obecně dostupný. Klíč ke sadě dovedností můžete přidat pomocí portálu Azure, stabilní verze rozhraní REST API nebo ekvivalentního Azure SDK.

Existují dva podporované typy klíčů:

• #Microsoft.Azure.Search.CognitiveServicesByKey volá regionální koncový bod.
• #Microsoft.Azure.Search.AIServicesByKey volá subdoménu. Tento typ doporučujeme, protože podporuje sdílené privátní odkazy a nemá místní požadavky vzhledem k vyhledávací službě.

Váš prostředek Foundry musí být ve stejné oblasti jako vaše vyhledávací služba. Zvolte oblast Azure AI Vyhledávač, která poskytuje integraci Foundry Tools, je uvedena ve sloupci AI enrichment. Další informace o požadavku na stejnou oblast najdete v tématu Použití klíče.

Pokud nezadáte vlastnost cognitiveServices, vaše vyhledávací služba se každý den pokusí použít bezplatná obohacení, která jsou pro indexer k dispozici. Provádění zpoplatněných dovedností se zastaví při každém volání indexeru po 20 transakcích a v historii provádění indexeru se zobrazí zpráva "Vypršení časového limitu".

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

Odebrání klíče

Rozšiřování jsou fakturovatelné operace. Pokud už nepotřebujete volat Foundry Tools, odeberte klíč podle těchto pokynů a zabraňte použití prostředku Foundry.

Bez klíče se sada dovedností vrátí k výchozímu přidělení 20 bezplatných transakcí na indexer za den. Vykonávání účtovatelných dovedností se zastaví po 20 transakcích a při využití alokace se v historii provádění indexátoru zobrazí zpráva "Časový výpadek".

Jak se klíč používá

Fakturace se projeví, když volání rozhraní API pro prostředek Foundry překročí 20 volání rozhraní API na indexer za den. Můžete resetovat indexer a resetovat počet API.

Připojení bezklíčová a klíčová se používají pro fakturaci, ale ne pro připojení související s obohacovacími operacemi.

Pro připojení založená na klíčích se vyhledávací služba připojí přes interní síť k prostředku Foundry umístěnému ve stejné fyzické oblasti. Většina oblastí, které nabízejí Azure AI Vyhledávač, nabízí také další Azure služby. Pokud se pokusíte rozšířit AI v oblasti, která nemá obě služby, zobrazí se tato zpráva: "Zadaný klíč není platný klíč typu CognitiveServices pro oblast vaší vyhledávací služby.".

V případě bezklíčových připojení se vyhledávací služba ověřuje pomocí své identity a přiřazení role a cílí na prostředek Foundry. Prostředek se zadává jako plně kvalifikovaný identifikátor URI a identifikátor URI obsahuje jedinečnou subdoménu.

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 privátní spouštěcí prostředí, Azure AI Vyhledávač stále využívá interní zřízené prostředky k obohacení všech dovedností.

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

V závislosti na tom, kdy byla vaše vyhledávací služba vytvořena, její cenová úroveň a její oblast, může fakturace za připravené dovednosti vyžadovat veřejné připojení z Azure AI Vyhledávač k vašemu prostředku Foundry. 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í dovednost webového rozhraní API Custom implementovanou pomocí funkcí Azure, která podporuje soukromé koncové body private, a přidejte prostředek Foundry ke stejné virtuální síti. V tomto scénáři můžete prostředky Foundry volat přímo z vlastních dovedností pomocí privátních koncových bodů.

Klíčové požadavky ve zvláštních případech

Custom Entity Lookup je měřeno pomocí Azure AI Vyhledávač, ale k odemknutí více než 20 transakcí na indexer za den je vyžadován klíč prostředku Foundry. Pouze pro tuto funkci klíč prostředku odblokuje počet transakcí, ale nesouvisí s fakturací.

Bezplatné rozšiřování

Obohacování AI nabízí malé množství bezplatného zpracování obohacení, která jsou obvykle zpoplatněna, abyste mohli provádět krátká cvičení, aniž by bylo nutné připojit externí zdroj. Bezplatný přírůstek je 20 dokumentů na indexátor za den. Můžete resetovat indexer k resetování čítače, pokud chcete zopakovat cvičení.

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

• Dovednosti, které nevyužívají nástroje Foundry (konkrétně Podmíněné, Extrakce dokumentů, Shaper, Sloučení textu a Rozdělení textu), nejsou fakturovatelné.

• 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 Azure AI Vyhledávač volá rozhraní API pro připravené dovednosti založené na Azure Vision, Azure Language a Azure Translator.

Mezi fakturovatelné integrované dovednosti, které umožňují volání back-endu do externích služeb, patří:

• Propojení entit
• Rozpoznávání entit
• Analýza obrázků
• Extrakce klíčových frází
• Rozpoznávání jazyka
• OCR
• Detekce identifikovatelných osobních údajů (PII)
• Sentiment
• Překlad textu
• Multimodální embeddingy Azure Vision (verze Preview)

Vektorizátor pro čas dotazu podporovaný multimodálním embedding modelem Azure Vision je také zpoplatněným obohacením.

Extrakce obrázků je operace v Azure AI Vyhledávač, ke které dochází, když jsou dokumenty zpracovány před vylepšením. Extrakce obrázků se účtuje na všech cenových ú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 obrázky extrahované pomocí extrakce dokumentů. Informace o cenách extrakce obrázků najdete na stránce s cenami Azure AI Vyhledávač.

Příklad: Odhad nákladů

Ceny uvedené v této části jsou hypotetické a slouží k ilustraci procesu odhadu. Vaše náklady můžou být nižší. Skutečnou cenu transakcí najdete na stránce Foundry Tools pricing.

Pokud chcete odhadnout náklady spojené s indexováním Azure AI Vyhledávač, začněte tím, že zjistíte, jak vypadá průměrný dokument, abyste mohli provést nějaké výpočty. Můžete například odhadnout:

• 1 000 souborů PDF
• Šest stránek každý
• 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á ze zpracování dokumentů každého PDF, extrakce textu a obrázků, OCR obrázků a rozpoznávání entit u organizací.

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 za každých 1 000 extrahovaných obrázků získáme 1 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). Předpokládáme-li náklady ve výši 2,50 USD za analýzu 1 000 snímků, zaplatili byste za tento krok 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. Při ceně 2,00 USD za 1 000 textových záznamů by tento krok stál 36,00 USD.

Celkem byste zaplatili přibližně 57,00 USD za zpracování 1 000 dokumentů PDF tohoto typu s uvedenou úrovní dovedností.

Související obsah

• stránka s cenami Azure AI Vyhledávač
• Jak definovat dovednosti
• Vytvoření sady dovedností (REST)
• Jak mapovat rozšířená pole