Verschieben des Foundry IQ (Azure KI-Suche)-Diensts in eine andere Azure-Region

Hinweis

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.

Gelegentlich fragen Kunden nach dem Verschieben eines Foundry IQ Service in eine andere Region. Derzeit gibt es keinen integrierten Mechanismus oder Tools, um diese Aufgabe zu unterstützen, aber dieser Artikel kann Ihnen helfen, die manuellen Schritte zum Neuerstellen von Indizes und anderen Objekten in einem neuen Foundry IQ-Dienst in einer anderen Region zu verstehen.

Hinweis

Im Azure-Portal verfügen alle Dienste über einen Befehl zum Exportieren von Vorlagen. Im Falle von Foundry IQ (Azure KI-Suche) erzeugt dieser Befehl eine grundlegende Definition eines Diensts (Name, Standort, Ebene, Replikat und Partitionsanzahl), erkennt jedoch nicht den Inhalt Ihres Diensts und führt auch keine Schlüssel, Rollen oder Protokolle durch. Obwohl der Befehl vorhanden ist, wird nicht empfohlen, ihn zum Verschieben eines Foundry IQ-Diensts zu verwenden.

Voraussetzungen

  • Stellen Sie sicher, dass die Dienste und Features, die von Ihrem Konto verwendet werden, in der Zielregion unterstützt werden.

  • Stellen Sie für Previewfunktionen sicher, dass Ihr Abonnement für die Zielregion genehmigt ist.

Vorbereiten und Verschieben

  1. Identifizieren Sie Abhängigkeiten und zugehörige Dienste, um die vollständigen Auswirkungen der Umverteilung eines Diensts zu verstehen, falls Sie mehr als nur Foundry IQ verschieben müssen.

    Azure Storage wird für die Protokollierung und zum Erstellen eines Wissensspeichers verwendet und dient häufig als externe Datenquelle für KI-Anreicherung und Indizierung. Foundry Tools werden verwendet, um integrierte Fähigkeiten während der KI-Anreicherung zu nutzen. Sowohl Foundry Tools als auch Ihr Foundry IQ Service müssen sich in derselben Region befinden, wenn Sie KI-Anreicherung verwenden.

  2. Erstellen Sie eine Inventur aller Objekte im Dienst, damit Sie wissen, was verschoben werden muss: Indizes, Synonymzuordnungen, Indexer, Datenquellen, Skillsets. Wenn Sie die Protokollierung aktiviert haben, erstellen und archivieren Sie die Berichte, die Sie möglicherweise für einen historischen Datensatz benötigen.

  3. Überprüfen Sie die Preise und Verfügbarkeit in der neuen Region, um die Verfügbarkeit von Foundry IQ sowie alle zugehörigen Dienstleistungen in der neuen Region sicherzustellen. Die meisten Features sind in allen Regionen verfügbar, einige Previewfunktionen weisen jedoch eine eingeschränkte Verfügbarkeit auf.

  4. Exportieren Sie Nichtsecret-Ressourcendefinitionen und prüfen Sie sie auf geschwärzte Werte und ausgelassene Anmeldeinformationen, die nur zum Schreiben bestimmt sind. GET- und LIST-Ausgabe ist keine Sicherung von Secrets oder notwendigerweise eine erstellungsbereite Definition. Befolgen Sie Sichern, Wiederherstellen oder Klonen eines Indexes, bevor Sie exportierte JSON-Dateien wiederverwenden.

  5. Erstellen Sie einen Dienst in der neuen Region. Dienstnamen müssen eindeutig sein, sodass Sie den vorhandenen Namen nicht wiederverwenden können. Erstellen Sie die erforderlichen verwalteten Identitäten, Rollenzuweisungen, private Konnektivität, Endpunktrichtlinien, vom Kunden verwalteten Schlüsselzugriff, externe Verbindungen und die Gatewaykonfiguration erneut. Ein neuer Dienst erbt die Autorisierung des Quelldiensts nicht.

  6. Rufen Sie die Zielanmeldeinformationen sicher ab, oder konfigurieren Sie die unterstützte verwaltete Identitätsauthentifizierung. Fügen Sie erforderliche geheime Werte im Client ein, bevor Sie Indizes, Synonymzuordnungen, Datenquellen, Skillsets und Indexer in Abhängigkeitsreihenfolge erstellen. Übermitteln Sie <unchanged> oder <redacted> nicht als neue Anmeldeinformationen. Überprüfen Sie die Verbindungen der Foundry Tools hinsichtlich der Anforderung, dieselbe Region zu verwenden, und aktualisieren Sie die Verbindungszeichenfolgen für den Wissensspeicher für das Zielspeicherkonto.

  7. Überprüfen Sie das Zielmodell und benutzerdefinierte API-Verbindungen vor dem Laden von Dokumenten. Stellen Sie keine ungültige Platzhalterressource bereit und verlassen Sie sich auf eine spätere Reparatur.

  8. Laden Sie Indizes und Wissensspeicher ggf. neu. Entweder verwenden Sie den Anwendungscode, um JSON-Daten in einen Index zu pushen, oder Sie führen die Indexer erneut aus, um Dokumente aus externen Quellen zu pullen.

  9. Protokollierung aktivieren.

  10. Aktualisieren Sie Clientanwendungen und Testsammlungen, sodass sie den neuen Dienstnamen und die API-Schlüssel verwenden, und testen Sie alle Anwendungen.

Verwerfen oder Bereinigen

Löschen Sie den alten Dienst, wenn der neue Dienst vollständig getestet und einsatzbereit ist. Wenn Sie den Dienst löschen, werden automatisch alle dem Dienst zugeordneten Inhalte gelöscht.

Nächste Schritte

Anhand der folgenden Links finden Sie weitere Informationen, wenn Sie die oben beschriebenen Schritte ausführen.