Veröffentlichen von Agents für Microsoft 365 Copilot und Microsoft Teams

Nachdem Sie einen Agenten erstellt und getestet haben, besteht der nächste Schritt oft darin, ihn mit anderen auf den Plattformen zu teilen, auf denen sie bereits arbeiten. Durch das Veröffentlichen eines Foundry-Agents in Microsoft 365 Copilot und Teams können Sie und andere Benutzer über die Microsoft 365 Copilot- und Teams-Benutzeroberfläche mit Ihrem Agent interagieren und entdecken. Was veröffentlicht wird, ist der stabile Endpunkt des Agents, sodass Endbenutzer immer mit einer konsistenten Agententität interagieren, während Sie neue Agentversionen nahtlos bereitstellen, die Datenverkehr über den Endpunkt empfangen. Sie veröffentlichen auf M365/Teams über das Foundry-Portal.

Wichtig

Veröffentlichung von Agents für Microsoft 365 Copilot und Microsoft Teams ist ein "Early Access Preview" und wird Ihnen als Teil Ihres Azure-Abonnements lizenziert und unterliegt den Bedingungen für "Vorschauen" und "Early Access Previews" in den Ergänzenden Nutzungsbedingungen für Microsoft Azure Previews und dem Microsoft-Produkte- und -Dienste-Datenschutzzusatz ("DPA").

Die Verwendung von Azure AI Foundry Agent Service zum Hosten von Agents, die mit Servern oder Agents von Drittanbietern arbeiten, besteht in Ihrem eigenen Risiko. Es wird empfohlen, alle Daten zu überprüfen, die mit Servern oder Agenten von Drittanbietern geteilt werden, und sich über die Praktiken der Drittanbieter zur Aufbewahrung und zum Speicherort der Daten bewusst zu sein.

Externe Tools oder Dienste (einschließlich Microsoft Tools und Dienste außerhalb Azure AI Foundry ), mit denen Azure AI Foundry Agent Service interagieren, unterliegen ihren eigenen Datenverarbeitungsbedingungen. Agents, die in Copilot oder Teams veröffentlicht wurden, unterliegen auch zusätzlichen Bedingungen.

Es liegt in Ihrer Verantwortung zu entscheiden, ob Ihre Daten die Azure Compliance- und geografischen Grenzen Ihrer Organisation überschreiten und welche Konsequenzen dies mit sich bringt.

Hinweis

Wenn Sie von einem vorherigen Veröffentlichungsmodell migrieren, lesen Sie " Migrieren von Agentanwendungen zum neuen Agentmodell".

Voraussetzungen

• Zugriff auf das Microsoft Foundry-Portal

• Ein Foundry-Projekt mit einer agent-Version, die Sie getestet haben und veröffentlichen möchten

• Die folgenden Rollenzuweisungen:

  • Azure AI User Rolle im Projektumfang Foundry, um Agenten zu erstellen, zu verwalten und zu veröffentlichen.
  • Ausführliche Informationen finden Sie unter Rollenbasierte Zugriffssteuerung im Foundry-Portal.

• Ein Azure-Abonnement, in dem Azure Bot Service Ressourcen erstellt werden können

• Testen Sie Ihren Agenten gründlich im Foundry-Portal, bevor Sie sie veröffentlichen. Vergewissern Sie sich, dass sie korrekt reagiert und alle Tools wie erwartet funktionieren.

• Wählen Sie die aktive Agentenversion aus, mit der Verbraucher in Microsoft 365 und Teams interagieren sollen.

• Stellen Sie sicher, dass erforderliche Azure Ressourcenanbieter in Ihrem Abonnement registriert sind. Der Veröffentlichungsprozess erstellt eine Azure Bot Service Ressource, die den anbieter Microsoft.BotService erfordert.

  Wenn Sie Azure CLI verwenden, können Sie den Anbieter mit dem folgenden Befehl registrieren:

  az provider register --namespace Microsoft.BotService
  

Auswählen einer aktiven Agent-Version in der Foundry-Benutzeroberfläche

