Schema des deklarativen Agents 1.5 für Microsoft 365 Copilot

In diesem Artikel wird das 1.5-Schema beschrieben, das vom Manifest des deklarativen Agents verwendet wird. Das Manifest ist ein maschinenlesbares Dokument, das ein LLM (Large Language Model) mit den erforderlichen Anweisungen, Kenntnissen und Aktionen bereitstellt, um sich auf die Behandlung einer ausgewählten Gruppe von Benutzerproblemen zu spezialisieren. Das Microsoft 365-App-Manifest verweist auf deklarative Agent-Manifeste innerhalb eines App-Pakets. Weitere Informationen finden Sie in der Referenz zum Microsoft 365-App-Manifest.

Deklarative Agenten sind wertvoll beim Verstehen und Generieren von menschenähnlichem Text, sodass sie für Aufgaben wie das Schreiben und Beantworten von Fragen vielseitig sind. Diese Spezifikation konzentriert sich auf das deklarative Agent-Manifest, das als strukturiertes Framework fungiert, um die Funktionen eines bestimmten Benutzers zu spezialisieren und zu verbessern.

Änderungen gegenüber der vorherigen Version

Mit dieser Schemaversion werden die folgenden Änderungen gegenüber Version 1.4 eingeführt:

• Die Besprechungsfunktion wurde der Liste von capabilitieshinzugefügt, mit der Agents Besprechungen im organization durchsuchen können.

JSON-Schema

Das in diesem Dokument im JSON-Schemaformat beschriebene Schema finden Sie hier.

Konventionen

Relative Verweise in URLs

Sofern nicht anders angegeben, können alle Eigenschaften, die URLs sind, relative Verweise sein. Relative Verweise im Manifestdokument sind relativ zum Speicherort des Manifestdokuments.

Zeichenfolgenlänge

Sofern nicht anders angegeben, beschränken Sie alle Zeichenfolgeneigenschaften auf 4.000 Zeichen. Diese Zeichenfolgenlänge legt keine akzeptable Größe für alle Zeichenfolgeneigenschaften im Dokument fest. Implementierungen können ihre eigenen praktischen Grenzwerte für die Manifestlänge festlegen.

Nicht erkannte Eigenschaften

Json-Objekte, die in diesem Dokument definiert sind, unterstützen nur die beschriebenen Eigenschaften. Unbekannte oder überflüssige Eigenschaften in einem JSON-Objekt machen das gesamte Dokument ungültig.

Lokalisierung von Zeichenfolgen

Lokalisierbare Zeichenfolgen können einen Lokalisierungsschlüssel anstelle eines Literalwerts verwenden. Die Syntax ist [[key_name]], wobei key_name der Schlüsselname in der localizationKeys -Eigenschaft in Ihren Lokalisierungsdateien ist. Ausführliche Informationen zur Lokalisierung finden Sie unter Lokalisieren Ihres Agents.

Manifestobjekt des deklarativen Agents

Der Stamm des Manifestdokuments ist ein JSON-Objekt, das erforderliche Felder, Funktionen, Konversationsstarter und Aktionen abdeckt.

Das Manifestobjekt des deklarativen Agents enthält die folgenden Eigenschaften.

Beispiel für ein Manifestobjekt des deklarativen Agents

Der folgende Code zeigt ein Beispiel für die erforderlichen Felder in einem deklarativen Agentmanifest.

{
  "name" : "Repairs agent",
  "description": "This declarative agent is meant to help track any tickets and repairs",
  "instructions": "This declarative agent needs to look at my Service Now and Jira tickets/instances to help me keep track of open items"
}

@agent(
  "Repairs agent",
  "This declarative agent is meant to help track any tickets and repairs"
)
@instructions(
  "This declarative agent needs to look at my Service Now and Jira tickets/instances to help me keep track of open items"
)
namespace MyAgent {

}

Capabilities-Objekt

Das Capabilities-Objekt ist der Basistyp für Objekte in der capabilities -Eigenschaft des Manifestobjekts des deklarativen Agents. Mögliche Objekttypen sind:

• Websuchobjekt
• OneDrive- und SharePoint-Objekt
• Copilot-Connectors-Objekt
• Grafikobjekt
• Codeinterpreterobjekt
• Dataverse-Objekt
• Microsoft Teams-Nachrichtenobjekt
• Email-Objekt
• Personenobjekt
• Szenariomodellobjekt
• Besprechungsobjekt

