Zum Hauptinhalt springen

Azure DevOps mit Sally AI integrieren

Verbinde Sally AI mit Azure DevOps, um Meeting-Einblicke direkt in deinen Projektboards produktiv zu nutzen. Mit der Sally-Azure DevOps-Integration kannst du Work Items erstellen oder Kommentare zu bestehenden Items hinzufügen, mit nur einem Klick. So vermeidest du doppelte Eingaben und hältst dein DevOps-Board immer aktuell.

Schnellnavigation

  1. So verbindest du Azure DevOps mit Sally AI
  2. So sendest du Insights zu Azure DevOps
  3. Erforderliche OAuth-Scopes

1. Wie verbinde ich Azure DevOps mit Sally AI?​

Folge diesen Schritten, um die Sally-Azure DevOps-Integration zu aktivieren:

  1. Öffne die Einstellungen unten links in der Seitenleiste.
Sally-Oberfläche mit hervorgehobenen Einstellungen unten links in der Seitenleiste
Abbildung 1: Einstellungen öffnen
  1. Wähle unter Konfiguration den Punkt Integrationen. Ist noch keine Integration verbunden, klickst du auf Integrationen entdecken, sonst oben rechts auf Integration hinzufügen.
Seite Integrationen mit dem markierten Button Integrationen entdecken
Abbildung 2: Die Liste der Integrationen öffnen
  1. Wähle im Bereich Integration hinzufügen links die Kategorie Projektmanagement-Tools und darin Azure DevOps.
Bereich Integration hinzufügen mit der Kategorie Projektmanagement-Tools und markiertem Eintrag Azure DevOps
Abbildung 3: Azure DevOps auswählen
  1. Trage im Dialog Azure DevOps verbinden die Adresse deiner Organisation ein und klicke auf Verbinden. Danach leitet Sally dich zur Anmeldung weiter.
Dialog Azure DevOps verbinden mit dem Feld für die Adresse der Organisation
Abbildung 4: Adresse eintragen und verbinden
Nur die Basis-URL deiner Organisation

Gib im Dialog nur die Basis-URL deiner Organisation ein, ohne Projekt, Repository oder Pfad.

Beispiel

  • Volle URL zu einem Pull Request: https://dev.azure.com/fabrikam/ProjectX/_git/WebPortal/pullrequest/860
  • Was du in Sally eintragen musst: https://dev.azure.com/fabrikam

Sieht deine URL so aus: https://dev.azure.com/<org>/<project>/..., dann reicht der Teil https://dev.azure.com/<org>.

  1. Nach der Anmeldung erscheint Azure DevOps in der Liste, unter der Kategorie Projektmanagement-Tools. Über Verbindung trennen oben rechts löst du die Verbindung bei Bedarf wieder.

1.1. Welche Aktionen darf Sally nutzen?​

Die verbundene Integration hat zwei Reiter, Überblick und Aktionen. Im Reiter Aktionen legst du fest, was Sally über diese Integration anbietet, im Sally-Chat und nach dem Meeting.

Reiter Aktionen der Azure DevOps Integration mit den Schaltern der primären Aktionen
Abbildung 5: Aktionen der Integration einzeln freigeben

Unter Primäre Aktionen steht, was Sally aktiv in Azure DevOps schreibt, also Work Items auflisten, erstellen, aktualisieren und kommentieren. Jede Aktion nennt in einer Zeile darunter, was sie tut.

Mit dem Schalter rechts nimmst du eine einzelne Aktion heraus, die Sally für dieses Unternehmenskonto nicht nutzen soll.

Nicht jede Aktion taucht in der Auswahl am Meeting auf. Einige nutzt Sally selbst, beispielsweise im Chat oder als Teil einer anderen Aktion. Damit die Integration vollständig arbeitet, sollten sie eingeschaltet bleiben. Schalte deshalb nur ab, was Sally in diesem Unternehmenskonto wirklich nicht tun soll.

Darunter stehen die Hilfsfunktionen, also Lese- und Suchfunktionen, die die primären Aktionen unterstützen, zum Beispiel ein Projekt oder einen Empfänger finden. Sie bleiben gesperrt, solange eine aktive Aktion sie braucht.

2. Wie sende ich Meeting-Insights an Azure DevOps?​

Sobald Azure DevOps verbunden ist, kannst du Meeting-Insights direkt mit einem Klick nach Azure DevOps übertragen, ins richtige Projekt.

Du kannst:

2.1. Work Item in Azure DevOps erstellen​

Verwandle ein Insight aus Sally in ein Azure DevOps Work Item.

  1. Öffne das gewünschte Meeting in Sally.
  2. Fahre in der Zusammenfassung über den Block oder über einen einzelnen Eintrag und klicke auf das Stecker-Symbol. Wähle in der Liste unter Azure DevOps den Punkt Work Item in Azure DevOps erstellen.
Zusammenfassung eines Meetings mit dem Stecker-Symbol und der Liste der Integrationen, darin Azure DevOps
Abbildung 6: Über das Stecker-Symbol die Azure DevOps Aktion wählen
  1. Fülle den Dialog aus. Pflicht sind Projekt, Work-Item-Typ und Titel, wobei der Titel schon aus Sally vorbefüllt ist. Zugewiesen an, Bereich und Iteration sind optional. Die Beschreibung kommt ebenfalls aus der Zusammenfassung und lässt sich im Editor anpassen.
