> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/for-admins/agenten/ms-forms-agent.md). # 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
Titelbild
Ü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
Screenshot 2025-12-04 at 13.51.34.png
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
Screenshot 2025-12-04 at 13.51.48.png
{% hint style="info" %} 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. {% endhint %} ### 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 | {% hint style="warning" %} **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**. {% endhint %} 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.All`und `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 {% hint style="danger" %} **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. {% endhint %} #### 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/.default`angefordert 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](/de/for-admins/manage-tools-and-connectors.md) 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 {% hint style="info" %} **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. {% endhint %} ### 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.blockbrain.ai/de/for-admins/agenten/ms-forms-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.