Dołącz rozliczalny zasób do zestawu umiejętności w usłudze Azure AI Search

Jeśli korzystasz z wbudowanych funkcji w zakresie wzbogacania funkcji sztucznej inteligencji w usłudze Azure AI Search, możesz wzbogacić niewielką liczbę dokumentów za darmo, do 20 transakcji na jeden indeks dziennie. W przypadku większych lub częstszych obciążeń należy dołączyć do zestawu umiejętności rozliczany zasób firmy Microsoft Foundry.

Usługa Azure AI Search używa dedykowanych, hostowanych wewnętrznie zasobów do wykonywania wbudowanych umiejętności wspieranych przez narzędzia Foundry i wymaga zasobu foundry wyłącznie do celów rozliczeniowych. Wyjątkiem jest funkcja Azure Content Understanding, która używa zasobu do rozliczeń i przetwarzania.

Zasób foundry zapewnia dostęp do wielu usług w narzędziu Foundry Tools. Po określeniu go w zestawie umiejętności firma Microsoft może pobierać opłaty za korzystanie z następujących usług:

• Usługa Azure Vision w narzędziu Foundry Tools do analizy obrazów, optycznego rozpoznawania znaków (OCR) i osadzania wielomodalnego.
• Język platformy Azure w narzędziu Foundry Tools do wykrywania języka, rozpoznawania jednostek, analizy tonacji i wyodrębniania kluczowych fraz.
• Usługa Azure Translator w narzędziu Foundry Tools do tłumaczenia tekstu maszynowego.

Przetwarzanie zestawu umiejętności jest rozliczane z podstawową usługą każdej umiejętności. Usługa Azure AI Search konsoliduje opłaty za narzędzia Foundry w jeden zasób Foundry. Jeśli na przykład używasz umiejętności analizy obrazów i rozpoznawania języka, opłaty za Azure Vision i Azure Language są wyświetlane na tym samym rachunku za zasób Foundry. Wszystkie inne zasoby są rozliczane niezależnie.

Aby dołączyć zasób Foundry, podaj informacje o połączeniu w zestawie funkcji. Możesz użyć podejścia opartego na kluczach lub podejścia bez klucza, które jest obecnie dostępne w wersji zapoznawczej.

Prerequisites

• Łączność za pośrednictwem publicznego punktu końcowego, chyba że usługa wyszukiwania spełnia wymagania dotyczące daty utworzenia, warstwy i regionu dla połączeń prywatnych z zasobem usługi Foundry.

• Zasób Foundry z typem interfejsu API AIServices. Rodzaj interfejsu API można sprawdzić na stronie Przegląd zasobu w witrynie Azure Portal:

  

Fakturowanie przez połączenie bezkluczykowe

Aby dołączyć zasób Foundry, możesz użyć zarządzanej tożsamości i uprawnień. Zaletą tego podejścia jest to, że rozliczenia są bez klucza i nie mają wymagań dotyczących regionów.

Podobnie jak w przypadku kluczy, szczegółowe informacje o zasobie są używane do rozliczeń, a nie połączeń. Wszystkie żądania interfejsu API wysyłane przez usługę Azure AI Search do narzędzi Foundry Tools na potrzeby wbudowanego przetwarzania umiejętności pozostają wewnętrzne i zarządzane przez firmę Microsoft.

Aby rozliczać się za pośrednictwem połączenia bezkluczowego:

1. W usłudze Azure AI Search skonfiguruj tożsamość zarządzaną. Obsługiwane są tożsamości przypisane przez system i przypisane przez użytkownika.

2. W zasobie Foundry przypisz rolę użytkownika usług Cognitive Services do tożsamości zarządzanej usługi wyszukiwania.

3. Skonfiguruj zestaw umiejętności do korzystania z tożsamości zarządzanej. Możesz użyć portalu Azure, najnowszej wersji zapoznawczej Skillsets - Create or Update (REST API) lub pakietu beta Azure SDK, który dostarcza składnię.

   • @odata.type jest zawsze #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl to punkt końcowy zasobu Foundry. Możesz użyć formatu https://<resource-name>.services.ai.azure.com lub https://<resource-name>.cognitiveservices.azure.com, które są dostępne na stronie Klucze i punkt końcowy w Portalu Azure.

   • Inne właściwości są specyficzne dla typu tożsamości zarządzanej, jak pokazano w poniższych przykładach interfejsu API REST.

     • Tożsamość zarządzana przypisana przez system
     • Tożsamość zarządzana przypisana przez użytkownika

     Oto przykładowa konfiguracja zestawu umiejętności dla tożsamości zarządzanej przypisanej przez system. W tym scenariuszu musisz ustawić identity na null.

     POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-11-01-preview
     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
       }
     }
     

Rozliczanie za pomocą klucza zasobu

Domyślnie opłaty za usługę Azure AI Search są naliczane za transakcje przy użyciu klucza zasobu usługi Foundry. Takie podejście jest ogólnie dostępne. Możesz użyć witryny Azure Portal, stabilnej wersji interfejsu API REST lub równoważnego zestawu Azure SDK, aby dodać klucz do zestawu umiejętności.

