Freigeben über

Agents sind Apps für Microsoft 365

  • Artikel

Wenn Sie einen Agent erstellen, erstellen Sie auch eine App für Microsoft 365. Apps für Microsoft 365 teilen sich ein gemeinsames Manifestschema- und Paketformat sowie einheitliche Verteilungs- und Verwaltungsprozesse und -tools. Das Endergebnis ist, dass Ihre Apps und Agents eine möglichst breite Zielgruppe erreichen und kontextbezogen im Workflow Ihrer Benutzer angezeigt werden.

In diesem Artikel werden die wichtigsten Teile des Microsoft 365-App-Modells beschrieben, die für die Agent-Entwicklung gelten.

Wichtig

  • API-Plug-Ins werden derzeit nur als Aktionen in deklarativen Agents unterstützt. Sie sind in Microsoft 365 Copilot nicht aktiviert. Ein Beispiel zum Hinzufügen eines API-Plug-Ins zu einem deklarativen Agent finden Sie unter Hinzufügen eines Plug-Ins.
  • Die Funktion ist standardmäßig in allen Microsoft 365 Copilot lizenzierten Mandanten aktiviert. Administratoren können diese Funktionalität auf Benutzer- und Gruppenbasis deaktivieren und steuern, wie einzelne Plug-Ins für die Verwendung genehmigt werden und welche Plug-Ins aktiviert sind. Weitere Informationen finden Sie unter Verwalten von Agents in integrierten Apps.

App-Paket

Das App-Paket für Microsoft 365, einschließlich Agents, ist eine ZIP-Datei, die eine oder mehrere Konfigurationsdateien (Manifestdateien) und Ihre App-Symbole enthält. Ihre App-Logik und Der Datenspeicher werden an anderer Stelle gehostet und von der Microsoft 365-Hostanwendung über HTTPS aufgerufen. Sie übermitteln das App-Paket an Ihren Administrator, um es in Ihrem organization oder in Partner Center zu veröffentlichen, um es in Microsoft AppSource zu veröffentlichen.

Ein App-Paket enthält mindestens Folgendes:

  • Das App-Manifest (manifest.json), das app-Konfiguration, Funktionen, erforderliche Ressourcen und wichtige Attribute beschreibt
  • Ein großes Farbsymbol (color.png), ein vollfarbiges 92x92-Symbol zum Anzeigen Ihres Agents auf der Microsoft Copilot-Benutzeroberfläche und im Speicher
  • Ein kleines Kontursymbol (outline.png), ein 32x32-Symbol mit transparentem Hintergrund (derzeit nicht in Copilot verwendet, aber erforderlich, um die Überprüfung zu bestehen)

Das App-Paket kann auch deklarative Agent- und API-Plug-In-Definitionen sowie Lokalisierungsdateien für andere unterstützte Sprachen enthalten.

Diagramm, das die Anatomie eines Microsoft 365-App-Pakets zeigt: App-Manifest (.json-Datei) + Symbole (Farbe und Gliederung .png Dateien), die in eine .zip-Datei eingeschlossen sind

App-Symbole

Ihr App-Paket muss sowohl eine Farb- als auch eine Gliederungsversion Ihres App-Symbols enthalten, wie .png Dateien. Diese Symbole haben bestimmte Größenanforderungen, um die Speicherüberprüfung zu bestehen.

Hinweis

Derzeit wird nur das Farbsymbol verwendet, um Agents für Benutzer darzustellen (sowohl als Store-Eintrag als auch innerhalb der Microsoft 365 Copilot-Benutzeroberfläche), aber ein Gliederungssymbol ist weiterhin erforderlich, wenn Sie das App-Paket an Microsoft AppSource übermitteln.

Eine Entwurfsanleitung für Farb- und Gliederungssymbole für das Microsoft 365-App-Paket finden Sie unter App-Symbole für Teams Store und App-Leiste.

Farbsymbol

Das Farbsymbol stellt Ihren Agent in den Microsoft Copilot Ui und in produktinternen App Stores (Teams, Outlook, Microsoft 365) dar.

Beispielbild eines App-Farbsymbols mit einer Gesamtsymbolgröße von 192 x 192 Pixeln mit enthaltenem Hintergrund und einem zentralen Bereich von 96 x 96 Pixeln mit dem

Ihr Farbsymbol:

Kontursymbol

Das Gliederungssymbol wird verwendet, um angeheftete und/oder aktive Apps auf der Teams-App-Leiste darzustellen. Sie wird derzeit nicht für Agents verwendet, ist aber dennoch erforderlich, damit das App-Paket die Überprüfung bestehen kann.

Beispielbild eines App-Gliederungssymbols mit einer Größe von 32 x 32 Pixeln und einer weißen Symbolumrandung mit transparentem Hintergrund

Ihr Gliederungssymbol:

  • Muss 32 x 32 Pixel groß sein
  • Muss entweder weiß mit transparentem Hintergrund oder transparent mit weißem Hintergrund sein
  • Darf keine zusätzliche Auffüllung um das Symbol enthalten.

App-Manifest

Das App-Manifest für Microsoft 365 ist eine JSON-Datei, die die Funktionen und Merkmale Ihrer App beschreibt. Im Kern ist das App-Manifest für Microsoft 365 das Schema zum Erstellen von Teams-Apps. Ab Version 1.13 werden jedoch zusätzlich zu Teams auch Apps unterstützt, die auf Microsoft 365-Hosts ausgeführt werden.

