Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
knowledgeRetrievalEigenschaft 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.
Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.
Stellen Sie auf der Seite "Übersicht" sicher, dass das Preisniveau "Einfach" oder höher ist.
Wählen Sie im linken Bereich "Einstellungen>Premium"-Features aus.
Wählen Sie unter "Wissensabruf" die Option "Plan auswählen " auf der Standardkarte aus.
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.
Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.
Wählen Sie im linken Bereich "Einstellungen>Premium"-Features aus.
Wählen Sie unter "Wissensabruf" in der kostenlosen Karte "Plan auswählen" aus.