Verfügbarmachen von Schrägstrichbefehlen aus Agents und Apps

Mit Schrägstrichbefehlen können Benutzer benannte Befehlsfunktionen in Teams-Agents und -Apps ermitteln und verwenden.

Wenn Ihr Agent oder Ihre App über Funktionen verfügt, die Benutzer mit benannten Befehlen aufrufen können, können Sie eine Konfiguration hinzufügen, die diese Befehle über das Feld zum Verfassen von Nachrichten in Teams schnell auffindbar und zugänglich macht. Benannte Schrägstrichbefehle können Benutzern dabei helfen, auf Anleitungen zuzugreifen, persönliche Nachverfolgungsaufgaben zu erstellen oder Personalisierungsoptionen zu verwalten.

Verwendung durch den Benutzer

Schrägstrichbefehle in Teams sind textbasierte Tastenkombinationen, mit denen Benutzer Aktionen aus dem Feld "Verfassen" in Unterhaltungen ausführen können. Wenn ein Benutzer ein in ein / leeres Verfassenfeld eingibt, zeigt Teams ein AutoVervollständigen-Menü mit integrierten Befehlen für allgemeine Aufgaben an, die von Agents oder Apps im aktuellen Kontext verfügbar gemacht werden.

Mit dem Feature "Schrägstrichbefehle" können Apps und Agents dieser Liste eigene Befehle hinzufügen, damit Benutzer sie erkennen und verwenden können.

Schrägstrichbefehle

Apps und Agents können Oberflächen mit Schrägstrichbefehlen über die App- oder Agent-Konfiguration auf zwei primäre Arten verfügbar machen:

• Agent-Schrägstrichbefehle: Benannte Surface-Befehle für Benutzer im Menü "AutoVervollständigen" des Befehls "Slash".
• Schrägstrichbefehle für Nachrichtenerweiterungen: Ermöglichen Sie Benutzern das Aktivieren der Nachrichtenerweiterungen Ihrer App oder ihres Agents mit einem Schrägstrichbefehl.

Diese Arten von Schrägstrichbefehlen werden auf allen Clientplattformen, einschließlich mobiler Geräte, unterstützt.

Agent-Schrägstrichbefehle

Agent-Schrägstrichbefehle ermöglichen es Agents, benannte Befehle anzuzeigen, die Benutzer privat in Kanälen, Gruppenchats und Besprechungschats aufrufen können. Schrägstrichbefehle sind nützlich für Funktionen, auf die Benutzer in Gruppenunterhaltungen schnell und privat zugreifen müssen.

In Kanälen, Gruppenchats und Besprechungschats enthält das AutoVervollständigen-Menü des Schrägstrichbefehls alle Befehle, die von Agents in der aktuellen Unterhaltung registriert wurden. Jeder Befehl wird mit seiner Beschreibung und dem Namen und Symbol des Agents angezeigt, sodass er auffindbar ist und zwischen Befehlen mit demselben Namen unterscheidet.

Wenn Sie einen Befehl über das Menü aufrufen, wird das Feld zum Verfassen in den Nachrichtenmodus für den Agent umgeschaltet, und der Name des Befehls wird als Nachrichtentext eingefügt. Wenn Sie Senden auswählen , wird die Zielnachricht an den Agent gesendet. Beispielsweise kann ein Projektverwaltungs-Agent oder eine Bot-App Befehle verfügbar machen, z /create-task . B. zum Umwandeln der aktuellen Konversation in eine nachverfolgte Aufgabe basierend auf dem Kontext, oder /status-check ein Befehl, dem eine Arbeitselementnummer zugewiesen werden kann und Informationen dazu zurückgibt.

Schrägstrichbefehle für Nachrichtenerweiterungen mit Aktionstyp

Apps, die Nachrichtenerweiterungen mit Aktionstyp implementieren, können diese Aktionen als Schrägstrichbefehle verfügbar machen. Wenn ein Benutzer eins aus dem AutoVervollständigen-Menü auswählt, öffnet Teams das zugeordnete Aufgabenmodul oder Dialogfeld. Wenn Sie einen Befehl für den Schrägstrich der Nachrichtenerweiterung aktivieren, wird nur das Modul oder Dialogfeld geöffnet. Es wird keine Nachricht gesendet. Nachrichtenerweiterungen vom Suchtyp können nicht als Schrägstrichbefehle verfügbar gemacht werden.