Istnieją dwa obsługiwane typy kluczy:

• #Microsoft.Azure.Search.CognitiveServicesByKey wywołuje regionalny punkt końcowy.
• #Microsoft.Azure.Search.AIServicesByKey wywołuje poddomenę. Zalecamy ten typ, ponieważ obsługuje udostępnione linki prywatne i nie ma wymagań regionalnych względem usługi wyszukiwania.

Zasób foundry musi znajdować się w tym samym regionie co usługa wyszukiwania. Wybierz region usługi Azure AI Search, który zapewnia integrację narzędzi Foundry Tools, który jest wskazywany przez kolumnę wzbogacania sztucznej inteligencji . Aby uzyskać więcej informacji na temat wymagań dotyczących tego samego regionu, zobacz How the key is used (Jak jest używany klucz).

Jeśli nie określisz cognitiveServices właściwości, usługa wyszukiwania każdego dnia próbuje użyć dostępnych dla indeksatora bezpłatnych wzbogaceń. Wykonywanie rozliczanych umiejętności kończy się na 20 transakcjach na wywołanie indeksatora, a komunikat "Przekroczenie limitu czasu" pojawia się w historii wykonywania indeksatora.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-09-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);

Usuwanie klucza

Wzbogacanie to operacje rozliczane. Jeśli nie musisz już wywoływać narzędzi Foundry, postępuj zgodnie z tymi instrukcjami, aby usunąć klucz i uniemożliwić korzystanie z zasobu foundry.

Bez klucza zestaw umiejętności powraca do domyślnej alokacji 20 bezpłatnych transakcji na indeksator dziennie. Wykonywanie rozliczanych umiejętności kończy się na 20 transakcjach, a komunikat "Limit czasu" pojawia się w historii wykonywania indeksatora, gdy alokacja zostanie wykorzystana.

Sposób użycia klucza

Rozliczenia następują, gdy wywołania interfejsu API do zasobu Foundry przekraczają 20 wywołań interfejsu API na indeksator dziennie. Można zresetować indeksator, aby zresetować liczbę wywołań API.

Połączenia bez klucza i oparte na kluczach są używane do rozliczeń, ale nie dla połączeń związanych z operacjami wzbogacania.

W przypadku połączeń opartych na kluczach usługa wyszukiwania łączy się za pośrednictwem sieci wewnętrznej z zasobem foundry znajdującym się w tym samym regionie fizycznym. Większość regionów oferujących usługę Azure AI Search oferuje również inne usługi platformy Azure. Jeśli spróbujesz wzbogacić sztuczną inteligencję w regionie, który nie ma obu usług, zostanie wyświetlony następujący komunikat: "Podany klucz nie jest prawidłowym kluczem typu CognitiveServices dla regionu usługi wyszukiwania".

W przypadku połączeń bez kluczy usługa wyszukiwania uwierzytelnia się przy użyciu swojej tożsamości i przypisania roli, a następnie jest kierowana na zasób Foundry. Zasób jest określony jako w pełni kwalifikowany identyfikator URI, a identyfikator URI zawiera unikatową poddomenę.

Indeksatory można skonfigurować do uruchamiania w prywatnym środowisku wykonawczym do dedykowanego przetwarzania przy użyciu tylko węzłów wyszukiwania własnej usługi. Nawet jeśli używasz prywatnego środowiska wykonawczego, usługa Azure AI Search nadal używa swoich zasobów aprowizowanych wewnętrznie do wykonywania wszystkich wzbogaceń umiejętności.

Wymagania dotyczące połączenia publicznego

W zależności od tego, kiedy usługa wyszukiwania została utworzona, jej poziom cenowy i jej region, rozliczenia wbudowanych umiejętności mogą wymagać publicznego połączenia z Azure AI Search do zasobu Foundry. Wyłączenie dostępu do sieci publicznej powoduje przerwanie rozliczeń w niektórych scenariuszach. Zapoznaj się z wymaganiami dotyczącymi połączeń za pośrednictwem udostępnionego łącza prywatnego, aby określić, czy usługa wyszukiwania wymaga połączenia publicznego.

Jeśli nie możesz użyć sieci publicznej, możesz skonfigurować niestandardową funkcję Web API zaimplementowaną za pomocą Funkcji Azure, która obsługuje prywatne punkty końcowe, i dodać swój zasób Foundry do tej samej sieci wirtualnej. W tym scenariuszu możesz wywołać zasób Foundry bezpośrednio z poziomu umiejętności niestandardowej przy użyciu prywatnych punktów końcowych.

Kluczowe wymagania szczególne przypadki

Wyszukiwanie jednostek niestandardowych jest mierzone przez usługę Azure AI Search, ale wymaga klucza zasobu foundry w celu odblokowania transakcji przekraczających 20 na indeksator dziennie. Tylko w przypadku tej umiejętności klucz zasobu odblokuje liczbę transakcji, ale nie ma związku z rozliczeniami.