Weitere Informationen zum Auswählen einer aktiven Agent-Version und zum Konfigurieren anderer Agenteinstellungen finden Sie unter Veröffentlichen und Freigeben von Agents.

1. Wählen Sie im Microsoft Foundry-Portal Publish aus.

   Erwartetes Ergebnis: Ein Dropdown-Menü öffnet sich, das Endpunkt-URLs, die aktive Version und einen Link zum Veröffentlichen in Teams und Microsoft 365 Copilot anzeigt.

2. Wählen Sie rechts neben der aktiven Version das Pfeilsymbol aus.

   Erwartetes Ergebnis: Ein Popup wird mit Optionen geöffnet, um immer die neueste Version zu verwenden oder eine bestimmte Version auszuwählen.

3. Wählen Sie die aktive Version aus, über die Ihr Agent stabilen Datenverkehr empfangen soll.

   Erwartetes Ergebnis: Die Dropdownliste "Veröffentlichen" wird geschlossen, und die Schaltfläche " Veröffentlichen " zeigt ein Häkchen an, um den Erfolg anzuzeigen. ::image type="content" source=".. /media/success-select-version.png" alt-text="Screenshot der Schaltfläche "Veröffentlichen" mit einem Häkchen, das angibt, dass die Version erfolgreich ausgewählt wurde.":::

Veröffentlichen in Microsoft 365 und Teams

1. Wählen Sie im Microsoft Foundry-Portal Publish und dann Publish to Teams und Microsoft 365 Copilot aus.

   Erwartetes Ergebnis: Der Dialog Veröffentlichen in Teams und Microsoft 365 öffnet sich.

2. Eine Azure Bot Service Ressource wird entweder automatisch erstellt oder als schreibgeschützt angezeigt, wenn bereits eine ressource vorhanden ist.

3. Füllen Sie die erforderlichen Metadaten aus:

   Feld	Beschreibung
   Namen	Anzeigename für Ihren Agenten (wird im Agentenstore angezeigt)
   Version veröffentlichen	Dreiteilige Versionsnummer (major.minor.patch)
   Kurzbeschreibung	Eine Satzbeschreibung der Funktionsweise Ihres Agenten
   Beschreibung	Längere Beschreibung der Verantwortlichkeiten Ihres Agenten und der aktionen, die er ergreifen kann
   Entwickler	Name oder Organisationsname (unter Autor)

   Um optionale Metadaten hinzuzufügen, erweitern Sie "Weitere " und füllen Sie die folgenden Felder aus:

   Feld	Beschreibung
   Entwicklerwebsite	URL zu Ihrer Website (HTTPS erforderlich)
   Nutzungsbedingungen	URL zu Ihren Nutzungsbedingungen (HTTPS erforderlich)
   Datenschutzbestimmungen	URL zu Ihrer Datenschutzrichtlinie (HTTPS erforderlich)

   Warnung

   Schließen Sie keine geheimen Schlüssel, API-Schlüssel oder vertraulichen Informationen in metadatenfelder ein. Diese Felder sind für Benutzer sichtbar.

4. Wählen Sie "Weiter" aus: Veröffentlichungsoptionen.

5. Wählen Sie aus, wie sie veröffentlicht werden sollen. Sie können Ihren Agent entweder direkt über Foundry veröffentlichen oder das Agent-Manifest herunterladen und anpassen und dann manuell in Teams querladen.

Direkte Veröffentlichung

1. Wählen Sie im Schritt " Veröffentlichungsoptionen " die Registerkarte " Direkte Veröffentlichung" aus .

   Erwartetes Ergebnis: Abschnitt auswählen, wer diesen Agent verwenden kann , wird angezeigt.

