MS Forms-Agent

Diese Seite bietet Konfigurationsanweisungen für den MS Forms-Agenten, der die Integration mit Microsoft Forms zum Erstellen von Formularen und Quizzen, Verwalten von Fragen und Sammeln von Antworten ermöglicht

Übersicht

• Erstellen Sie Microsoft Forms und Quizze aus einer Eingabe in natürlicher Sprache, im Chat entworfen und erst erstellt, nachdem der Benutzer zugestimmt hat

• Fragen in einem vorhandenen Formular direkt in Blockbrain hinzufügen, ändern und entfernen

• Die Formulare des verbundenen Benutzers auflisten und übermittelte Antworten zum Zusammenfassen und Analysieren lesen

• Formularinhalte in den Wissensdatenbanken Ihrer Organisation verankern, damit Fragen aus Ihrem eigenen Material stammen

• Jedes Formular, einschließlich eines nicht gespeicherten Entwurfs, als herunterladbares Word-Dokument exportieren

Voraussetzungen

• Führen Sie die allgemeinen Einrichtungsschritte auf der Hauptseite der KI-Agenten

• Stellen Sie sicher, dass Benutzer aktive Microsoft-365-Konten mit aktiviertem Microsoft Forms haben

• Überprüfen Sie die passende Microsoft-365-Lizenzierung für Microsoft Forms

• Berechtigungen zum Erstellen und Verwalten einer Azure-App-Registrierung in Microsoft Entra ID

Der MS Forms Agent ist der einzige Microsoft-Agent, der nicht auf Microsoft Graph läuft. Microsoft Graph hat keinen Endpunkt zum Erstellen oder Bearbeiten eines Formulars, daher spricht dieser Agent direkt mit der Microsoft-Forms-API. Das ändert, welche Berechtigungen Sie hinzufügen und welche Scopes Sie konfigurieren, also folgen Sie dieser Seite, statt die Einrichtung eines anderen Microsoft-Agenten anzupassen.

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigungen

Der Agent benötigt delegierte Berechtigungen von zwei APIs. Fügen Sie alle sechs Ihrer App-Registrierung hinzu.

Berechtigung	API	Typ	Beschreibung
Forms.Read	Microsoft Forms	Delegiert	Formulare des Benutzers anzeigen
Forms.ReadWrite	Microsoft Forms	Delegiert	Formulare des Benutzers anzeigen und ändern
Responses.Read.All	Microsoft Forms	Delegiert	Antworten der Formulare des Benutzers anzeigen
Responses.ReadWrite	Microsoft Forms	Delegiert	Antworten für den Benutzer übermitteln
offline_access	Microsoft Graph	Delegiert	Den Zugriff auf Daten aufrechterhalten, für die Sie ihm Zugriff gewährt haben
User.Read	Microsoft Graph	Delegiert	Anmelden und Benutzerprofil lesen

Microsoft Forms wird unter Microsoft Graph nicht aufgeführt. Wenn Sie in der Liste der Graph-Berechtigungen nach Forms.Read suchen, werden Sie es nicht finden.

Fügen Sie es über APIs, die meine Organisation verwendet hinzu und suchen Sie nach Microsoft Forms. Die vier Forms-Berechtigungen sind dann unter Delegierte Berechtigungen.

Keine dieser sechs Berechtigungen erfordert eine Admin-Zustimmung, sodass ein Benutzer beim ersten Verbinden selbst zustimmen kann. Eine Admin-Zustimmung für die Organisation wird dennoch empfohlen, weil dadurch die individuelle Zustimmungsaufforderung für jeden Benutzer entfällt.

Umleitungs-URL

• Hinzufügen https://nango.theblockbrain.ai/oauth/callback als zulässige Umleitungs-URL in Ihrer App-Registrierung

Schritte zur Berechtigungskonfiguration

1. Gehen Sie in Ihrer Azure-App-Registrierung zu API-Berechtigungen

2. Klicken Sie auf „Berechtigung hinzufügen“ > APIs, die meine Organisation verwendet > suchen Sie nach Microsoft Forms

3. Wählen Sie Delegierte Berechtigungen aus und wählen Sie Forms.Read, Forms.ReadWrite, Responses.Read.Allund Responses.ReadWrite

4. Klicken Sie auf „Berechtigung hinzufügen“ noch einmal > Microsoft Graph > Delegierte Berechtigungen aus und wählen Sie offline_access und User.Read

5. Klicken Sie auf „Berechtigungen hinzufügen“

6. Klicken Sie auf „Admin-Zustimmung erteilen“ (empfohlen für organisationsweite Bereitstellung)