Beispiel für ein Capabilities-Objekt

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "https://contoso.com"
        }
      ]
    },
    {
      "name": "OneDriveAndSharePoint",
      "items_by_sharepoint_ids": [
        {
          "site_id": "bc54a8cc-8c2e-4e62-99cf-660b3594bbfd",
          "web_id": "a5377427-f041-49b5-a2e9-0d58f4343939",
          "list_id": "78A4158C-D2E0-4708-A07D-EE751111E462",
          "unique_id": "304fcfdf-8842-434d-a56f-44a1e54fbed2"
        }
      ],
      "items_by_url": [
        {
          "url": "https://contoso.sharepoint.com/teams/admins/Documents/Folders1"
        }
      ]
    },
    {
      "name": "GraphConnectors",
      "connections": [
        {
          "connection_id": "jiraTickets"
        }
      ]
    },
    {
      "name": "GraphicArt"
    },
    {
      "name": "CodeInterpreter"
    },
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "organization.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    },
    {
      "name": "TeamsMessages",
      "urls": [
        {
          "url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    {
      "name": "People"
    },
    {
      "name": "ScenarioModels",
      "models": [
        {
          "id": "model_id"
        }
      ]
    },
    {
      "name": "Meetings"
    }
  ]
}

namespace MyAgent {
  op webSearch is AgentCapabilities.WebSearch<Sites = [
    {
        url: "https://contoso.com"
    }
  ]>;

  op od_sp is AgentCapabilities.OneDriveAndSharePoint<
    ItemsBySharePointIds = [
      {
        siteId: "bc54a8cc-8c2e-4e62-99cf-660b3594bbfd";
        webId: "a5377427-f041-49b5-a2e9-0d58f4343939";
        listId: "78A4158C-D2E0-4708-A07D-EE751111E462";
        itemId: "304fcfdf-8842-434d-a56f-44a1e54fbed2";
      }
    ],
    ItemsByUrl = [
      {
        url: "https://contoso.sharepoint.com/teams/admins/Documents/Folders1"
      }
    ]
  >;

  op copilotConnectors is AgentCapabilities.CopilotConnectors<Connections = [
    {
        connectionId: "jiraTickets"
    }
  ]>;

  op graphicArt is AgentCapabilities.GraphicArt;

  op codeInterpreter is AgentCapabilities.CodeInterpreter;

  op dataverse is AgentCapabilities.Dataverse<KnowledgeSources = [
    {
      hostName: "organization.crm.dynamics.com";
      skill: "DVCopilotSkillName";
      tables: [
        { tableName: "account" },
        { tableName: "opportunity" }
      ];
    }
  ]>;

  op teamsMessages is AgentCapabilities.TeamsMessages<TeamsMessagesByUrl = [
    {
        url: "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
    }
  ]>;

  op people is AgentCapabilities.People;

  op scenarioModels is AgentCapabilities.ScenarioModels<Models = [
    { id: "model_id" }
  ]>;

  op meetings is AgentCapabilities.Meetings;
}

Websuchobjekt

Gibt an, dass der deklarative Agent das Web nach Erdungsinformationen durchsuchen kann.

Das Websuchobjekt enthält die folgenden Eigenschaften.

Websiteobjekt

Gibt eine Website an, die ein deklarativer Agent nach Inhalten suchen kann.

Das Websiteobjekt enthält die folgende Eigenschaft.

OneDrive- und SharePoint-Objekt

Gibt an, dass der deklarative Agent sharePoint und OneDrive eines Benutzers nach Erdungsinformationen durchsuchen kann.

Das OneDrive- und SharePoint-Objekt enthält die folgenden Eigenschaften.

Informationen zum Optimieren von SharePoint-Inhalten für Copilot finden Sie unter Optimieren des Abrufs von SharePoint-Inhalten.

Elemente nach SharePoint-IDs-Objekt

Das Element nach SharePoint-IDs-Objekt enthält die folgenden Eigenschaften.

Elemente nach URL-Objekt

Das Element nach URL-Objekt enthält die folgende Eigenschaft.

Copilot-Connectors-Objekt

Gibt an, dass der deklarative Agent ausgewählte Copilot-Connectors nach Erdungsinformationen durchsuchen kann.

Das Copilot Connectors-Objekt enthält die folgenden Eigenschaften.

Connection-Objekt

Identifiziert einen Copilot-Connector.

Das Verbindungsobjekt enthält die folgenden Eigenschaften.

Elementbezeichnerobjekt

Identifiziert ein externes Element anhand seiner ID.

Das Elementbezeichnerobjekt enthält die folgenden Eigenschaften.

Path object

