Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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:
Abra o
appPackage/declarativeAgent.jsonarquivo e adicione aGraphicArtentrada àcapabilitiesmatriz. Para obter mais informações, consulte Objeto de arte gráfica.{ "name": "GraphicArt" }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.
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.
Abra o
appPackage/declarativeAgent.jsonarquivo e adicione aCodeInterpreterentrada àcapabilitiesmatriz.{ "name": "CodeInterpreter" }Para obter mais informações, consulte Objeto interpretador de código.
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.
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.
Selecione Adicionar Ação no painel Desenvolvimento do Kit de Ferramentas para Agentes.
Selecione Iniciar com um documento de descrição do OpenAPI.
Selecione Procurar e navegue até o
posts-api.ymlarquivo.Selecione todas as APIs disponíveis e selecione OK.
Selecione manifest.json.
Examine o aviso na caixa de diálogo. Quando estiver pronto para continuar, selecione Adicionar.
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.
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'
Conteúdo relacionado
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.
- Criar agentes declarativos usando o Microsoft 365 Agents Toolkit e TypeSpec
- Saiba como escrever instruções eficazes para seu agente.
- Teste seu agente com o modo de desenvolvedor para verificar se e como o orquestrador do Copilot seleciona suas fontes de conhecimento para uso em resposta a prompts fornecidos. Para obter mais informações, consulte Testar e depurar agentes no Microsoft 365 Agents Toolkit usando o modo de desenvolvedor.
- Obtenha respostas para perguntas frequentes.
- Saiba mais sobre outras maneiras de criar agentes declarativos: sem código no Construtor de Agentes ou com pouco código no Copilot Studio.