Adicionar recursos e ações personalizadas a um agente declarativo criado com o Microsoft 365 Agents Toolkit

Dica

Recomendado: Comece com o Work IQ Dev Tools para cenários de plug-in e de agente declarativo de código profissional com suporte. Consulte o início rápido do WIQD. As instruções baseadas em kit de ferramentas permanecem disponíveis para projetos e fluxos de trabalho existentes que as exigem. Verifique a capacidade e o suporte à experiência de destino antes de escolher uma ferramenta: O WIQD não tem como alvo agentes de mecanismo personalizados.

Você pode aprimorar as habilidades do seu agente adicionando recursos ou ações personalizadas. Você pode aprimorar seu agente ativando recursos internos, como gerador de imagens ou interpretador de código, ou adicionando plug-ins MCP ou API como ações personalizadas. Este tutorial adiciona um plug-in de API. Para adicionar um servidor MCP, consulte Criar ou reutilizar servidores MCP e Criar um plug-in para um agente declarativo de um servidor MCP.

Importante

Este guia pressupõe que você concluiu o tutorial Criar agentes declarativos usando o Microsoft 365 Agents Toolkit e JSON .

Adicionar gerador de imagens ao agente

O recurso de gerador de imagens permite que os agentes gerem imagens com base em solicitações do usuário. Para adicionar o gerador de imagens:

  1. Abra o appPackage/declarativeAgent.json arquivo e adicione a GraphicArt entrada à capabilities matriz. Para obter mais informações, consulte Objeto de arte gráfica.

    {
      "name": "GraphicArt"
    }
    
  2. No painel Ciclo de Vida do Kit de Ferramentas de Agentes do Microsoft 365, selecione Provisionar.

O agente declarativo pode gerar imagens depois que você recarregar a página.

Observação

O gerador de imagens não está disponível para agentes em ambientes de GCCH (Nuvem da Comunidade Governamental – Alta) do Microsoft 365.

Uma captura de tela mostrando uma resposta do agente declarativo que contém arte gráfica gerada

Adicionar interpretador de código ao agente

O interpretador de código é uma ferramenta avançada projetada para resolver tarefas complexas por meio de código Python.

Observação

Em ambientes GCCH, o interpretador de código só está disponível para usuários com uma licença de complemento do Microsoft 365 Copilot.

  1. Abra o appPackage/declarativeAgent.json arquivo e adicione a CodeInterpreter entrada à capabilities matriz.

    {
      "name": "CodeInterpreter"
    }
    

    Para obter mais informações, consulte Objeto interpretador de código.

  2. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas de Agentes.

O agente declarativo tem o recurso interpretador de código depois que você recarrega a página.

Uma captura de tela mostrando uma resposta do agente declarativo que contém um grafo gerado

Uma captura de tela mostrando o código Python usado para gerar o grafo solicitado

Adicionar um plug-in de API como uma ação personalizada ao agente

Os plug-ins de API adicionam novas habilidades ao seu agente, permitindo que ele interaja com uma API REST.

Observação

Não há suporte para ações personalizadas em ambientes GCCH.

Antes de começar, crie um arquivo chamado posts-api.yml e adicione o código do documento de descrição da OpenAPI da API Posts.

  1. Selecione Adicionar Ação no painel Desenvolvimento do Kit de Ferramentas para Agentes.

  2. Selecione Iniciar com um documento de descrição do OpenAPI.

  3. Selecione Procurar e navegue até o posts-api.yml arquivo.

  4. Selecione todas as APIs disponíveis e selecione OK.

    Uma captura de tela da caixa de diálogo de seleção de API no Visual Studio Code

  5. Selecione manifest.json.

  6. Examine o aviso na caixa de diálogo. Quando estiver pronto para continuar, selecione Adicionar.

  7. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas de Agentes.

O agente declarativo tem acesso ao conteúdo do plug-in para gerar suas respostas depois que você recarrega a página.

Uma captura de tela mostrando uma resposta do agente declarativo que contém conteúdo de plug-in de API

Postagens API OpenAPI documento de descrição

A descrição de OpenAPI a seguir é para a API JSONPlaceHolder, uma API REST online gratuita que você pode usar sempre que precisar de alguns dados falsos.

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'

Você concluiu o guia do agente declarativo para o Microsoft 365 Copilot. Agora que você está familiarizado com os recursos de um agente declarativo, saiba mais sobre os agentes declarativos nos artigos a seguir.