Dołączanie zasobu wielosób usługi Azure AI do zestawu umiejętności w usłudze Azure AI Search

Artykuł
11/19/2024

Podczas konfigurowania opcjonalnego potoku wzbogacania sztucznej inteligencji w usłudze Azure AI Search można wzbogacić niewielką liczbę dokumentów bezpłatnie, maksymalnie 20 transakcji dziennie na indeks. W przypadku większych i częstszych obciążeń należy dołączyć rozliczany zasób wielosób usługi Azure AI.

Konto wielosługowe udostępnia kolekcję usług azure AI, a nie poszczególnych usług. Udostępnienie konta w zestawie umiejętności usługi Azure AI Search umożliwia firmie Microsoft naliczanie opłat za korzystanie z tych usług:

Usługa Azure AI Vision na potrzeby analizy obrazów, optycznego rozpoznawania znaków (OCR) oraz osadzania tekstu wielomodalnego i obrazu.
Język AI platformy Azure na potrzeby wykrywania języka, rozpoznawania jednostek, analizy tonacji i wyodrębniania kluczowych fraz
Azure AI Speech for speech to text and text to speech (Mowa w usłudze Azure AI na potrzeby zamiany mowy na tekst i tekst na mowę)
Usługa Azure AI Translator na potrzeby tłumaczenia tekstu maszynowego

W zestawie umiejętności musisz podać informacje o połączeniu z wieloma zasobami usługi Azure AI. Usługa Azure AI Search nie używa połączenia dla obciążeń zestawu umiejętności, ale używa połączenia w celu uzyskania dostępu do mierników rozliczeń w zasobie. W związku z tym konto usług Azure AI jest używane do rozliczeń, a nie przetwarzania umiejętności. Usługa Azure AI Search używa oddzielnych dedykowanych zasobów do przetwarzania umiejętności.

Możesz użyć klucza w połączeniu lub zaimplementować podejście bez klucza, które jest obecnie dostępne w wersji zapoznawczej.

Napiwek

Platforma Azure udostępnia infrastrukturę do monitorowania rozliczeń i budżetów. Aby uzyskać więcej informacji na temat monitorowania usług Azure AI, zobacz Planowanie kosztów usług Azure AI i zarządzanie nimi.

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 kontem usługi Azure AI z wieloma usługami.

Uwaga

Jeśli zasób usługi Azure AI jest skonfigurowany do korzystania z prywatnego punktu końcowego, usługa Azure AI Search może nawiązać połączenie przy użyciu udostępnionego łącza prywatnego, jeśli usługa wyszukiwania została utworzona po 3 kwietnia 2024 r. i znajduje się w regionie zapewniającym większą moc obliczeniową pojemności i jest w obsługiwanej warstwie. Aby uzyskać więcej informacji, zobacz wymagania dotyczące korzystania z udostępnionych linków prywatnych.

Rozliczanie za pośrednictwem połączenia bez klucza

Uwaga

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

Korzystając z witryny Azure Portal lub nowszych wersji zapoznawczych interfejsów API REST i pakietów zestawu SDK w wersji beta, możesz dołączyć zasób wielosób usługi azure AI przy użyciu tożsamości zarządzanej i uprawnień. Zaletą tego podejścia jest to, że rozliczenia są bez klucza i nie są zależne od regionów.

Skonfiguruj usługę Azure AI Search do korzystania z tożsamości zarządzanej.
W zasobie wielosługi usługi Azure AI przypisz tożsamość do roli użytkownika usług Cognitive Services.
Przy użyciu witryny Azure Portal lub zestawu umiejętności 2024-11-01-preview interfejsu API REST lub pakietu beta zestawu Azure SDK, który zapewnia składnię, skonfiguruj zestaw umiejętności do korzystania z tożsamości:
- Tożsamość zarządzana używana w połączeniu należy do usługi wyszukiwania.
- Tożsamość może być zarządzana przez system lub przypisana przez użytkownika.
- Tożsamość musi mieć uprawnienia użytkownika usług Cognitive Services w zasobie usługi Azure AI.
- @odata.type jest zawsze #Microsoft.Azure.Search.AIServicesByIdentity.
- subdomainUrl to punkt końcowy zasobu wielosłużytowego usługi Azure AI. Może to być dowolny region, który jest wspólnie obsługiwany przez usługi Azure AI Search i Azure AI.

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

Przykład: tożsamość zarządzana przypisana przez system

Tożsamość jest ustawiona na wartość 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 
    }  
}

Przykład: tożsamość zarządzana przypisana przez użytkownika

Tożsamość jest ustawiona na identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika. Aby znaleźć istniejącą tożsamość zarządzaną przypisaną przez użytkownika, zobacz Zarządzanie tożsamościami zarządzanymi przypisanymi przez użytkownika.

W przypadku tożsamości zarządzanej przypisanej przez użytkownika ustaw @odata.type właściwości i userAssignedIdentity .

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

Rozliczanie za pomocą klucza zasobu