Dialog Work Item in Azure DevOps erstellen mit Projekt, Work-Item-Typ, Titel und Beschreibung
Abbildung 7: Felder prüfen und Work Item erstellen
  1. Klicke auf Work Item erstellen, um es nach Azure DevOps zu senden.

2.2. Kommentar zu Azure DevOps Item hinzufügen​

Füge Meeting-Kontext zu einem bestehenden Work Item hinzu, praktisch für Updates, zusätzliche Infos oder Entscheidungen.

  1. Öffne das gewünschte Meeting in Sally.
  2. Klicke am Block oder am Eintrag auf das Stecker-Symbol und wähle unter Azure DevOps den Punkt Kommentar zu Azure DevOps Item hinzufügen.
Liste der Integrationen mit der Azure DevOps Aktion für einen Kommentar
Abbildung 8: Die Aktion für einen Kommentar wählen
  1. Wähle im Dialog das Projekt und darin das Work Item, zu dem der Kommentar gehört. Beide Felder sind Pflicht.
Dialog Kommentar zu Azure DevOps Item hinzufügen mit den Feldern Projekt, Work Item und Kommentar
Abbildung 9: Projekt und Work Item wählen und den Kommentar prüfen
  1. Im Feld Kommentar steht der Text aus der Zusammenfassung. Passe ihn bei Bedarf im Editor an und klicke auf Kommentar hinzufügen.

3. Welche OAuth-Scopes benötigt die Azure DevOps-Integration?​

Für die Integration mit Azure DevOps verwendet Sally OAuth 2.0 zur Autorisierung. Die folgenden Scopes definieren, auf welche Bereiche Sally im Namen des angemeldeten Nutzers zugreifen darf.

Disclaimer

  1. Sally liest diese Informationen ausschließlich ein, um die Verbindung zum Nutzerkonto technisch herzustellen und aufrechtzuerhalten.

  2. Sally nimmt keine eigenmächtigen Änderungen vor. Aktionen werden ausschließlich auf ausdrückliche Initiative des Nutzers ausgeführt.

  3. API-Endpunkte werden ausschließlich im Rahmen einer aktiven, vom Benutzer ausgelösten Aktion innerhalb der Plattform aufgerufen.

Technische Übersicht der benötigten Scopes​

ScopeTypWas Microsoft damit technisch erlaubtWie Sally diesen Scope verwendet
user_impersonationDelegatedAPI-Zugriff im Kontext des angemeldeten NutzersBestandteil des Azure-Authentifizierungsmodells. Sally nutzt diesen Scope ausschließlich zur technischen Ausführung der Integration im Rahmen der Nutzeranmeldung.
vso.work_writeDelegatedAPI-Berechtigung für Work-Item-ObjekteTechnisch im Azure-DevOps-OAuth-Modell vorgesehen. Sally nimmt keine eigenständigen Änderungen an bestehenden Work Items außerhalb expliziter Nutzeraktionen vor.
vso.code_writeDelegatedAPI-Berechtigung für Repository-RessourcenBestandteil des Berechtigungsmodells. Sally verändert keinen Quellcode und greift nicht eigenständig auf Repositories zu.
vso.project_writeDelegatedAPI-Berechtigung für ProjektkonfigurationTechnisch von Microsoft für Integrationen vorgesehen. Sally verändert keine Projektkonfigurationen.
vso.wiki_writeDelegatedAPI-Berechtigung für Wiki-RessourcenBestandteil des OAuth-Modells. Sally erstellt oder verändert keine Wiki-Inhalte eigenständig.
vso.taskgroups_writeDelegatedAPI-Berechtigung für Task-Group-RessourcenTechnisch erforderlich im Rahmen der Integrationsfreigabe. Sally verwaltet keine Task Groups eigenständig.
vso.memberentitlementmanagementDelegatedZugriff auf Organisations- und LizenzinformationenBestandteil der Microsoft-API-Struktur. Sally verändert keine Benutzer- oder Lizenzkonfigurationen.
vso.profileDelegatedZugriff auf BenutzerprofilinformationenSally liest grundlegende Profilinformationen zur Authentifizierung ein. Es erfolgt keine Änderung am Profil.
emailDelegatedZugriff auf die E-Mail-Adresse des NutzersSally liest die E-Mail-Adresse zur eindeutigen Kontoidentifikation.
User.ReadDelegatedLesen grundlegender NutzerinformationenBestandteil des Microsoft-Identitätsmodells zur Authentifizierung.
profileDelegatedZugriff auf Basis-ProfildatenSally liest Basisinformationen zur Identifikation des angemeldeten Kontos ein.
openidDelegatedOpenID Connect AuthentifizierungSichere Anmeldung über Microsoft Identity.
offline_accessDelegatedAusstellung langfristiger ZugriffstokenErmöglicht eine stabile Verbindung ohne erneute Anmeldung. Es werden keine DevOps-Daten verändert.