Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Użyj właściwości usługi knowledgeRetrieval, aby wybrać bezpłatny lub standardowy plan rozliczeniowy na potrzeby wyszukiwania agentowego. Ten plan jest oddzielony od warstwy cenowej usługi IQ rozwiązania Foundry. Nowe usługi Foundry IQ domyślnie są objęte planem bezpłatnym, który zapewnia miesięczny limit tokenów na potrzeby rozumowania związanego z wyszukiwaniem agentowym bez dodatkowych opłat. Przejdź do planu standardowego, aby włączyć płatne korzystanie z funkcji pobierania.
Od wersji 2026-04-01 interfejsu API REST usługi Search Service zgoda na naliczanie opłat za klasyfikator semantyczny i wyszukiwanie agentowe jest oddzielna. Aby kontrolować płatne użytkowanie agentic retrieval niezależnie od knowledgeRetrieval, należy używać semanticSearch.
Wymagania wstępne
Usługa Foundry IQ w obsługiwanym regionie i w obsługiwanej warstwie cenowej, zgodnie z opisem w temacie Plany rozliczeniowe.
Uprawnienie do aktualizowania usługi Foundry IQ za pomocą
Microsoft.Search/searchServices/write. Wbudowane role, takie jak Właściciel i Współautor , zapewniają to uprawnienie. Aby uzyskać więcej informacji, zobacz Kontrola dostępu oparta na rolach.Interfejs API REST zarządzania wyszukiwaniem w wersji 2026-03-01-preview lub nowszej, do ustawienia właściwości
knowledgeRetrieval.
Podział płatności
Ustawianie zgody na rozliczenia przy użyciu obsługiwanej wersji interfejsu API REST usługi Search Management. W poniższej tabeli przedstawiono, która właściwość ma zastosowanie na podstawie wersji interfejsu API REST usługi wyszukiwania w żądaniu pobierania danych.
| Wersja REST API interfejsu usługi wyszukiwania | Rozliczanie rangi semantycznej | Rozliczenia za pobieranie przez agenta |
|---|---|---|
2026-04-01 i później |
Kontrolowane przez semanticSearch |
Kontrolowane przez knowledgeRetrieval |
2025-11-01-preview i wcześniejsze |
Kontrolowane przez semanticSearch |
Kontrolowane przez semanticSearch |
W przypadku wersji interfejsu API REST usługi Search Service 2026-04-01 i nowszych knowledgeRetrieval steruje rozliczaniem wyszukiwania agentowego niezależnie od semanticSearch. Aby kontrolować rozliczenia rangera semantycznego, zobacz Włączanie lub wyłączanie rozliczeń rangera semantycznego.
W przypadku wersji 2025-11-01-preview interfejsu API REST usługi Search i wcześniejszych element semanticSearch kontroluje zgodę zarówno na użycie rankera semantycznego, jak i na płatne korzystanie z wyszukiwania agentowego. Właściwość knowledgeRetrieval jest ignorowana.
Plany rozliczeniowe
Właściwość knowledgeRetrieval obsługuje dwa plany rozliczeniowe: free i standard. Żaden plan nie zmienia poziomu cenowego usługi. Aby zapoznać się z bieżącymi stawkami i przydziałami, zobacz Cennik Foundry IQ.
| Plan | Opis | Availability |
|---|---|---|
| Bezpłatna (domyślna) | Zapewnia miesięczny zasiłek tokenowy bez opłat. Po zużyciu bezpłatnego limitu żądania, które wiązałyby się z płatnym użyciem, zwracają błąd HTTP 402 (wymagana płatność). | W zależności od obsługiwanych warstw usługi i regionów. |
| Standard | Płatność zgodnie z rzeczywistym użyciem po wyczerpaniu miesięcznego bezpłatnego przydziału. | Wymaga obsługiwanej jednostki SKU. |
Aktywuj agentowe rozliczenia pobierania
Ważne
Jeśli wcześniej korzystano z semanticSearch, aby włączyć płatne korzystanie z wyszukiwania agentowego, przed migracją obciążeń związanych z wyszukiwaniem agentowym do interfejsu API REST usługi Search w wersji standard lub nowszej należy jawnie ustawić 2026-04-01 na knowledgeRetrieval.
Wykonaj następujące kroki, aby przełączyć agentowe pobieranie danych na standardowy plan rozliczeniowy.
Przejdź do usługi IQ usługi Foundry w portalu Azure.
Na stronie Przegląd upewnij się, że warstwa cenowa to Podstawowa lub nowsza.
W okienku po lewej stronie wybierz pozycję Ustawienia>Funkcje Premium.
W obszarze Pobieranie wiedzy wybierz pozycję Wybierz plan na karcie Standardowa .
Wyłączanie rozliczeń za agentowe pozyskiwanie danych
Wykonaj następujące kroki, aby przełączyć agentyczne odzyskiwanie z powrotem do bezpłatnego pakietu rozliczeniowego. Plan bezpłatny dotyczy wyłącznie rozumowania w funkcji agentic retrieval.
Przejdź do usługi Foundry IQ w portalu Azure.
W okienku po lewej stronie wybierz pozycję Ustawienia>Funkcje Premium.
W obszarze Pobieranie wiedzy wybierz pozycję Wybierz plan na karcie Bezpłatna .