Usługa Azure AI Search może również pobierać opłaty za transakcję przy użyciu klucza zasobu wielosłużytowego usługi Azure AI. To podejście jest domyślne i jest ogólnie dostępne. Aby dodać klucz do zestawu umiejętności, możesz użyć witryny Azure Portal, interfejsu API REST lub zestawu AZURE SDK.

Istnieją dwa obsługiwane typy kluczy: #Microsoft.Azure.Search.CognitiveServicesByKey które wywołuje regionalny punkt końcowy i "#Microsoft.Azure.Search.AIServicesByKey które wywołuje poddomenę. Zalecamy użycie AIServicesByKey obsługi udostępnionego łącza prywatnego i możliwości działania bez wymagań regionalnych względem usługi wyszukiwania.

Jeśli pozostawisz cognitiveServices właściwość nieokreśloną, usługa wyszukiwania próbuje codziennie korzystać z bezpłatnych wzbogacenia dostępnych dla indeksatora. Wykonywanie rozliczanych umiejętności zatrzymuje się na 20 transakcjach na wywołanie indeksatora, a komunikat "Przekroczenie limitu czasu" pojawia się w historii wykonywania indeksatora.

Zaloguj się w witrynie Azure Portal.
Utwórz zasób wielosób usługi Azure AI w tym samym regionie co usługa wyszukiwania.
Pobierz klucz zasobu ze strony Klucze zasobów>i punkt końcowy .
Dodaj klucz do definicji zestawu umiejętności:
- W przypadku korzystania z kreatora importu danych utwórz lub wybierz konto usługi Azure AI. Kreator dodaje klucz zasobu do definicji zestawu umiejętności.
- W przypadku nowego lub istniejącego zestawu umiejętności podaj klucz w definicji zestawu umiejętności.

Uwaga

Witryna Azure Portal obecnie automatycznie dołącza klucz typu #Microsoft.Azure.Search.CognitiveServicesByKey.

Użyj interfejsu API tworzenia lub aktualizowania zestawu umiejętności, określając cognitiveServices sekcję w treści żądania:

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

Poniższy fragment kodu pochodzi z pliku azure-search-dotnet-samples, przyciętego do zwięzłości.

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ć usług Azure AI, postępuj zgodnie z tymi instrukcjami, aby usunąć klucz wielosługowy i uniemożliwić korzystanie z zasobu zewnętrznego. 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 "Przekroczenie limitu czasu" pojawia się w historii wykonywania indeksatora, gdy alokacja jest używana.

Witryna Azure Portal
REST

Zaloguj się w witrynie Azure Portal.
W obszarze Zestawy umiejętności zarządzania wyszukiwaniem > wybierz zestaw umiejętności z listy.
Przewiń do sekcji w pliku zawierającym "cognitiveServices".
Usuń wartość klucza z formatu JSON i zapisz zestaw umiejętności.

Uzyskaj zestaw umiejętności, aby mieć pełną definicję.
Sformułuj żądanie zestawu umiejętności aktualizacji, podając definicję JSON zestawu umiejętności.

Usuń klucz w treści definicji, a następnie wyślij żądanie:

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

Alternatywnie można ustawić wartość "cognitiveServices" na wartość null:

"cognitiveServices": null,

Sposób użycia klucza

Rozliczenia obowiązują, gdy wywołania interfejsu API do zasobów usług azure AI przekraczają 20 wywołań interfejsu API na indeksator dziennie. Indeksator można zresetować, aby zresetować liczbę interfejsów API.

Połączenia bez klucza i oparte na kluczach są używane do rozliczeń, ale nie na potrzeby połączeń operacji wzbogacania. W przypadku połączeń usługa wyszukiwania łączy się za pośrednictwem sieci wewnętrznej z zasobem usług Azure AI 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 azure AI, takie jak Język. Jeśli spróbujesz wzbogacić sztuczną inteligencję w regionie, który nie ma obu usług, zobaczysz następujący komunikat: "Podany klucz nie jest prawidłowym kluczem typu CognitiveServices dla regionu usługi wyszukiwania".

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 środowiska prywatnego wykonywania, usługa Azure AI Search nadal używa jej wewnętrznie aprowizowania zasobu wielousługowego usługi Azure AI do wykonywania wszystkich wzbogacań umiejętności.

Uwaga

Niektóre wbudowane umiejętności są oparte na usługach sztucznej inteligencji platformy Azure innych niż regionalna (na przykład umiejętności tłumaczenia tekstu). Użycie umiejętności nieregionalnej oznacza, że żądanie może być obsługiwane w regionie innym niż region usługi Azure AI Search. Aby uzyskać więcej informacji na temat usług innych niż regionalne, zobacz stronę Produktów usług azure AI według regionów .

Wymagania dotyczące połączenia publicznego

