Dołączanie rozliczanego zasobu do zestawu umiejętności w Wyszukiwanie AI platformy Azure

Jeśli używasz wbudowanych umiejętności dotyczących wzbogacania AI w Wyszukiwanie AI platformy Azure, możesz wzbogacić niewielką liczbę dokumentów bezpłatnie, maksymalnie 20 transakcji na indeks dziennie. W przypadku większych lub częstszych obciążeń należy dołączyć rozliczany zasób Microsoft Foundry do skillset.

Wyszukiwanie AI platformy Azure 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 umiejętność 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. Gdy określisz to w zestawie umiejętności, Microsoft może pobierać opłaty za korzystanie z następujących usług:

• Azure Vision w narzędziach Foundry Tools na potrzeby analizy obrazów, optycznego rozpoznawania znaków (OCR) i osadzania wielomodalnego.
• Azure Language in Foundry Tools na potrzeby wykrywania języka, rozpoznawania jednostek, analizy tonacji i wyodrębniania kluczowych fraz.
• Azure Translator w narzędziu Foundry Tools na potrzeby tłumaczenia tekstu maszynowego.

Przetwarzanie zestawu umiejętności jest rozliczane z podstawową usługą każdej umiejętności. Wyszukiwanie AI platformy Azure konsoliduje opłaty za Foundry Tools w jeden zasób Foundry. Jeśli na przykład używasz umiejętności Image Analysis i Language Detection, opłaty za usługi Azure Vision i Azure Language są wyświetlane na tej samej fakturze za zasób Foundry. Wszystkie inne zasoby są rozliczane niezależnie.

Aby dołączyć zasób Foundry, podaj informacje o połączeniu w zestawie umiejętności. Można użyć podejścia opartego na kluczach lub bez klucza.

Wymagania wstępne

• Łą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 AIServices API. Rodzaj interfejsu API można sprawdzić na stronie zasobu Overview w portalu Azure.

  

Rozliczanie za pośrednictwem połączenia bez klucza

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 Wyszukiwanie AI platformy Azure do narzędzi Foundry Tools dla potrzeb przetwarzania wbudowanych umiejętności pozostają wewnętrzne i zarządzane przez Microsoft.

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

1. W usłudze Wyszukiwanie AI platformy Azure konfiguruj 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 stabilnej wersji Skillsets — tworzenie lub aktualizowanie (interfejs API REST) lub pakiet Azure SDK, który udostępnia 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, z których oba 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=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
     }
   }
   

Rozliczanie poprzez klucz zasobu

Domyślnie Wyszukiwanie AI platformy Azure nalicza opłaty za transakcje przy użyciu klucza zasobu Foundry. Takie podejście jest ogólnie dostępne. Aby dodać klucz do zestawu umiejętności, możesz użyć portalu Azure, stabilnej wersji interfejsu API REST lub równoważnego Azure SDK.

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 Wyszukiwanie AI platformy Azure, który zapewnia integrację narzędzi Foundry, która jest wskazywana w kolumnie AI wzbogacania. 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 spróbuje użyć bezpłatnych usług wzbogacających dostępnych dla indeksera każdego dnia. Wykonywanie funkcji podlegających opłacie kończy się na 20 transakcjach na wywołanie indeksatora, a komunikat "Przekroczenie limitu czasu" pojawia się w historii wykonania indeksatora.

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

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 informacja "Przekroczenie limitu czasu" pojawia się w historii wykonywania indeksatora, gdy alokacja zostanie zużyta.

Sposób użycia klucza