Schrägstrichbefehle für Nachrichtenerweiterungen können so konfiguriert werden, dass sie sowohl im Feld zum Verfassen als auch im Teams-Befehlsfeld als AutoVervollständigen-Einträge angezeigt werden.

Erwähnen von Befehlen in Agents

Verwenden Sie @mention Befehle in Ihren Agents und Apps, wenn Benutzer einen bestimmten Agent oder Bot direkt ansprechen müssen. Die Nachricht wird an den genannten Agent übermittelt, und der Agent antwortet entsprechend dem Konversationskontext. Beispielsweise kann @mention ein Benutzer einen Projektverwaltungs-Agent in einem Kanal eingeben und zuweisen eingeben, um eine Folgeaufgabe aus dem Unterhaltungskontext zu erstellen.

Weitere Informationen zu @mention Befehlen finden Sie unter @Mention.

Hinzufügen von Befehlen

Schrägstrichbefehle und zielorientiertes Messaging werden im App- oder Agent-Manifest konfiguriert. Durch das Deklarieren von Befehlen im Manifest werden Befehle in Teams sichtbar, während die App- oder Agent-Implementierung bestimmt, wie die einzelnen Befehle behandelt werden, nachdem der Benutzer ihn gesendet hat.

Schrägstrich und @mention Befehle für Agents

Schrägstriche und @mention Befehle erfordern, dass ein Agent sich für den Empfang von Zielnachrichten anmeldet. Weitere Informationen finden Sie unter Empfangen von Zielnachrichten.

Trigger: Schrägstrich und @mention

Die triggers -Eigenschaft definiert, wo ein Befehl angezeigt wird und wie Benutzer ihn über die Teams-Erstellungsumgebung aufrufen können. Verwenden Sie mention für Agent-Befehlslisten, wenn der Befehl im herkömmlichen @mention Befehlsmenü angezeigt werden soll, verwenden Sie slash , wenn der Befehl in der Schrägstrichbefehlsauswahl angezeigt werden soll, oder schließen Sie beide Werte ein, wenn derselbe Befehl von beiden Einstiegspunkten aus verfügbar sein soll.

Deklarieren Sie Befehle und ihre Trigger, indem Sie den bots[].commandLists[] Abschnitt des Manifests konfigurieren. Das folgende Manifestbeispiel zeigt einen Agent, der Zielnachrichten unterstützt und drei Befehle über Schrägstriche, Erwähnung und kombinierte Trigger verfügbar macht:

{
  "bots": [
    {
      "botId": "{{BOT_ID}}",
      "scopes": ["personal", "team", "groupChat"],
      "supportsTargetedMessages": true,
      "commandLists": [
        {
          "scopes": ["personal", "team", "groupChat"],
          "triggers": ["slash"],
          "commands": [
            {
              "title": "summarize",
              "description": "Summarize the conversation"
            }
          ]
        },
        {
          "scopes": ["personal", "team", "groupChat"],
          "triggers": ["mention"],
          "commands": [
            {
              "title": "assign",
              "description": "Assign a follow-up task"
            }
          ]
        },
        {
          "scopes": ["personal", "team", "groupChat"],
          "triggers": ["slash", "mention"],
          "commands": [
            {
              "title": "review",
              "description": "Review a document"
            }
          ]
        }
      ]
    }
  ]
}

• Wie für Schrägstrichbefehle erforderlich, dieser Beispielcodeausschnitt:

• supportsTargetedMessages ist auf true festgelegt, damit der Agent Gezielte Nachrichten in Gruppenunterhaltungen empfangen kann.
• summarize ist als Schrägstrichbefehl konfiguriert.
• assign ist als @mention Befehl konfiguriert.
• review wird sowohl als Schrägstrichbefehl als auch als @mention Befehl konfiguriert.

Schrägstrichbefehle für Nachrichtenerweiterungen mit Aktionstyp

Verwenden Sie die triggers -Eigenschaft von composeExtensions[].commands[] , um Nachrichtenerweiterungen als Schrägstrichbefehle verfügbar zu machen.

