Erstellen Security Copilot Agents mithilfe von YAML

Dieser Artikel enthält allgemeine Anleitungen für Entwickler zum Erstellen und Hochladen Ihrer YAML-Manifestdatei zum Erstellen eines Agents.

Informationen zum Ausprobieren der YAML-Beispiele finden Sie unter Beispielsammlungen.

Schritte zum Erstellen und Hochladen von YAML

Als Entwickler sind die von Ihnen erstellten Agent-Definitionen für die Sicherheitsanalysten verfügbar, um die Ergebnisse anzuzeigen.

Um Ihr Agentmanifest zu erstellen, verweisen Sie auf die Attribute im Manifest, siehe Agentmanifest. Sie können das Manifest mithilfe des bereitgestellten Beispiels erstellen.

Wenn Sie selbst einen Agent erstellen, führen Sie die folgenden Schritte aus, um das YAML zu erstellen und hochzuladen.

Schritt 1: Erstellen eines Tools (Skill)

1. Erstellen Sie eine Datei namens http_manifest.yaml.

2. Sie können jedes der vordefinierten Tools wie API, , KQLGPToder AGENThinzufügen.

• Für Format: GPT, API, KQL

  • Unter Skills: Definieren Sie Name, Beschreibung, Eingaben (falls vorhanden), Einstellungen.

• Für Format: AGENT

  • Geben Sie weitere Details an, z. B.:
    1. Anweisungen : Sie können Anweisungen in natürlicher Sprache (Natural Language, NL) hinzufügen, um zu veranworten, wie der Agent Aufgaben ausführen soll.
    2. Untergeordnete Skills (optional): Sie können die Fähigkeiten definieren, die der Agent zum Lösen Ihrer Geschäftslogik verwenden kann. Bei Definition verwendet der Agent die liste der in diesem Abschnitt definierten Qualifikationen, um einen dynamischen Plan zu erstellen und auszuführen.

Weitere Informationen finden Sie im Manifestabschnitt unter Format und Einstellungen.

Schritt 2: Hochladen des YAML als benutzerdefiniertes Plug-In

Nachdem Sie Ihrem YAML ein benutzerdefiniertes Plug-In hinzugefügt haben, müssen Sie die Datei hochladen.

1. Wählen Sie das Symbol Security Copilot Quellen aus.

2. Scrollen Sie unter Plug-Ins verwalten nach unten zum Abschnitt Benutzerdefiniert.

   

3. Wählen Sie Plug-In hochladen aus.

4. Geben Sie in den Dropdownoptionen an, ob Sie das Plug-In nur für sich selbst oder für andere Personen im organization verfügbar machen möchten. Wählen Sie dann zwischen dem Hinzufügen eines Security Copilot-Plug-Ins oder eines OpenAI-Plug-Ins.

   

   Hinweis

   Wenn Sie ein Plug-In nur für sich selbst zur Verfügung stellen möchten, wird dem Plug-In ein privates Tag hinzugefügt. Wenn Sie die Option auswählen, es für alle Benutzer im organization verfügbar zu machen, steht das Plug-In allen Security Copilot Benutzern zur Verfügung.

5. Führen Sie je nach Plug-In, das Sie hinzufügen möchten, die entsprechenden Schritte aus:

   • Security Copilot-Plug-In
   • OpenAI-Plug-In

   1. Wählen Sie Security Copilot-Plug-In aus.

   2. Sie können wählen, ob Sie eine Datei oder als Link hochladen möchten.

      • So laden Sie eine Datei hoch:

        1. Wählen Sie den Abschnitt Datei hochladen aus.
        2. Wählen Sie die Datei aus, die hochgeladen werden soll, und wählen Sie dann Hinzufügen aus.

      • So laden Sie einen Link hoch:

        1. Aktivieren Sie die Umschaltfläche Als Link hochladen.
        2. Fügen Sie einen Link zu einer YAML- oder JSON-Datei ein.
        3. Geben Sie den Dateityp an.
        4. Wählen Sie Hinzufügen.

6. Nachdem das Plug-In erfolgreich hinzugefügt wurde, müssen möglicherweise einige Plug-Ins eingerichtet werden. Sie können das Plug-In auch später einrichten.

7. Geben Sie die entsprechenden Werte für die Einstellungsfelder an, und wählen Sie dann Einrichten aus.

   • Nach Abschluss der Einrichtungsschritte wird Ihr Plug-In im Abschnitt „Benutzerdefiniert“ angezeigt.
   • Wählen Sie unten auf dem Bildschirm die Option Mehr anzeigen aus.
   • Scrollen Sie nach unten, um Ihr Plug-In zu finden.
   • Sie müssen die Umschaltfläche aktivieren.
   • Sie können das Dialogfeld Quellen verwalten schließen.

Schritt 3: Überprüfen der Berechtigungen

Security Copilot Rolle steuert, auf welche Aktivitäten Sie auf der Plattform Zugriff haben, z. B. Konfigurieren von Einstellungen, Zuweisen von Berechtigungen und Ausführen von Aufgaben. Security Copilot Rollen werden in Copilot definiert und verwaltet und gewähren nur Zugriff auf Security Copilot Features. Ausführliche Informationen zu Berechtigungen finden Sie unter Berechtigungen.

Schritt 4: Ermitteln und Einrichten/Konfiguration des Agents

Um Agents in Security Copilot zu ermitteln, müssen Sie nach dem im DisplayName Feld angegebenen Wert aus dem Manifest suchen.

Ein Admin- oder Copilot-Besitzer hat die Möglichkeit, Agents für den Arbeitsbereich einzurichten, zu konfigurieren und zu aktivieren, sofern noch nicht installiert.

Schritt 5: Testen des Plug-Ins (Agent)

Die einfachste Möglichkeit zum Testen des Agents besteht darin, ihn wie folgt über die Systemfunktionen aufzurufen:

• Wenn Sie beim Produkt angemeldet sind, wählen Sie oben links im Navigationsmenü > Start den Link Microsoft Security Copilot aus.

• Wählen Sie in der Eingabeaufforderungsleiste "Wie kann Security Copilot helfen?" Prompts aus.

• Navigieren Sie zu Alle Systemfunktionen anzeigen.

• Verwenden Sie die Suchleiste, um Ihr Plug-In zu suchen und auszuwählen. Dadurch wird die Suchleiste mit dem Namen des Agents und den Eingabeparametern ausgefüllt.

• Wählen Sie Eingabeaufforderung absenden aus. Dadurch wird der Agent ausgeführt (es dauert wahrscheinlich etwa 30 bis 45 Sekunden).

• In der Antwort sollten die Ergebnisse angezeigt werden.

• Sie können überprüfen, ob der Agent seine Funktionsaufrufschleife ausgeführt hat, indem Sie oben rechts auf dem Bildschirm auf die Schaltfläche Agent-Ansicht klicken. Dadurch wird eine Entscheidungsstruktur angezeigt, die der Agent zum Abschließen der Aufgabe verwendet hat.

Nächste Schritte

• Erstellen des Agents mithilfe der API