Invites de confirmation pour MCP et les plug-ins d’API pour Microsoft 365 Copilot

Importante

Les plug-ins MCP et API sont pris en charge en tant qu’actions dans les agents déclaratifs. Elles ne sont pas activées en tant qu’expériences autonomes dans Microsoft 365 Copilot.

La première fois que Microsoft 365 Copilot utilise un protocole MCP (Model Context Protocol) ou un plug-in API, il informe l’utilisateur et lui demande d’autoriser ou d’annuler l’opération. Si l’utilisateur autorise Copilot à se connecter au plug-in, toutes les opérations ultérieures qui récupèrent des données (opérations HTTP GET) ne nécessitent aucune confirmation. D’autres opérations HTTP invitent l’utilisateur, montrant les données à envoyer et donnant à l’utilisateur le choix d’autoriser ou de refuser.

Boîte de dialogue de confirmation Copilot pour la première connexion à un plug-in

Les développeurs de plug-ins peuvent modifier ce comportement pour des opérations individuelles dans leur serveur MCP ou API. Les développeurs peuvent également personnaliser le texte que Copilot affiche à l’utilisateur dans le cadre de l’invite de confirmation.

Remplacement du comportement d’invite

Les développeurs peuvent contrôler si Microsoft 365 Copilot demande à l’utilisateur une confirmation (après la première invite initiale) pour un outil spécifique en définissant la readOnlyHint propriété true sur l’outil dans la réponse du tools/list serveur MCP. Pour plus d’informations, consultez la référence de schéma MCP.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "title": "Weather Information Provider",
        "description": "Get current weather information for a location",
        "annotations": {
          "readOnlyHint": true,
        },
        "inputSchema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name or zip code"
            }
          },
          "required": ["location"]
        }
      }
    ]
  }
}

Personnalisation du texte de confirmation

Les développeurs peuvent spécifier le texte de confirmation en définissant la propriété dans l’objetbody Confirmation de l’objet Fonctionnalités de fonction de la fonction dans le manifeste du plug-in. La valeur de body doit être indicative de ce que fait la fonction. Si cette propriété n’est pas présente dans le manifeste, la description propriété dans l’objet Function est utilisée à la place.

Remarque

La personnalisation du texte de confirmation s’applique uniquement aux outils déclarés dans le tableau du manifeste du functions plug-in (outils épinglés). Pour les plug-ins MCP qui utilisent la découverte dynamique d’outils, les outils sont résolus à partir du serveur MCP au moment de l’exécution et ne sont pas déclarés dans le manifeste. Vous ne pouvez donc pas personnaliser leur texte de confirmation. Copilot utilise plutôt l’outil description à partir de la réponse du tools/list serveur MCP.

{
  "name": "GetBudgets",
  "description": "Returns details including name and available funds of budgets, optionally filtered by budget name",
  "capabilities": {
    "confirmation": {
      "type": "AdaptiveCard",
      "title": "Search budgets",
      "body": "Do you want to allow searching for budgets?"
    }
  }
}

Localisation du texte de confirmation

Vous pouvez configurer des chaînes localisables à utiliser comme invites de confirmation. Les étapes suivantes décrivent le processus.

Étape 1 : Utiliser les clés de localisation dans le manifeste du plug-in

Dans le manifeste de votre plug-in (par exemple, plugin.json), remplacez les chaînes littérales par des clés de localisation en utilisant le format suivant :

    {
      "schema_version": "v2.3",
      "name_for_human": "[[plugin_name]]",
      "description_for_human": "[[plugin_description]]"
    }

Ces clés (par exemple plugin_name et plugin_description) doivent correspondre aux entrées de votre fichier de localisation et être conformes à l’expression ^[a-zA-Z_][a-zA-Z0-9_]*régulière .

Étape 2 : Créer les fichiers de localisation

Créez vos fichiers de localisation au format JSON et incluez une localizationKeys propriété qui mappe chaque clé à sa chaîne traduite, comme illustré dans l’exemple suivant.

    {
  "localizationKeys": {
    "plugin_name": "Weather Assistant",
    "plugin_description": "Provides weather updates and forecasts."
      }
    }

Vous pouvez créer plusieurs fichiers de localisation pour différentes langues (par exemple, en.json, fr.json, de.json) et les référencer dans la configuration de votre plug-in.

Étape 3 : Ajouter localizationInfo au manifeste de l’application

Incluez une section localizationInfo dans le manifeste de votre application qui fait référence aux fichiers de localisation. Par exemple,

    "localizationInfo": {
      "defaultLanguageTag": "en",
      "defaultLanguageFile": "en.json",
      "additionalLanguages": [
        {
          "languageTag": "fr",
          "file": "fr.json"
        }
      ]
    }

Contenu connexe

Plug-ins pour Microsoft 365 Copilot

  • Dernière mise à jour :