2. Wählen Sie unter "Auswählen, wer diesen Agent verwenden kann" einen Bereich aus:

   Option	Verhalten	Administratorgenehmigung	Optimal für
   Nur Sie	Sofort verfügbar. Der Agent wird unter "Ihre Agenten " im Agent-Store angezeigt. Teilen Sie den Link mit anderen Personen, indem Sie den Agent-Link versenden.	Nicht erforderlich	Persönliche Tests, kleine Teams, Pilotprojekte
   Personen in Ihrer Organisation	Der Agent wird zur Genehmigung an den Administrator übermittelt. Ihr Microsoft 365 Administrator überprüft die Anforderung und weist Zugriff zu. Nach der Genehmigung wird der Agent unter „Erstellt von Ihrer Organisation“ für alle Mandanten-Benutzer angezeigt.	Erforderlich	Organisationsweite Verteilung, Produktionsbereitstellungen

   Nur Sie:

   • Unmittelbar nach der Veröffentlichung verfügbar – keine Administratorgenehmigung erforderlich.
   • Nur Sie sehen den Agenten zunächst unter Ihren Agenten im Agent-Store.
   • Teilen Sie sie mit bestimmten Benutzern, indem Sie den Agentlink senden.

   Personen in Ihrer Organisation:

   • Nach der Veröffentlichung muss ein Microsoft 365-Administrator die Anforderung im Microsoft 365 Admin Center überprüfen und genehmigen.

   • Nach der Genehmigung wird der Agent unter " Erstellt von Ihrer Organisation " im Agent-Store für alle Mandantenbenutzer angezeigt.

   • App-Richtlinien in Ihrem Mandanten steuern, welche Benutzer Zugriff auf den Agenten haben.

   • Um den Genehmigungsstatus zu überprüfen, wechseln Sie zum Microsoft 365 Admin Center und suchen Sie unter Requests nach Ihrem Agenten.

     

3. Wählen Sie "Veröffentlichen" aus.

   Erwartetes Ergebnis: Ein Dialogfeld " Veröffentlichen" bestätigt, dass der Agent erfolgreich veröffentlicht wurde.

Herunterladen und Anpassen

Wenn Sie das Agentmanifest vor der Verteilung anpassen möchten:

1. Wählen Sie im Schritt " Veröffentlichungsoptionen " die Registerkarte " Herunterladen und Anpassen " aus.

   Erwartetes Ergebnis: Auf der Registerkarte werden Anweisungen für den Download und eine ZIP-Schaltfläche "Herunterladen " angezeigt.

2. Wählen Sie "ZIP herunterladen" aus.

   Erwartetes Ergebnis: Eine .zip Datei, die das Agentmanifest enthält, wird auf Ihren lokalen Computer heruntergeladen.

3. Passen Sie das Manifest im heruntergeladenen Paket nach Bedarf an.

4. Laden Sie in Microsoft Teams das heruntergeladene Paket hoch.

   1. Wechseln Sie zu "Apps>Verwalten Ihrer Apps>", um eine App hochzuladen
   2. Wählen Sie "Benutzerdefinierte App hochladen" oder " Übermitteln einer App an Ihre Organisation " aus, und wählen Sie die heruntergeladene .zip Datei aus.

Aktualisieren eines veröffentlichten Agents in M365/Teams

Aktualisieren der aktiven Agent-Version

Um eine neue Agent-Version bereitzustellen, aktualisieren Sie die Versionsauswahl des Agents im Foundry-Portal. Die stabile Endpunkt-URL bleibt gleich – sie müssen nicht erneut auf M365/Teams veröffentlicht werden.

Aktualisieren von Endbenutzermetadaten in M365/Teams

Um metadaten zu aktualisieren, die in Teams und M365 (Anzeigename, Beschreibungen, URLs) sichtbar sind, wählen Sie im Dropdownmenü Publish dropdown Update agent Teams und Microsoft 365 Copilot anzeigeeigenschaften aus. Die aktualisierten Felder überschreiben die vorhandenen Werte; unveränderte Felder werden weitergeführt; und die Version erhöht automatisch, wenn sie nicht manuell erhöht wird.

Einschränkungen