Identifiziert ein externes Element anhand seines Pfads.

Das path-Objekt enthält die folgenden Eigenschaften.

Containername-Objekt

Identifiziert einen Container anhand seines Namens.

Das Containernamenobjekt enthält die folgenden Eigenschaften.

Container-URL-Objekt

Identifiziert einen Container anhand seiner URL.

Das Container-URL-Objekt enthält die folgenden Eigenschaften.

Grafikobjekt

Gibt an, dass der deklarative Agent Bilder und Grafiken basierend auf der Texteingabe des Benutzers erstellen kann. Weitere Informationen finden Sie unter Imagegenerator.

Das Grafikobjekt enthält die folgende Eigenschaft.

Codeinterpreterobjekt

Gibt an, dass der deklarative Agent Python-Code generieren und ausführen kann, um komplexe mathematische Probleme zu lösen, Daten zu analysieren, Visualisierungen zu generieren und vieles mehr. Weitere Informationen finden Sie unter Codeinterpreter.

Das Codeinterpreterobjekt enthält die folgende Eigenschaft.

Dataverse-Objekt

Gibt an, dass der deklarative Agent Daten aus Tabellen in Dataverse durchsuchen kann.

Das Dataverse-Objekt enthält die folgenden Eigenschaften.

Wissensquellenobjekt

Enthält Informationen zu den Dataverse-Instanzen, die als Wissen eingeschlossen werden sollen.

Das Wissensquellenobjekt enthält die folgenden Eigenschaften.

So suchen Sie den eindeutigen skill Bezeichner für die Dataverse-Wissensquellen, die Sie einschließen möchten:

1. Wählen Sie in Copilot Studio im linken Bereich Agents>Copilot für Microsoft 365 und dann Hinzufügen aus, um einen neuen Agent zu erstellen.
2. Befolgen Sie die Anweisungen unter Hinzufügen einer Dataverse-Wissensquelle , um Dataverse-Wissen hinzuzufügen.
3. Wählen Sie Veröffentlichen aus, und laden Sie dann die .zip-Datei herunter.
4. Entzippen Sie die datei declarativeAgent.json, und öffnen Sie sie.
5. Der skill Wert ist im knowledge_sources Abschnitt enthalten, wie im folgenden Beispiel gezeigt.

{
  "name": "Dataverse",
  "knowledge_sources": [
    {
      "host_name": "org0f612cfc.crm.dynamics.com",
      "skill": "AIBuilderFileAttachedData_e7eTReDbkX_1t4X1oGoCF",
      "tables": [
        {
          "table_name": "msdyn_aibfileattacheddata"
        }
      ]
    }
  ]
}

Tables-Objekt

Enthält die Tabellen zum Festlegen des Wissens des Agents.

Das Tables-Objekt enthält die folgende Eigenschaft.

Microsoft Teams-Nachrichtenobjekt

Gibt an, dass der deklarative Agent Microsoft Teams-Kanäle, Teams, Besprechungen, 1:1-Chats und Gruppenchats durchsuchen kann.

Das Microsoft Teams-Nachrichtenobjekt enthält die folgenden Eigenschaften.

Microsoft Teams-URL-Objekt

Identifiziert einen Microsoft Teams-Kanal, ein Team oder einen Besprechungschat.

Das Microsoft Teams-URL-Objekt enthält die folgenden Eigenschaften.

Email-Objekt

Gibt an, dass der deklarative Agent E-Mail-Nachrichten in den Postfächern durchsuchen kann, auf die der Benutzer Zugriff hat.

Das E-Mail-Objekt enthält die folgenden Eigenschaften.

Folders-Objekt

Enthält die Ordner, um das Wissen des Agents zu erweitern.

Das Folders-Objekt enthält die folgende Eigenschaft.

Personenobjekt

Gibt an, dass der deklarative Agent nach Informationen zu Personen im organization suchen kann.

Das people-Objekt enthält die folgende Eigenschaft.

Szenariomodellobjekt

Gibt an, dass der deklarative Agent aufgabenspezifische Modelle verwenden kann.

Das Szenariomodellobjekt enthält die folgenden Eigenschaften.

Model-Objekt

Identifiziert ein aufgabenspezifisches Modell.

Das Modellobjekt enthält die folgende Eigenschaft.

Besprechungsobjekt

Gibt an, dass der deklarative Agent nach Informationen zu Besprechungen im organization suchen kann.

Das Besprechungsobjekt enthält die folgende Eigenschaft.

Unterhaltungsstarter-Objekt