Wenn Sie Copilot Studio verwenden, um einen deklarativen Agent zu erstellen, wird das App-Manifest basierend auf den Informationen generiert, die Sie während des Erstellungsprozesses angeben.

Jedes App-Manifest muss die folgenden Felder enthalten.

Manifestfeld Beschreibung
version Die Versionsnummer der App im Format MAJOR. KLEINER. PATCH (Semver-Standard ).
id Der eindeutige generierte Bezeichner für diese App im Microsoft Application Registration Portal (apps.dev.microsoft.com) in GUID-Form.
Entwickler Informationen zum Entwickler, einschließlich Name, Website und Links zu Datenschutzrichtlinien und Nutzungsbedingungen. Für Apps, die an AppSource übermittelt werden, müssen die Werte mit dem Wert übereinstimmen, der im Partner Center-App-Übermittlungsformular angegeben ist.
name Der Name Ihrer App, der endbenutzern auf dem Anwendungshost angezeigt wird.
description Kurze und lange Beschreibungen Ihrer App für Benutzer. Für Apps, die an AppSource übermittelt werden, müssen diese Werte mit den Informationen in Ihrem AppSource-Eintrag übereinstimmen.
Ikonen Relative Pfade zu Farb- und Gliederungssymboldateien.
accentColor Eine Farbe, die mit und als Hintergrund für Ihre Gliederungssymbole verwendet werden soll, im RGB-Hexadezimalwert, z. B #4464ee. .
Definitionen für bestimmte App-Funktionen Eine Definition für jede App-Funktion, z. B. persönliche Registerkarten (staticTabs), Nachrichtenerweiterungen (composeExtensions) oder Bots. Deklarative Agents und API-Plug-Ins werden unter dem Knoten copilotAgents definiert.

Das folgende Beispiel zeigt ein App-Manifest mit Platzhalterabschnitten am Ende für Nachrichtenerweiterungs- und deklarative Agent-App-Funktionen.

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.18/MicrosoftTeams.schema.json",
    "manifestVersion": "1.18",
    "version": "1.0.0",
    "id": "00000000-0000-0000-0000-000000000000",
    "developer": {
        "name": "Northwind Traders",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "Northwind-Logo-196.png",
        "outline": "Northwind-Logo-32.png"
    },
    "name": {
        "short": "Northwind Inventory",
        "full": "Northwind Inventory App"
    },
    "description": {
        "short": "App allows you to find and update product inventory information",
        "full": "Northwind Inventory is the ultimate tool for managing your product inventory. With its intuitive interface and powerful features, you'll be able to easily find your products by name, category, inventory status, and supplier city. You can also update inventory information with the app."
    },
    "accentColor": "#3690E9",
    "composeExtensions": {
        ...
    },
    "copilotAgents": {
        ...
    }
}

Weitere Informationen finden Sie unter App-Manifest.

copilotAgents Definitionen

Deklarative Agents und API-Plug-Ins verfügen jeweils über eigene Definitionsschemas. Auf die Definitionsdatei für einen deklarativen Agent wird vom copilotAgents -Objekt des App-Manifests verwiesen.

Das folgende Beispiel zeigt, wie auf einen deklarativen Agent verwiesen wird:

    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },

Auf die Definition eines API-Plug-Ins wird (unter actions) aus der deklarativen Agent-Definition verwiesen.

Diagramm: App-Manifest, das auf ein deklaratives Agent- und API-Plug-In-Manifest verweist. Das Manifest des deklarativen Agents verweist auf ein anderes API-Plug-In-Manifest.

Beachten Sie Folgendes:

  • Derzeit wird nur eine deklarative Agent-Definition pro App-Manifest unterstützt.

  • Wenn Sie Copilot Studio zum Erstellen von Agents verwenden, wird für jeden ein eindeutiger id als Teil der gesamten App-Manifestgenerierung generiert. Wenn Sie Agents mit dem Teams-Toolkit oder Ihrer eigenen IDE erstellen, weisen Sie den id selbst gemäß Ihren eigenen Konventionen oder Anzeigenamen zu.

Manifest des deklarativen Agents

Das Manifest des deklarativen Agents enthält Anweisungen für Copilot-Antworten, Beispieleingabeaufforderungen für Konversationsstarter, Datenquellen, die für das Grounding verwendet werden, und eine Liste der Aktionen (API-Plug-In-Skills), die der Agent ausführen kann.

Weitere Informationen finden Sie unter Manifestschema des deklarativen Agents für Microsoft 365 Copilot.

API-Plug-In-Manifest

Das API-Plug-In-Manifest beschreibt die Funktionen des Plug-Ins, einschließlich der unterstützten APIs und der Vorgänge, die es ausführen kann. Sie enthält auch Metadaten wie Name, Beschreibung, Version und einen Verweis auf die OpenAPI-Definition der REST-APIs, mit denen sie interagiert. Auf API-Plug-Ins kann aus einem deklarativen Agent-Manifest verwiesen werden, das in der deklarativen Agent-Benutzeroberfläche verwendet werden soll.

Weitere Informationen finden Sie unter API-Plug-In-Manifestschema für Microsoft 365 Copilot.

Verwandte Inhalte