Ajouter des fonctionnalités et des actions personnalisées à un agent déclaratif créé avec Microsoft 365 Agents Toolkit

Conseil

Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.

Vous pouvez améliorer les capacités de votre agent en ajoutant des fonctionnalités ou des actions personnalisées. Vous pouvez améliorer votre agent en activant des fonctionnalités intégrées telles que le générateur d’images ou l’interpréteur de code, ou en ajoutant des plug-ins MCP ou API en tant qu’actions personnalisées. Ce tutoriel ajoute un plug-in API. Pour ajouter un serveur MCP, voir Créer ou réutiliser des serveurs MCP et Créer un plug-in pour un agent déclaratif à partir d’un serveur MCP.

Ajouter un générateur d’images à l’agent

La fonctionnalité de générateur d’images permet aux agents de générer des images en fonction des invites de l’utilisateur. Pour ajouter un générateur d’images :

  1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez l’entrée GraphicArt au capabilities tableau. Pour plus d’informations, voir Objet d’art graphique.

    {
      "name": "GraphicArt"
    }
    
  2. Dans le volet Cycle de vie de Microsoft 365 Agents Toolkit, sélectionnez Provisionner.

L’agent déclaratif peut générer des images après le rechargement de la page.

Remarque

Le générateur d’images n’est pas disponible pour les agents dans les environnements Microsoft 365 GCCH (Government Community Cloud High).

Capture d’écran montrant une réponse de l’agent déclaratif qui contient une illustration graphique générée

Ajouter un interpréteur de code à l’agent

Code Interpreter est un outil avancé conçu pour résoudre des tâches complexes via du code Python.

Remarque

Dans les environnements GCCH, l’interpréteur de code est disponible uniquement pour les utilisateurs disposant d’une licence de module complémentaire Microsoft 365 Copilot.

  1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez l’entrée CodeInterpreter au capabilities tableau.

    {
      "name": "CodeInterpreter"
    }
    

    Pour plus d’informations, voir Objet Interpréteur de code.

  2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif dispose de la fonctionnalité d’interpréteur de code une fois que vous avez rechargé la page.

Capture d’écran montrant une réponse de l’agent déclaratif qui contient un graphique généré

Capture d’écran montrant le code Python utilisé pour générer le graphique demandé

Ajouter un plug-in d’API en tant qu’action personnalisée à l’agent

Les plug-ins d’API ajoutent de nouvelles capacités à votre agent en lui permettant d’interagir avec une API REST.

Remarque

Les actions personnalisées ne sont pas prises en charge dans les environnements GCCH.

Avant de commencer, créez un fichier nommé posts-api.yml et ajoutez le code du document de description OpenAPI de l’API Posts.

  1. Sélectionnez Ajouter une action dans le volet Développement d’Agents Toolkit.

  2. Sélectionnez Démarrer avec un document de description OpenAPI.

  3. Sélectionnez Parcourir et accédez au posts-api.yml fichier.

  4. Sélectionnez toutes les API disponibles, puis sélectionnez OK.

    Capture d’écran de la boîte de dialogue de sélection d’API dans Visual Studio Code

  5. Sélectionnez manifest.json.

  6. Passez en revue l’avertissement dans la boîte de dialogue. Lorsque vous êtes prêt à continuer, sélectionnez Ajouter.

  7. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès au contenu de votre plugin pour générer ses réponses après que vous ayez rechargé la page.

Capture d’écran montrant une réponse de l’agent déclaratif qui contient du contenu de plug-in d’API

API Posts Document de description OpenAPI

La description suivante d’OpenAPI concerne l’API JSONPlaceHolder, une API REST en ligne gratuite que vous pouvez utiliser chaque fois que vous avez besoin de fausses données.

openapi: '3.0.2'
info:
  title: Posts API
  version: '1.0'
servers:
- url: https://jsonplaceholder.typicode.com/

components:
  schemas:
    post:
      type: object
      properties:
        userId:
          type: integer
          description: The ID of the user that authored the post.
        id:
          type: integer
        title:
          type: string
        body:
          type: string
    user:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        username:
          type: string
        email:
          type: string
        phone:
          type: string
        website:
          type: string
        address:
          $ref: '#/components/schemas/address'
        company:
          $ref: '#/components/schemas/company'
    address:
      type: object
      properties:
        street:
          type: string
        suite:
          type: string
        city:
          type: string
        zipcode:
          type: string
        geo:
          $ref: '#/components/schemas/coordinates'
    coordinates:
      type: object
      properties:
        lat:
          type: string
          description: The latitude of the location
        lng:
          type: string
          description: The longitude of the location
    company:
      type: object
      properties:
        name:
          type: string
        catchPhrase:
          type: string
        bs:
          type: string
  parameters:
    post-id:
      name: post-id
      in: path
      description: 'key: id of post'
      required: true
      style: simple
      schema:
        type: integer
    user-id:
      name: user-id
      in: path
      description: 'key: id of user'
      required: true
      style: simple
      schema:
        type: integer

paths:
  /posts:
    get:
      description: Get posts
      operationId: GetPosts
      parameters:
      - name: userId
        in: query
        description: Filter results by user ID
        required: false
        style: form
        schema:
          type: integer
          maxItems: 1
      - name: title
        in: query
        description: Filter results by title
        required: false
        style: form
        schema:
          type: string
          maxItems: 1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/post'
    post:
      description: 'Create post'
      operationId: CreatePost
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/post'
  /posts/{post-id}:
    get:
      description: 'Get post by ID'
      operationId: GetPostById
      parameters:
      - $ref: '#/components/parameters/post-id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/post'
    patch:
      description: 'Update post'
      operationId: UpdatePost
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post'
      parameters:
      - $ref: '#/components/parameters/post-id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/post'
    delete:
      description: 'Delete post'
      operationId: DeletePost
      parameters:
      - $ref: '#/components/parameters/post-id'
      responses:
        '200':
          description: OK
  /users:
    get:
      summary: Get users
      description: Returns details about users
      operationId: GetUsers
      parameters:
      - name: name
        in: query
        description: The user's real name
        schema:
          type: string
      - name: username
        in: query
        description: The user's login name
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/user'
  /users/{user-id}:
    get:
      description: 'Get user by ID'
      operationId: GetUserById
      parameters:
      - $ref: '#/components/parameters/user-id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/user'

Vous avez terminé le guide de l’agent déclaratif pour Microsoft 365 Copilot. Maintenant que vous êtes familiarisé avec les fonctionnalités d’un agent déclaratif, vous pouvez en savoir plus sur les agents déclaratifs dans les articles suivants.