Agentenkonfiguration in Blockbrain

Konfigurationsschritte

1. Agenteneinstellungen aufrufen:

   • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

   • Gehen Sie zu Agenten und öffnen Sie den Connectors Tab

   • Suchen Sie Microsoft Forms und öffnen Sie dessen Werkzeugkonfiguration

2. Azure-Anmeldedaten eingeben:

   • Client-ID: Geben Sie die Anwendungs-ID aus Ihrer Azure-App-Registrierung ein

   • Client-Secret: Fügen Sie das von Ihnen generierte Client-Secret ein (verwenden Sie das Augensymbol, um die Sichtbarkeit umzuschalten)

3. OAuth-Scopes konfigurieren:

   • Fügen Sie jeden der vier Scopes einzeln mit der „Hinzufügen“ Schaltfläche hinzu:

     • https://forms.office.com/.default

     • offline_access

     • openid

     • profile

   • Jeder Scope wird als entfernbares Tag angezeigt

   • Verwenden Sie die „X“ Schaltfläche, um falsche Scopes zu entfernen

4. Zusätzliche Konfiguration:

   • Fügen Sie ein Schlüssel-Wert-Paar hinzu, mit dem Schlüssel tenant und Ihrer Azure-Mandanten-ID als Wert

   • Dies ist erforderlich, nicht optional. Ohne sie schlägt die Verbinden Schaltfläche bei jedem Benutzer fehl

5. Konfiguration speichern:

   • Klicken Sie auf „Speichern“ um alle Einstellungen zu übernehmen

   • Warten Sie auf die Bestätigungsmeldung

Entfernen Sie nicht openid und profile aus der Scopeliste. Sie wirken kosmetisch, sind es aber nicht.

Microsoft stellt für die Forms-Ressource ein verschlüsseltes, nicht lesbares Zugriffstoken aus, sodass der Agent Ihre Mandanten- und Benutzerkennungen daraus nicht lesen kann. Stattdessen liest er sie aus dem ID-Token, und nur die openid und profile Scopes führen dazu, dass eines ausgegeben wird. Wenn eines von beiden fehlt, schlägt jede Aktion sofort mit einer Meldung fehl, in der Sie aufgefordert werden, sie hinzuzufügen, noch bevor überhaupt ein Aufruf an Microsoft Forms versucht wird.

Wenn Sie die Scopes ändern, nachdem Benutzer bereits verbunden sind, müssen diese Benutzer die Verbindung trennen und erneut verbinden. Eine bestehende Verbindung behält das ID-Token, das ursprünglich ausgestellt wurde, daher behebt eine Scope-Änderung allein das Problem nicht.

Ein Hinweis zum .default Scope

Bei den anderen Microsoft-Agenten ist die Verwendung von .default eine Alternative dazu, einzelne Scopes aufzulisten. Für MS Forms ist dies die normale Konfiguration, wie oben gezeigt, da die vier Microsoft-Forms-Berechtigungen in der App-Registrierung gewährt und gemeinsam als https://forms.office.com/.defaultangefordert werden. Konfigurieren Sie die Berechtigungen in Azure wie oben beschrieben, und die Scopeliste in Blockbrain bleibt unverändert.

Werkzeugberechtigungen

Der Microsoft-Forms-Connector stellt sechs Werkzeuge bereit. Da einige davon Formulare in den Konten Ihrer Benutzer erstellen und ändern, überprüfen Sie ihre Berechtigungsstufen, nachdem Sie den Connector aktiviert haben.

Nur-Lese-Werkzeuge, gefahrlos aktiviert zu lassen Immer erlauben:

Werkzeug	Was es tut
Microsoft Forms auflisten	Listet die Formulare auf, die dem verbundenen Benutzer gehören
Microsoft-Formular abrufen	Liest ein Formular mit seinen Fragen sowie seinen Teilnehmer- und Bearbeitungslinks
Microsoft-Formularantworten abrufen	Liest übermittelte Antworten zur Analyse oder Zusammenfassung
Microsoft-Formular als Dokument exportieren	Stellt ein Formular oder einen nicht gespeicherten Entwurf als Word-Dokument dar

Schreibwerkzeuge, die standardmäßig auf Genehmigung erforderlich:

Werkzeug	Was es tut
Microsoft-Formular erstellen	Erstellt ein neues Formular oder Quiz im Konto des verbundenen Benutzers
Microsoft-Formular aktualisieren	Ändert den Titel oder die Beschreibung eines Formulars und fügt Fragen hinzu, bearbeitet oder löscht sie

