In Microsoft Copilot nutzenFür Entwickler

Neuen Copilot anlegen

Öffne copilotstudio.microsoft.com und klicke auf „Create" → „New Copilot". Gib einen Namen ein — zum Beispiel „Bodenrichtwert-Assistent" — und wähle Deutsch als Sprache.

Custom Connector erstellen

Ein Custom Connector ist Microsofts Bezeichnung für „Verbindung zu einem externen Dienst". Wir legen einen an, der zu bodenrichtwert.ai verbindet.

Wechsle in der linken Navigation zu „Tools" (oder „Actions") und klicke auf „Add a Tool" → „New Tool" → „Custom Connector". Es öffnet sich der Power-Platform-Connector-Editor — das ist der Baukasten für diese Verbindungen.

Verbindungsdatei importieren

Wähle „Import from OpenAPI URL" und füge ein:

https://api.bodenrichtwert.ai/openapi.json

Das ist unsere Verbindungsdatei — sie beschreibt, welche Funktionen dein Copilot bei uns aufrufen darf (zum Beispiel „Bodenrichtwert abfragen"). Copilot Studio baut daraus automatisch die passenden Felder.

Connector speichern. Im Tab „General" kannst du einen Anzeigenamen wie „:brand-name" vergeben.

Anmeldung einrichten (OAuth)

Damit dein Copilot in deinem Namen abfragen kann, nutzen wir OAuth 2.0 — einen Standard-Anmeldeprozess, bei dem sich jeder Nutzer einmal im Browser bei uns anmeldet. Copilot speichert danach einen sicheren Zugriffs-Schlüssel und sieht dein Passwort nie.

Für Copilot Studio brauchst du zusätzlich zur Client ID (Kennung des Copilots) auch ein Client Secret — ein geheimes Passwort, mit dem sich der Copilot gegenüber bodenrichtwert.ai ausweist. Beide bekommst du aus unserem Dashboard.

Öffne dazu in unserem Dashboard den Tab OAuth-Apps und klicke auf „Neue App". Vergib einen Namen (z. B. „Copilot") und lass Typ („Confidential") und Grant-Types auf der Vorauswahl. Bei Redirect-URIs trägst du https://global.consent.azure-apim.net/redirect ein — das ist die Standard-Redirect-URL von Copilot Studio; ob sie stimmt, prüfst du gleich im nächsten Schritt. Nach „App erstellen" bekommst du Client ID und Client Secret angezeigt. Das Client Secret ist nur einmal sichtbar, lege es an einem sicheren Ort ab.

Zurück im Connector-Editor: Im Tab „Security" wählst du „OAuth 2.0" als Authentifizierungstyp (als Identitätsanbieter: „Generic OAuth 2"). Trage ein:

Nach dem Speichern zeigt Copilot Studio dir eine Redirect-URL — das ist die Adresse, zu der wir dich nach der Anmeldung zurückleiten. Weicht sie von der bereits eingetragenen ab, ersetze sie in unserem Dashboard: OAuth-Apps → Stift-Symbol neben „Copilot" → „Redirect-URIs" → „Änderungen speichern".

Erstes Thema anlegen und testen

In Copilot Studio besteht ein Copilot aus Topics (Themen) — jedes Thema beschreibt, wann der Copilot welche Aktion ausführt. Lege eines für Bodenrichtwert-Anfragen an.

Gehe auf „Topics" → „New Topic" → „From description with Copilot". Beschreibe das Ziel in einem Satz („Bodenrichtwert per Adresse abfragen") und verknüpfe das Topic mit dem neu angelegten bodenrichtwert.ai-Connector.

Im „Test"-Panel fragst du:

„Was ist der Bodenrichtwert am Kölner Dom?"

Beim ersten Aufruf öffnet sich der Browser zur Anmeldung — danach läuft alles still im Hintergrund.