Bezpłatne wzbogacania

Wzbogacanie przy użyciu sztucznej inteligencji oferuje niewielką ilość bezpłatnego przetwarzania płatnych operacji wzbogacających, dzięki czemu można wykonać krótkie ćwiczenia bez potrzeby dołączania zewnętrznego zasobu. Bezpłatne wzbogacania to 20 dokumentów na indeksator dziennie. Możesz zresetować indeksator, aby zrestartować licznik, jeśli chcesz powtórzyć ćwiczenie.

Niektóre wzbogacenia są zawsze bezpłatne:

• Umiejętności użytkowe, które nie używają narzędzi Foundry Tools (a mianowicie umiejętności warunkowe, wyodrębniania dokumentów, kształtowania, scalania tekstu i dzielenia tekstu), nie są rozliczane.

• Wyodrębnianie tekstu z dokumentów PDF i innych plików aplikacji nie jest możliwe. Wyodrębnianie tekstu, które występuje podczas analizy dokumentów, nie jest wzbogacaniem sztucznej inteligencji, ale odbywa się podczas wzbogacania AI, i zostało tutaj wspomniane.

Rozliczane wzbogacania

Podczas wzbogacania sztucznej inteligencji usługa Azure AI Search wywołuje interfejsy API na potrzeby wbudowanych umiejętności opartych na usługach Azure Vision, Azure Language i Azure Translator.

Rozliczane wbudowane umiejętności, które przeprowadzają wywołania zaplecza do usług zewnętrznych, obejmują:

• Łączenie jednostek
• Rozpoznawanie jednostek
• Analiza obrazu
• Ekstrakcja Kluczowych Frazy
• Wykrywanie języka
• Optyczne rozpoznawanie znaków
• Wykrywanie danych osobowych
• Sentyment
• Tłumaczenie tekstu
• Wielomodalne osadzanie Azure Vision

Wektoryzator czasu zapytania wspierany przez model osadzania wielomodalnego usługi Azure Vision jest również rozliczanym wzbogacaniem.

Wyodrębnianie obrazów to operacja usługi Azure AI Search, która ma miejsce, gdy dokumenty są przetwarzane, zanim zostaną wzbogacone. Wyodrębnianie obrazów jest rozliczane we wszystkich poziomach cenowych, z wyjątkiem 20 darmowych wyodrębnień dziennie na poziomie darmowym. Koszty wyodrębniania obrazów dotyczą plików graficznych w blobach, obrazów osadzonych w innych plikach (PDF i inne pliki aplikacyjne) oraz obrazów wyodrębnionych za pomocą Document Extraction. Aby uzyskać cennik wyodrębniania obrazów, zobacz stronę cennika usługi Azure AI Search.

Przykład: Szacowanie kosztów

Ceny przedstawione w tej sekcji są hipotetyczne i używane do zilustrowania procesu szacowania. Koszty mogą być niższe. Aby uzyskać rzeczywistą cenę transakcji, zobacz Cennik narzędzi Foundry.

Aby oszacować koszty związane z indeksowaniem w usłudze Azure AI Search, zacznij od wyobrażenia sobie, jak wygląda przeciętny dokument, aby można było wykonać obliczenia. Możesz na przykład przybliżyć następujące elementy:

• 1000 plików PDF
• Sześć stron każdy
• Jeden obraz na stronę (6000 obrazów)
• 3000 znaków na stronę

Załóżmy, że potok składa się z analizy każdego dokumentu PDF, wyodrębniania obrazów i tekstu, rozpoznawania znaków OCR na obrazach oraz rozpoznawania jednostek organizacyjnych.

1. W przypadku łamania dokumentów z zawartością tekstu i obrazu wyodrębnianie tekstu jest obecnie bezpłatne. W przypadku 6000 obrazów przyjmij 1 USD za każde wyodrębnione 1000 obrazów. To koszt 6,00 USD za ten krok.

2. W przypadku rozpoznawania tekstu OCR z 6000 obrazów w języku angielskim, zdolność kognitywna OCR używa najlepszego algorytmu (DescribeText). Zakładając koszt wynoszący 2,50 USD za każde 1 000 obrazów do przeanalizowania, należy uiścić opłatę w wysokości 15,00 USD za ten krok.

3. W przypadku wyodrębniania jednostek będziesz mieć łącznie trzy rekordy tekstowe na stronę. Każdy rekord ma 1000 znaków. Trzy rekordy tekstowe na stronę pomnożone przez 6000 stron równe 18 000 rekordów tekstowych. Zakładając, że 2,00 USD za 1000 rekordów tekstowych, ten krok będzie kosztować 36,00 USD.

Łącząc to wszystko, zapłacisz około 57,00 dolarów, aby przetworzyć 1000 dokumentów PDF tego typu przy użyciu opisanego zestawu umiejętności.

Treści powiązane

• Strona cennika usługi Azure AI Search
• Jak zdefiniować zestaw umiejętności
• Tworzenie zestawu umiejętności (REST)
• Jak mapować wzbogacone pola