Wir empfehlen, beide Schreibwerkzeuge aktiviert zu lassen Genehmigung erforderlich. Der Agent ist bereits angewiesen, ein Formular im Chat zu entwerfen und es erst nach der Zustimmung des Benutzers zu erstellen, sodass die Genehmigungsaufforderung ein zweiter, erzwungener Kontrollpunkt und kein redundanter ist. Siehe Tools & Connectors verwalten wie diese Stufen festgelegt werden.

Microsoft-Formular als Dokument exportieren funktioniert ganz ohne Microsoft-Forms-Verbindung. Das ist beabsichtigt: Ein Benutzer, dessen Verbindung defekt ist oder der noch nicht verbunden ist, kann seinen Entwurf dennoch als Word-Datei exportieren.

Das MS Forms Agent testen

Verifizierungsschritte

1. Authentifizierungstest:

   • Öffnen Sie einen Chat mit dem MS Forms Agent und führen Sie den Verbinden Ablauf

   • durch. Vergewissern Sie sich, dass die Microsoft-Anmeldung abgeschlossen wird und die Verbindungs-Karte nicht erneut erscheint

2. Lesezugriff:

   • Bitten Sie den Agenten, Ihre Formulare aufzulisten

   • Überprüfen Sie, dass die Titel mit dem übereinstimmen, was Sie unter https://forms.office.com

3. Formularerstellung:

   • Bitten Sie um ein kurzes Formular mit zwei Fragen, genehmigen Sie den Entwurf und lassen Sie den Agenten es erstellen

   • Überprüfen Sie, dass Sie sowohl einen Teilnehmerlink als auch einen Bearbeitungslink erhalten

   • Öffnen Sie den Teilnehmerlink und bestätigen Sie, dass das Formular für einen Teilnehmer dargestellt wird

4. Antworten lesen:

   • Senden Sie über den Teilnehmerlink eine Antwort

   • Bitten Sie den Agenten, die Antworten zusammenzufassen, und überprüfen Sie, dass Ihre Antwort erscheint

5. Quiz-Erstellung:

   • Bitten Sie um ein kurzes Quiz mit Punkten und richtigen Antworten und genehmigen Sie es dann

   • Öffnen Sie den Bearbeitungslink und bestätigen Sie, dass die Punkte und der Antwortschlüssel gesetzt sind

6. Dokumentexport:

   • Bitten Sie den Agenten, das Formular als Word-Dokument zu exportieren

   • Überprüfen Sie, dass der Download-Link funktioniert und das Dokument jede Frage auflistet

Häufige Anwendungsfälle für die MS-Forms-Integration

Umfragen und Feedback

• Feedback zu Veranstaltungen und Schulungen: Erstellen Sie aus einer kurzen Beschreibung eine Feedback-Umfrage und fassen Sie dann die eingehenden Antworten zusammen

• Mitarbeiter-Kurzabfragen: Erstellen Sie eine wiederkehrende Kurzumfrage mit einheitlicher Formulierung über verschiedene Abteilungen hinweg

• Antwortanalyse: Fragen Sie nach Themen, Häufigkeiten oder Ausreißern in den übermittelten Antworten, statt in eine Tabellenkalkulation zu exportieren

Bewertungen und Quizze

• Wissensabfragen aus internem Material: Verankern Sie ein Quiz in Ihren eigenen Richtlinien- oder Onboarding-Dokumenten, damit die Fragen zu dem passen, was Ihre Organisation tatsächlich veröffentlicht

• Bewertete Prüfungen: Erstellen Sie ein Quiz mit Punkten pro Frage und einem markierten Antwortschlüssel, das von Microsoft Forms automatisch bewertet wird

• Iterative Verfeinerung: Passen Sie Formulierungen, Optionen, Punkte und richtige Antworten im Chat an, bevor etwas erstellt wird

Formularoperationen

• Massenbearbeitung von Fragen: Fügen Sie in einer vorhandenen Formularanfrage einen Stapel von Fragen hinzu oder überarbeiten Sie ihn

• Archivierung der Struktur: Exportieren Sie ein Formular zu Prüf-, Freigabe- oder Dokumentationszwecken nach Word

• Formularbestand: Listen Sie vorhandene Formulare und deren Antwortzahlen auf, um zu sehen, welche noch Antworten sammeln

Unterstützte Fragetypen und Grenzen

Unterstützte Fragetypen