Rozliczanie rozpoczyna się, gdy wywołania interfejsu API do zasobu usługi Foundry przekraczają 20 wywołań na indeksator na dzień. Można zresetować indeksator, aby zresetować licznik 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 Wyszukiwanie AI platformy Azure oferuje również inne usługi 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ń bezkluczowych usługa wyszukiwania uwierzytelnia się za pomocą swojej tożsamości i przypisania roli. Następnie kieruje swoje działanie 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 wykonywania na potrzeby przetwarzania dedykowanego przy użyciu tylko węzłów wyszukiwania własnej usługi wyszukiwania. Nawet jeśli używasz prywatnego środowiska wykonawczego, Wyszukiwanie AI platformy Azure 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 warstwie cenowej i regionie, rozliczenia za umiejętności wbudowane mogą wymagać publicznego połączenia z zasobu Wyszukiwanie AI platformy Azure 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ć umiejętność Dostosowanego interfejsu API sieci Web zaimplementowaną za pomocą Funkcji Azure, która obsługuje punkty końcowe prywatne i dodaj zasób Foundry do tej samej sieci wirtualnej. W tym scenariuszu możesz wywołać zasób usługi Foundry bezpośrednio z poziomu umiejętności niestandardowej przy użyciu prywatnych punktów końcowych.

Kluczowe wymagania przypadki szczególne

Wyszukiwanie niestandardowych encji jest mierzone przez Wyszukiwanie AI platformy Azure, ale wymaga klucza zasobów Foundry do odblokowania transakcji przekraczających 20 na indeksujący dziennie. Tylko w przypadku tej umiejętności klucz zasobu odblokuje liczbę transakcji, ale nie ma związku z rozliczeniami.

Bezpłatne wzbogacania

Funkcja wzbogacania AI oferuje odrobinę bezpłatnego przetwarzania rozliczanych ulepszeń, dzięki czemu można zrealizować krótkie ćwiczenia bez potrzeby podłączania zewnętrznego zasobu. Bezpłatne wzbogacania to 20 dokumentów na indeksator dziennie. Indeksator można zresetować , aby zresetować licznik, jeśli chcesz powtórzyć ćwiczenie.

Niektóre wzbogacenia są zawsze bezpłatne:

• Umiejętności narzędziowe, które nie wykorzystują 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 przetwarzania dokumentów, nie jest procesem wzbogacania danych przez sztuczną inteligencję, ale odbywa się podczas wzbogacania AI i dlatego zostaje tutaj wspomniany.

Rozliczane wzbogacania

Podczas wzbogacania sztucznej inteligencji Wyszukiwanie AI platformy Azure wywołuje interfejsy API dla funkcjonalności wbudowanych, które są oparte na Azure Vision, Azure Language i Azure Translator.

Rozliczane wbudowane funkcje, które wykonują wywołania na zaplecze do usług zewnętrznych, obejmują:

• Łączenie jednostek
• Rozpoznawanie jednostek
• Analiza obrazu
• Wyodrębnianie kluczowych fraz
• Wykrywanie języka
• OCR
• Wykrywanie danych osobowych
• Sentyment
• Tłumaczenie tekstu
• Wielomodalne osadzenia Azure Vision (wersja zapoznawcza)

Wektorizer query-time wspierany przez multimodalny model embeddingu Azure Vision jest również płatnym wzbogaceniem.

Wyodrębnianie obrazów to operacja w usłudze Wyszukiwanie AI platformy Azure przeprowadzana podczas przetwarzania dokumentów przed ich wzbogacaniem. Wyodrębnianie obrazów jest rozliczane we wszystkich poziomach cenowych, z wyjątkiem 20 bezpłatnych wyodrębnień dziennie w bezpłatnym poziomie. Koszty wyodrębniania obrazów mają zastosowanie do plików obrazów wewnątrz blobów, obrazów osadzonych w innych plikach (PDF i innych plików aplikacji) oraz obrazów wyodrębnionych przy użyciu Document Extraction. Aby uzyskać cennik wyodrębniania obrazów, zobacz stronę cennika Wyszukiwanie AI platformy Azure.

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 Wyszukiwanie AI platformy Azure, rozpocznij od wyobrażenia, jak wygląda średni dokument, aby móc przeanalizować dane. 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 przetwarzania dokumentów każdego pliku PDF, wyodrębniania tekstu i obrazów, rozpoznawania znaków (OCR) na obrazach i rozpoznawania encji organizacji.

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 znaków OCR z 6000 obrazów w języku angielskim funkcja kognitywna OCR używa najlepszego algorytmu DescribeText. Przy założeniu, że koszt analizowania wynosi 2,50 USD za 1000 obrazów, zapłacisz 15,00 USD za ten etap.

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.

Powiązana zawartość

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