Das Unterhaltungsstarter-Objekt ist im Manifest optional. Sie enthält Hinweise, die der Agent dem Benutzer anzeigt, um zu zeigen, wie er mit dem deklarativen Agent beginnen kann.

Das Conversation Starter-Objekt enthält die folgenden Eigenschaften:

Conversation Starters-Objekt (Beispiel)

{
  "conversation_starters": [
    {
      "title": "My Open Repairs",
      "text": "What open repairs are assigned to me?"
    }
  ]
}

@conversationStarter(#{
  title: "My Open Repairs",
  text: "What open repairs are assigned to me?"
)}

Actions-Objekt

Aktionen sind ein optionales JSON-Objekt im Manifest. Sie dienen als Entwicklereingabe und können als Plug-Ins betrachtet werden.

Das Aktionsobjekt enthält die folgenden Eigenschaften.

Actions-Objektbeispiel

{
  "actions": [
    {
      "id": "repairsPlugin",
      "file": "plugin.json"
    }
  ]
}

@service
@server("https://jsonplaceholder.typicode.com")
@actions(#{
  nameForHuman: "Posts APIs",
  descriptionForHuman: "Manage blog post items on JSON Placeholder APIs.",
  descriptionForModel: "Read, create, update and delete blog post items on the JSON Placeholder APIs."
})
namespace PostsAPI {
  // All operations from the actions
}

Verhaltensüberschreibungsobjekt

Ein optionales JSON-Objekt, das Konfigurationseinstellungen enthält, die das Verhalten des Agents überschreiben.

Das Verhaltensüberschreibungsobjekt enthält die folgenden Eigenschaften.

Suggestions-Objekt

Ein optionales JSON-Objekt, das Konfigurationseinstellungen für das Vorschlagsfeature enthält.

Das Suggestions-Objekt enthält die folgende Eigenschaft.

Spezielles Anweisungsobjekt

Ein optionales JSON-Objekt, das Einstellungen zum Einfügen spezieller Anweisungen in die Eingabeaufforderung enthält.

Das spezielle Anweisungsobjekt enthält die folgende Eigenschaft.

Disclaimer-Objekt

Ein Haftungsausschluss ist ein optionales JSON-Objekt im Manifest, das Haftungsausschlusstext angibt. Der Agent zeigt diesen Text dem Benutzer zu Beginn einer Unterhaltung an.

Das Disclaimer-Objekt enthält die folgende Eigenschaft.

Beispiel für das Manifest des deklarativen Agents

Das folgende Beispiel zeigt eine Manifestdatei des deklarativen Agents, die die meisten der in diesem Artikel beschriebenen Manifesteigenschaften verwendet.

{
  "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json",
  "version": "v1.5",
  "name": "Agents Toolkit declarative agent",
  "description": "Declarative agent created with Agents Toolkit",
  "instructions": "You are a repairs expert agent. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.",
  "conversation_starters": [
    {
      "title": "Getting Started",
      "text": "How can I get started with Agents Toolkit?"
    },
    {
      "title": "Getting Help",
      "text": "How can I get help with Agents Toolkit?"
    }
  ],
  "actions": [
    {
      "id": "repairsPlugin",
      "file": "repairs-hub-api-plugin.json"
    }
  ],
  "behavior_overrides": {
    "suggestions": {
      "disabled": true
    },
    "special_instructions": {
      "discourage_model_knowledge": true
    }
  },
  "disclaimer": {
    "text": "This declarative agent is a fictional example. You should not take it seriously."
  },
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "https://contoso.com/projects/mark-8"
        }
      ]
    },
    {
      "name": "OneDriveAndSharePoint",
      "items_by_url": [
        {
          "url": "https://contoso.sharepoint.com/sites/ProductSupport"
        }
      ]
    },
    {
      "name": "GraphConnectors",
      "connections": [
        {
          "connection_id": "foodStore"
        }
      ]
    },
    {
      "name": "GraphicArt"
    },
    {
      "name": "CodeInterpreter"
    },
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "organization.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    },
    {
      "name": "TeamsMessages",
      "urls": [
        {
          "url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
      ]
    },
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
         "folder_id": "inbox"
        }
      ]
    },
    {
      "name": "People"
    },
    {
      "name": "ScenarioModels",
      "models": [
        {
          "id": "model_id"
        }
      ]
    },
    {
      "name": "Meetings"
    }
  ]
}

Verwandte Inhalte

• Schreiben effektiver Anweisungen für deklarative Agents
• Referenz zum Microsoft 365-App-Manifest