Typ	Optionen
Auswahl	Einfach- oder Mehrfachauswahl, benutzerdefinierte Optionen, optionale Freitextoption „Sonstiges“
Text	Kurze Antworten oder lange mehrzeilige Antworten
Bewertung	Stern- oder Zahlenskala, 2 bis 10 Stufen, standardmäßig 5
Datum	Datumsauswahl

Nicht unterstützt: Rangfolge, Likert, Net-Promoter-Score und Fragen zum Datei-Upload. Wenn ein Benutzer nach einem davon fragt, sagt der Agent das und schlägt stattdessen den nächstgelegenen unterstützten Typ vor. Auch gruppeneigene Formulare sind nicht vorgesehen, da jedes Formular im eigenen Konto des verbundenen Benutzers erstellt wird.

Quizverhalten

• Der Quizmodus ist festgelegt, wenn das Formular erstellt wird. Ein vorhandenes Standardformular kann nicht umgewandelt werden, daher muss stattdessen ein neues Quiz erstellt werden

• Punkte sind ganze Zahlen von 0 bis 100. Bruchteile von Punkten werden abgelehnt, da Microsoft Forms sie nicht unterstützt

• Nur Auswahlfragen können richtige Antworten enthalten, und eine Einzelauswahlfrage kann höchstens eine richtige Antwort haben

• Jede Option einer bewerteten Frage muss eindeutig sein, da richtige Antworten über ihren Optionstext abgeglichen werden

• Eine Auswahlfrage wird erst bewertet, wenn sie richtige Antworten hat. Punkte allein bewerten sie nicht

• Die automatische Bewertung von Freitextantworten und Feedback pro Antwort werden noch nicht unterstützt

Obergrenzen

Grenze	Wert
Fragen pro Erstellung oder Aktualisierung	100
Formulare pro Auflistungsseite	100
Antworten pro Seite	200
Gültigkeit des Word-Download-Links	1 Stunde

Fehlerbehebung

Authentifizierungsprobleme

Problem: Die Verbindungs-Karte erscheint nach erfolgreicher Microsoft-Anmeldung immer wieder

• Lösung: Überprüfen Sie, dass die Umleitungs-URL genau https://nango.theblockbrain.ai/oauth/callback

• Prüfen: Bestätigen Sie den tenant Schlüssel ist in Zusätzliche Konfiguration mit Ihrer Azure-Mandanten-ID gesetzt

• Überprüfen Sie: Das Client-Secret ist nicht abgelaufen und korrekt eingegeben

Jede Aktion schlägt sofort fehl

Problem: Auflisten, Erstellen und Lesen schlagen alle auf einmal fehl, mit einer Meldung, in der nach den openid und profile Scopes

• Lösung: Fügen Sie beide openid und profile zur Scopeliste hinzu und speichern Sie

• Prüfen: Betroffene Benutzer müssen die Verbindung trennen und erneut herstellen, da eine bestehende Verbindung ihr ursprüngliches ID-Token behält

• Überprüfen Sie: Ihre App-Registrierung stellt die Claims für Tenant- und Benutzerobjekt-IDs aus

Aktionen funktionieren nach vorheriger, einwandfreier Funktion nicht mehr

Problem: Der Agent meldet eine nicht lesbare oder nicht-JSON-Antwort von Microsoft Forms

• Lösung: Lassen Sie den Benutzer die Microsoft-Forms-Integration trennen und erneut verbinden

• Prüfen: Dies ist die typische Signatur einer abgelaufenen oder widerrufenen Autorisierung, da die Microsoft-Forms-API auf ein abgelaufenes Token mit einer Anmeldeseite statt mit einem Fehler antwortet

• Überprüfen Sie: Bestätigen Sie, dass das Microsoft-365-Konto des Benutzers weiterhin für Microsoft Forms lizenziert ist

Fehler bei der Quizkonfiguration

Problem: Punkte oder richtige Antworten werden abgelehnt

• Lösung: Verwenden Sie ganzzahlige Punkte von 0 bis 100 und geben Sie richtige Antworten nur bei Auswahlfragen an

• Prüfen: Das Formular muss als Quiz erstellt worden sein. Der Quizmodus kann nicht nachträglich aktiviert werden

• Überprüfen Sie: Jede Option einer bewerteten Frage ist eindeutig, und eine Einzelauswahlfrage markiert höchstens eine richtige Antwort

Teilweise erstellte Formulare

Problem: Das Formular wurde erstellt, aber einige Fragen fehlen

• Lösung: Fügen Sie die fehlenden Fragen dem vorhandenen Formular hinzu. Erstellen Sie das Formular nicht erneut, da sonst ein Duplikat zurückbleibt

