Aktivieren oder Deaktivieren der Agent-Abrufabrechnung

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Verwenden Sie die knowledgeRetrieval Diensteigenschaft, um den kostenlosen oder standardmäßigen Abrechnungsplan für den agentischen Abruf auszuwählen. Dieser Plan ist getrennt vom Preisniveau Ihres Foundry IQ-Diensts. Neue Foundry IQ-Dienste sind standardmäßig auf den kostenlosen Plan eingestellt, der ein monatliches Token-Kontingent für agentenbasierte Retrieval-Begründung ohne Gebühr bereitstellt. Wechseln Sie zum Standardplan, um die Nutzung kostenpflichtiger Abrufe zu aktivieren.

Ab der REST-API-Version 2026-04-01 des Suchdiensts ist die Zustimmung zur Abrechnung für semantisches Ranking und agentischen Abruf getrennt. Verwenden Sie knowledgeRetrieval, um die kostenpflichtige agentengesteuerte Nutzung unabhängig von semanticSearch zu kontrollieren.

Voraussetzungen

  • Ein Foundry IQ-Service in einer unterstützten Region und auf einem unterstützten Preisniveau, wie in Abrechnungsplänen beschrieben.

  • Berechtigung zum Aktualisieren des Foundry IQ-Diensts über Microsoft.Search/searchServices/write. Integrierte Rollen wie Besitzer und Mitwirkender gewähren diese Berechtigung. Weitere Informationen finden Sie unter Rollenbasierte Zugriffskontrolle.

  • Search Management REST API Version 2026-03-01-preview oder höher, um die knowledgeRetrieval Eigenschaft festzulegen.

Aufteilung der Abrechnung

Legen Sie die Abrechnungsgenehmigung mithilfe einer unterstützten REST-API-Version der Suchverwaltung fest. Die folgende Tabelle zeigt, welche Eigenschaft basierend auf der REST-API-Version des Suchdiensts in Ihrer Abrufanforderung (Datenebene) wirksam wird.

API-Version des Suchdienstes Abrechnung des semantischen Sortierers Abrechnung des Agent-Abruf
2026-04-01 und später Gesteuert von semanticSearch Gesteuert von knowledgeRetrieval
2025-11-01-preview und früher Gesteuert von semanticSearch Gesteuert von semanticSearch

Für die Search Service-REST-API-Version 2026-04-01 und höher steuert knowledgeRetrieval die Abrechnung für agentische Abrufe unabhängig von semanticSearch. Informationen zum Steuern der Abrechnung von semantischen Rangfolgern finden Sie unter Aktivieren oder Deaktivieren der Abrechnung mit semantischen Rangfolgern.

Für die REST-API-Version 2025-11-01-preview des Suchdiensts und frühere Versionen steuert semanticSearch die Zustimmung sowohl für das semantische Ranking als auch für die kostenpflichtige Nutzung des agentischen Abrufs. Die knowledgeRetrieval Eigenschaft wird ignoriert.

Abrechnungspläne

Die knowledgeRetrieval Eigenschaft unterstützt zwei Abrechnungspläne: free und standard. Keiner der beiden Pläne ändert das Preisniveau des Diensts. Aktuelle Tarife und Kontingente finden Sie unter Foundry IQ Pricing.

Plan Beschreibung Availability
Kostenlos (Standard) Stellt ein monatliches Token-Kontingent kostenlos bereit. Nachdem das kostenlose Kontingent verbraucht wurde, geben Anfragen, die eine kostenpflichtige Nutzung verursachen würden, einen HTTP-402-Fehler (Zahlung erforderlich) zurück. Abhängig von den unterstützten Serviceebenen und Regionen.
Standard Pay-as-you-go-Preise nach Nutzung des monatlichen kostenlosen Freibetrags. Erfordert eine unterstützte SKU.

Aktivieren der agentenbasierten Abrufabrechnung

Wichtig

Wenn Sie sich zuvor auf semanticSearch verlassen haben, um die kostenpflichtige Nutzung des agentischen Abrufs zu aktivieren, müssen Sie knowledgeRetrieval vor der Migration von Workloads für den agentischen Abruf zur Search Service REST-API-Version 2026-04-01 oder höher explizit auf standard setzen.

Führen Sie die folgenden Schritte aus, um die agentische Abfrage auf den Standardabrechnungsplan umzustellen.

  1. Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.

  2. Stellen Sie auf der Seite "Übersicht" sicher, dass das Preisniveau "Einfach" oder höher ist.

  3. Wählen Sie im linken Bereich "Einstellungen>Premium"-Features aus.

  4. Wählen Sie unter "Wissensabruf" die Option "Plan auswählen " auf der Standardkarte aus.

    Screenshot der Seite

Deaktivierung der Agentic-Abrufabrechnung

Führen Sie die folgenden Schritte aus, um den Agent-Abruf zurück auf den kostenlosen Abrechnungsplan zu schalten. Der kostenlose Plan gilt nur für die agentische Abruf-Schlussfolgerung.

  1. Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.

  2. Wählen Sie im linken Bereich "Einstellungen>Premium"-Features aus.

  3. Wählen Sie unter "Wissensabruf" in der kostenlosen Karte "Plan auswählen" aus.

    Screenshot der Seite „Premium-Features“ im Azure-Portal mit ausgewähltem kostenlosen Knowledge retrieval-Plan.