{
    "composeExtensions": [
        {
            "botId": "{{BOT_ID}}",
            "commands": [
                {
                    "id": "summarizeCommand",
                    "type": "action",
                    "title": "Summarize",
                    "description": "Summarize a document",
                    "context": ["compose", "commandBox"]
                },
                {
                    "id": "draftCommand",
                    "type": "action",
                    "title": "Draft",
                    "description": "Draft a document",
                    "context": ["compose", "commandBox"],
                    "triggers": ["slash"]
                },
                {
                    "id": "reviewCommand",
                    "type": "action",
                    "title": "Review",
                    "description": "Review a document",
                    "context": ["compose", "commandBox"],
                    "triggers": ["slash"]
                }
            ]
        }
    ]
}

In diesem Beispiel ist in den konfigurierten Kontexten zum Verfassen und Befehlsfeld verfügbar, summarizeCommand wird aber nicht als Schrägstrichbefehl verfügbar gemacht. Die draftCommand Aktionen und reviewCommand deklarieren den Schrägstrichtrigger, sodass sie in unterstützten Einstiegspunkten als Schrägstrichbefehle angezeigt werden.

Implementieren der agent-benannten Befehlsverarbeitung

Wenn Sie Agent-Schrägstrichbefehle konfigurieren, werden sie nur benutzern im Teams-Client angezeigt. Dies hilft nicht bei derEn Implementierung.

Wenn ein Benutzer einen Agent-Schrägstrichbefehl aktiviert, wechselt Teams das Feld zum Verfassen in den Zielnachrichtenmodus und fügt den Befehlsnamen ein. Anschließend wird die Steuerung an den Benutzer zurückgegeben, damit er mehr Text eingeben und die Nachricht senden kann. Der Nachrichtenhandler des Agents ist dafür verantwortlich, den Inhalt der Nachricht zu verwenden, um zu bestimmen, ob sie als Befehlsaufruf interpretiert werden soll, und sie entsprechend zu behandeln.

Weitere Anleitungen zur Nachrichtenverarbeitung finden Sie unter Bewährte Methoden und Entwurfsanleitungen .

Bewährte Methoden und Entwurfsanleitungen

Wählen Sie den Trigger aus, der dem Aufruf des Befehls durch Benutzer entspricht. Bieten Sie Schrägstrichbefehle für allgemeine Aktionen, auf die Benutzer schnell, wiederholt und privat zugreifen müssen. Sie eignen sich am besten für benutzerspezifische Aktionen, z. B. das Anzeigen von Einstellungen, das Erstellen von Folgeaufgaben oder das Überprüfen persönlicher status, insbesondere wenn Benutzer davon profitieren, die Aktion über das Verfassenfeld zu entdecken und wiederzuverwenden. Verwenden Sie einen @Erwähnung-Befehl, wenn Benutzer einen bestimmten Agent adressieren oder sich auf den Konversationskontext verlassen müssen. Bieten Sie beides nur an, wenn jeder ein natürlicher Einstiegspunkt für dasselbe Verhalten ist.

Wie bei allen nachrichtenbasierten Aktivitäten sollte beim Entwurf von Schrägstrichbefehlsverhalten sorgfältig geprüft werden, ob der Benutzer eine öffentliche oder private Nachricht als Antwort in Gruppenunterhaltungen erwartet. Allgemeine Anleitungen zur Sichtbarkeit von Agent-Antworten finden Sie unter Bewährte Methoden für gezieltes Messaging und Entwurfsleitfaden.

Halten Sie den Befehlssatz klein und fokussiert. Unterstützen Sie Eingabeaufforderungen in natürlicher Sprache, wenn Benutzer eine bessere Konversation benötigen, aber reservieren Sie Schrägstrichbefehle für die meisten wiederholbaren Aktionen.

Halten Sie Die Namen von Befehlen mit Schrägstrich kurz und aktionsorientiert. Verwenden Sie Aliase für Befehle mit hoher Häufigkeit, wenn sie die Auffindbarkeit verbessern, und verwenden Sie Eingabeaufforderungsstarter für längere oder mehr offene Eingabeaufforderungen.

Stellen Sie klare Befehlsbeschreibungen bereit, um die Auffindbarkeit zu verbessern, einschließlich aller erwarteten Eingaben, die über den Befehlsnamen hinausgehen.

Verwandte Inhalte

• Senden und Empfangen von Gezieltnachrichten in Gruppenunterhaltungen
• Eingabeaufforderungsstarter
• Erstellen von Nachrichtenerweiterungen