Einschränkung	Beschreibung
Dateiuploads und Bildgenerierung in Microsoft 365	Diese funktionieren nicht für Agents, die für Microsoft 365 veröffentlicht wurden. Sie arbeiten in Microsoft Teams.
Privater Link	Wird für Microsoft Teams- oder Azure Bot Service-Integrationen nicht unterstützt.
Streaming und Zitate	Veröffentlichte Agents unterstützen keine Streaming-Antworten oder Quellenangaben.

Problembehandlung

Problem	Ursache	Auflösung
Fehler beim Veröffentlichen des Agents	Ungültige Metadaten oder Version	Stellen Sie sicher, dass der Agent über eine eindeutige Identität verfügt (agent.identity ist nicht NULL). Vergewissern Sie sich, dass der Entwicklername 32 Zeichen oder weniger hat.
Azure Bot Service Erstellung schlägt fehl.	Fehlende Berechtigungen oder nicht registrierte Anbieter	Bestätigen Sie, dass Sie über die Berechtigung zum Erstellen von Ressourcen verfügen. Registrieren Sie Microsoft.BotService bei Bedarf.
Das Feld Azure Botdienste zeigt einen fehler vom Typ 403 AuthorizationFailed für Microsoft.BotService/botServices/write	Ihre Identität verfügt nicht über die Berechtigung zum Erstellen oder Aktualisieren der Azure Bot Service Ressource in der Zielressourcengruppe.	Weisen Sie der Ressourcengruppe, die den Bot-Dienst enthält, die Rolle Azure Bot Service Mitwirkender zu, aktualisieren Sie dann Ihre Anmeldedaten, und öffnen Sie den Veröffentlichungsprozess erneut.
Der Organisationsbereichs-Agent ist nicht sichtbar.	Administratorgenehmigung ausstehend	Bestätigen Sie einen im M365 Admin Center genehmigten Administrator. Überprüfen Sie App-Richtlinien.
Agent funktioniert in Foundry, schlägt aber nach der Veröffentlichung fehl	Fehlende Berechtigungen für die Agentidentität	Weisen Sie RBAC-Rollen der Identität des Agents für alle Azure Ressourcen zu, auf die er zugreift.
Die Veröffentlichung schlägt mit Identitätsfehlern fehl.	Der Agent verfügt nicht über eine eindeutige Identität (agent.identity ist null)	Die Schritte zum Beheben dieses Problems finden Sie im Migrationshandbuch .
Benutzer können den Agent nicht finden	Falscher Bereich oder Genehmigung ausstehend	Geben Sie für den individuellen Bereich den direkten Link weiter. Bestätigen Sie für den Organisationsbereich die Administratorgenehmigung.

Faqs

Wenn ich den Organisationsbereich auswählte, wo kann ich den Agent genehmigen?

Im Microsoft 365 Admin Center. Nach der Genehmigung wird der Agent unter "Erstellt von Ihrer Organisation " im Agent-Store angezeigt.

Wenn ich meinen Agent im individuellen Bereich (zuvor als freigegebener Bereich bezeichnet) veröffentlichen möchte, wie kann ich ihn für andere Personen in meiner Organisation freigeben?

Der Agent wird unter "Ihre Agenten" im Agent-Store für Microsoft 365 Copilot angezeigt. Sie können ihn freigeben, indem Sie den Agent-Link an ausgewählte Benutzer in Ihrer Organisation senden.

Was geschieht, wenn ich eine neue Agent-Version erstelle, wenn mein Agent in M365 veröffentlicht wird?

Wenn die Versionsauswahl auf "Immer neueste Version verwenden" (Standardeinstellung) festgelegt ist, wird die neue Version automatisch in M365/Teams bereitgestellt. Wenn Sie an eine bestimmte Version angeheftet sind, müssen Sie die Versionsauswahl aktualisieren, um die neue Version zu bedienen.

Verwandte Inhalte

• Konfigurieren Des Agent-Endpunkts und der Einstellungen
• Rollenbasierte Zugriffssteuerung im Foundry-Portal
• Migrieren von Agentanwendungen zum neuen Agentmodell