Foundry IQ (Azure KI-Suche)-Fähigkeiten in GitHub Copilot CLI installieren

Abfragen einer vorhandenen Wissensbasis für Foundry IQ (Azure KI-Suche) mit Zitaten und Erstellen eines Wissensdiagramms mithilfe von Foundry IQ Skills in GitHub Copilot CLI. In diesem Artikel installieren Sie das foundry-iq-skills Plug-In und verwenden seine foundry-iq Fähigkeiten mit Ihren Azure Ressourcen.

Suchen Sie die öffentliche Plug-In-Quelle in Foundry IQ Skills.

Important

Die Integration von Findry IQ Fähigkeiten für GitHub Copilot CLI befindet sich in der öffentlichen Vorschau und unterliegt den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Die für dieses Feature spezifischen Vorschaubedingungen finden Sie unter Vorschaufunktionen.

Prerequisites

  • Git, erforderlich zum Hinzufügen des Plugin-Marketplace.
  • GitHub Copilot CLI auf Windows oder Linux.
  • Python 3.12 oder höher, erforderlich für die Hilfsskripte des Plugins.
  • Eine vorhandene Wissensbasis und Zugriff auf das Azure-Abonnement und die Ressourcen der Wissensbasis.
  • Azure CLI installiert und angemeldet, um eine vorhandene Knowledge Base mit diesem Plug-In abzufragen. Verwenden Sie eine authentifizierte Azure Identität mit Berechtigungen für das angeforderte Lesen oder Ändern. Informationen zu Abfragezugriffsanforderungen finden Sie unter Voraussetzungen für den Abruf der Wissensbasis.
  • Berechtigung zum Anzeigen von Wissensbasis- und Wissensquellendefinitionen zusätzlich zum Abfragezugriff. Die Reader-Rolle kann Objektdefinitionen anzeigen. Siehe Integrierte Rollen.

Installieren des Plug-Ins

Führen Sie die Schrägstrichbefehle in GitHub Copilot CLI aus, nicht in der Shell Ihres Betriebssystems.

  1. Fügen Sie den Marketplace hinzu.

    /plugin marketplace add microsoft/azure-skills
    
  2. Installieren Sie das Plugin.

    /plugin install foundry-iq-skills@azure-skills
    

Um ein installiertes Plug-In zu aktualisieren, führen Sie diesen Befehl in Copilot CLI aus:

/plugin update foundry-iq-skills@azure-skills

Vorhandene Wissensbasis abfragen

Der Skill beginnt mit schreibgeschützten Prüfungen. Identifizieren Sie Ihre vorhandenen Ressourcen, um die Ermittlung auf diese Ressourcen zu beschränken. Das Auswählen von Ressourcen bedeutet nicht, dass sie geändert werden dürfen.

  1. Identifizieren Sie in Copilot CLI Ihren vorhandenen Foundry IQ Service und Ihre Wissensbasis. Frage: "Diese Wissensbasis mit Zitaten abfragen."

  2. Wenn die Fähigkeit fragt, ob Sie einen vorhandenen Dienst verwenden, kompatible Dienste suchen oder einen erstellen möchten, wählen Sie USE EXISTING aus. Geben Sie die vorhandenen Ressourcendetails an, die angefordert werden.

  3. Stellen Sie eine Frage zu Inhalten in der Wissensbasis.

  4. Überprüfen Sie die abgerufene Antwort und ihre Zitate für relevante Inhalte aus der Wissensbasis.

Überprüfen von Änderungs- und Bereinigungsgrenzen

Das Abfragen einer vorhandenen Knowledge Base ist ein Lesevorgang und erfordert keine Schreibgenehmigung. Andere Vorgänge können Azure Ressourcen ändern.

Bevor Sie eine Änderung genehmigen, überprüfen Sie den Plan, den der Skill anzeigt. Die Genehmigung ist erforderlich, um einen Dienst, eine Wissensquelle oder eine Wissensbasis zu erstellen, eine Wissensbasis mit einem Agenten zu verbinden oder eine andere geplante Ressourcenänderung vorzunehmen. Die Genehmigung gilt nur für den unveränderten Plan; wenn sich der Plan ändert, fragt die Fähigkeit erneut.

Behandeln Sie die Bereinigung als separaten Planungsworkflow. Für das unterstützte Löschen von Ressourcen, die vom Workflow erstellt wurden, ist eine separate Genehmigung erforderlich. Kombinieren Sie die Erstellungs- und Bereinigungsgenehmigung nicht.

Unterstützte Workflows erkennen

Über den Abruf hinaus unterstützt die Fähigkeit lokale Dateien und Azure Blob Storage oder Azure Data Lake Storage Wissensquellen, die Wissensbasiserstellung mit Abrufüberprüfung, bestehende Agentverbindungen, Diagnose und Bereinigungsplanung. Informationen zu Quellkonzepten finden Sie unter Übersicht über Wissensquellen.

Die Fähigkeit unterstützt die Verbindung einer vorhandenen Multi-Source-Wissensbasis mit einem vorhandenen Agenten, ohne die Wissensbasis zu ändern.

Troubleshooting

Wenn ein Marketplace-Registrierungs-, Installations- oder Updatebefehl einen Fehler meldet, halten Sie an, bevor Sie das Verfahren in der Wissensdatenbank ausführen. Vergewissern Sie sich, dass Sie die Schrägstrichbefehle in GitHub Copilot CLI ausführen und dass Git verfügbar ist. Installationsanleitungen finden Sie in den Installationsanweisungen des Foundry IQ Plug-Ins.