W zależności od tego, kiedy usługa wyszukiwania została utworzona, a jej warstwa i region, rozliczenia dla wbudowanych umiejętności mogą wymagać publicznego połączenia z usługi Azure AI Search do wielu usług Azure AI. 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żywać sieci publicznej, możesz skonfigurować niestandardową umiejętność internetowego interfejsu API zaimplementowaną za pomocą funkcji platformy Azure obsługującej prywatne punkty końcowe i dodać zasób usług Azure AI do tej samej sieci wirtualnej. W ten sposób można wywołać zasób usług Azure AI bezpośrednio z poziomu niestandardowej umiejętności przy użyciu prywatnych punktów końcowych.

Kluczowe wymagania specjalne

Wyszukiwanie jednostek niestandardowych jest mierzone przez usługę Azure AI Search, a nie przez usługi Azure AI, ale wymaga klucza zasobu wielousługowego azure AI 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 sztucznej inteligencji oferuje niewielką ilość bezpłatnego przetwarzania rozliczanych wzbogaceń, dzięki czemu można wykonać krótkie ćwiczenia bez konieczności dołączania zasobu wielosłużeniowego usługi Azure AI. Bezpłatne wzbogacania to 20 dokumentów dziennie, na indeksator. 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 nazywają usług Azure AI (czyli warunkowe, wyodrębnianie dokumentów, kształtowanie, scalanie tekstu i dzielenie 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 pękania dokumentu, nie jest wzbogacaniem sztucznej inteligencji, ale występuje podczas wzbogacania sztucznej inteligencji i dlatego jest tutaj zanotowany.

Rozliczane wzbogacania

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

Rozliczane wbudowane umiejętności, które tworzą wywołania zaplecza do usług sztucznej inteligencji platformy Azure, obejmują łączenie jednostek, rozpoznawanie jednostek, analizę obrazów, wyodrębnianie kluczowych fraz, wykrywanie języka, OCR, wykrywanie danych osobowych, wykrywanie, tonację i tłumaczenie tekstu.

Wyodrębnianie obrazów to operacja usługi Azure AI Search wykonywana w przypadku pęknięć dokumentów przed wzbogacaniem. Wyodrębnianie obrazów jest rozliczane we wszystkich warstwach, z wyjątkiem 20 bezpłatnych wyodrębnień dziennych w warstwie Bezpłatna. Koszty wyodrębniania obrazów dotyczą plików obrazów w obiektach blob, obrazów osadzonych w innych plikach (pdf i innych plikach aplikacji) oraz obrazów wyodrębnionych przy użyciu wyodrębniania dokumentów. Aby uzyskać cennik wyodrębniania obrazów, zobacz stronę cennika usługi Azure AI Search.

Napiwek

Aby obniżyć koszty przetwarzania zestawu umiejętności, włącz przyrostowe wzbogacanie pamięci podręcznej i ponowne używanie wszelkich wzbogacenia, które nie mają wpływu na zmiany wprowadzone w zestawie umiejętności. Buforowanie wymaga usługi Azure Storage (zobacz cennik , ale łączny koszt wykonywania zestawu umiejętności jest niższy, jeśli istniejące wzbogacania mogą być ponownie używane, szczególnie w przypadku zestawów umiejętności korzystających z wyodrębniania i analizy obrazów).

Przykład: Szacowanie kosztów

Aby oszacować koszty związane z indeksowaniem usługi Azure AI Search, zacznij od pojęcia, jak wygląda przeciętny dokument, aby można było uruchomić kilka liczb. Możesz na przykład przybliżyć następujące elementy:

1000 plików PDF.
Każda z nich to sześć stron.
Jeden obraz na stronę (6000 obrazów).
3000 znaków na stronę.

Załóżmy, że potok składa się z pęknięć dokumentów każdego pliku PDF, wyodrębniania obrazów i tekstu, optycznego rozpoznawania znaków (OCR) obrazów i rozpoznawania jednostek organizacji.

Ceny przedstawione w tym artykule są hipotetyczne. Są one używane do zilustrowania procesu szacowania. Koszty mogą być niższe. Aby uzyskać rzeczywistą cenę transakcji, zobacz Cennik usług azure AI.

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.
W przypadku rozpoznawania znaków OCR z 6000 obrazów w języku angielskim umiejętności poznawcze OCR używają najlepszego algorytmu (DescribeText). Zakładając, że koszt 2,50 USD za 1000 obrazów do przeanalizowania, zapłacisz za ten krok 15,00 USD.
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 pozyskać 1000 dokumentów PDF tego typu z opisanym zestawem umiejętności.

Udostępnij za pośrednictwem

Dołączanie zasobu wielosób usługi Azure AI do zestawu umiejętności w usłudze Azure AI Search

Wymagania wstępne

Rozliczanie za pośrednictwem połączenia bez klucza

Przykład: tożsamość zarządzana przypisana przez system

Przykład: tożsamość zarządzana przypisana przez użytkownika

Rozliczanie za pomocą klucza zasobu

Usuwanie klucza

Sposób użycia klucza

Wymagania dotyczące połączenia publicznego

Kluczowe wymagania specjalne

Bezpłatne wzbogacania

Rozliczane wzbogacania

Przykład: Szacowanie kosztów

Następne kroki

Opinia

Dodatkowe zasoby