• Prüfen: Öffnen Sie den Bearbeitungslink, um zu sehen, welche Fragen angekommen sind

• Überprüfen Sie: Die betroffenen Fragetypen werden unterstützt, und jede bewertete Frage nennt ihre richtigen Antworten

Benutzer können ihre Formulare nicht finden

Problem: Ein Formular wurde erstellt, aber der Benutzer kann es nicht sehen

• Lösung: Weisen Sie den Benutzer an, zu https://forms.office.com während er mit demselben Arbeitskonto angemeldet ist, mit dem er sich verbunden hat

• Prüfen: Formulare gehören dem einzelnen Benutzer, nicht einer Gruppe oder einem Dienstkonto

• Überprüfen Sie: Der Benutzer ist beim richtigen Microsoft-Mandanten angemeldet

Sicherheit und Compliance

Datenschutz

• Delegierter Zugriff: Der Agent handelt strikt als angemeldeter Benutzer und kann nur das tun, was dieser Benutzer tun kann. Es gibt keinen organisationsweiten Hintergrundzugriff

• Formularbesitz: Jedes Formular wird im eigenen Microsoft-Forms-Konto des verbundenen Benutzers unter dessen Namen erstellt

• Umgang mit Anmeldedaten: Tokens werden in Blockbrains gesichertem OAuth-Tresor aufbewahrt. Die Mitarbeiter von Blockbrain sehen niemals Benutzerkennwörter, und das Trennen der Verbindung widerruft den Zugriff sofort

Compliance-Aspekte

• DSGVO-Konformität: Die Verarbeitung von Formular- und Antwortdaten erfolgt gemäß der DSGVO und anderen relevanten Datenschutzanforderungen

• Antwortdaten: Antworten bleiben in Microsoft Forms. Der Agent liest sie auf Anfrage und behält keine eigene Kopie

• Audit-Protokollierung: Alle Aktivitäten des MS Forms Agent werden zu Compliance- und Berichtszwecken protokolliert

• Temporäre Exporte: Erstellte Word-Dokumente werden vorübergehend gespeichert und über Links bereitgestellt, die nach einer Stunde ablaufen und auf Ihre Organisation beschränkt sind

Zugriffskontrolle

• Benutzerberechtigungen: Der Agent übernimmt die Microsoft-Forms-Berechtigungen des angemeldeten Benutzers

• Genehmigungsstufen: Das Erstellen und Aktualisieren von Formularen erfordert standardmäßig die Genehmigung des Benutzers, zusätzlich zum eigenen Entwurf-dann-Bestätigungs-Workflow des Agents

• Verankerung in Wissensdatenbanken: Wenn ein Formular auf internen Inhalten basiert, liest der Agent nur die Dokumente, auf die der Chat-Arbeitsbereich bereits Zugriff hat

So funktioniert die Formularerstellung. Microsoft bietet keine offizielle API zum Erstellen von Formularen an, daher verwendet der Agent dieselbe interne Microsoft-Schnittstelle wie Microsofts eigene Forms-Web-App und Copilot und handelt als angemeldeter Benutzer.

Wenn Microsoft diese Schnittstelle ändert, kann die Formularerstellung vorübergehend nicht verfügbar sein. Das Entwerfen eines Formulars im Chat und das Herunterladen als Word-Dokument funktionieren immer, und das Lesen vorhandener Antworten bleibt unbeeinträchtigt.

Nächste Schritte

Nach erfolgreicher Konfiguration des MS Forms Agent:

• Werkzeugberechtigungen: Überprüfen Sie die Berechtigungsstufe von Microsoft-Formular erstellen und Microsoft-Formular aktualisieren, wie oben beschrieben

• Benutzerschulung: Zeigen Sie den Benutzern den Entwurf-dann-Genehmigen-Workflow, da nichts erstellt wird, bevor sie bestätigen

• Wissensdatenbanken: Verbinden Sie die Wissensdatenbanken, auf denen Formulare und Quizze basieren sollen

Support und Ressourcen

Für Unterstützung bei der Konfiguration von MS Forms Agent:

• Blockbrain Support: Wenden Sie sich an Ihren Customer Success Manager für funktionsspezifische Hilfe

• Microsoft-Dokumentation: Schlagen Sie in der Microsoft Entra ID-Dokumentation nach, um Details zu delegierten Berechtigungen und zur Einwilligung zu erhalten

• Azure AD-Problembehandlung: Verwenden Sie die Anmeldeprotokolle von Microsoft Entra ID für die Authentifizierungsdiagnose