Estender o Microsoft 365 Copilot com os agentes

O Microsoft 365 Copilot fornece experiências padrão para interagir com conteúdo e recursos de toda a organização. Embora a funcionalidade padrão forneça muitos recursos úteis, às vezes os clientes precisam interagir com um assistente de conversa mais focado, acessível diretamente no Microsoft 365 Copilot. Um exemplo de onde um assistente mais focado é útil é quando você precisa de suporte para uma área específica com vocabulário especializado, baseado em uma base de conhecimento específica do assunto.

Você pode ajudar o Microsoft 365 Copilot a lidar com essas situações estendendo-as com um agente especializado integrado ao Copilot Studio.

Há duas maneiras diferentes de adicionar os agentes ao Microsoft 365 Copilot:

• Agentes personalizados
• Agentes do Copilot

Observação

Agentes copilot são chamados de agentes declarativos no Microsoft 365 Copilot. Saiba mais sobre a extensibilidade do Microsoft 365 Copilot.

Este artigo aborda:

• Criando um agente personalizado
• Criando um agente do Copilot
• Adicionando ferramentas e conhecimento a um agente
• Publicando o agente personalizado para o Microsoft 365 Copilot e o Microsoft Teams

O que são ferramentas, conhecimento, prompts sugeridos e agentes do Copilot?

A tabela a seguir fornece informações mais detalhadas sobre as distinções entre ferramentas, conhecimento do copiloto, prompts sugeridos e agentes do Copilot.

Nome	Definição
agente personalizado	Um agente personalizado é um agente que um criador cria do zero. Um agente personalizado pode incluir uma ampla gama de recursos, incluindo conhecimento, ações e prompts sugeridos. Os agentes personalizados são criados em uma interface de conversa que gera prompts para o modelo do Copilot Studio. Os agentes personalizados podem ser publicados no canal do Microsoft 365 Copilot e no Teams, mas também podem ser usados com outros canais.
Agente do Copilot	Um agente do Copilot é criado no Copilot Studio criando um prompt para o Microsoft 365 Copilot. Esse prompt é usado para definir um conjunto de comportamentos, personalidades e regras de runtime que governam as interações do agente. Um agente do Copilot é equivalente a um agente declarativo criado no construtor de agente do Microsoft 365 Copilot. Um agente do Copilot é usado no contexto de estender o Microsoft 365 Copilot e pode ser equipado com ações e conhecimento. Um agente do Copilot pode ser usado diretamente como um agente no Microsoft Teams.
Ferramenta	O mecanismo que permite que um agente chame outros sistemas e recupere dados ou execute outras ações. As ferramentas são interações únicas. As ferramentas podem usar a autenticação e podem incluir parâmetros e outras funcionalidades. Consulte Usar ferramentas com agentes personalizados.
Conhecimento	O conhecimento refere-se às informações que residem em seu locatário do Microsoft 365, incluindo conectores do SharePoint e do Graph.
Pedido sugerido	Os prompts sugeridos são prompts criados pelo criador em um agente que facilitam para os clientes executar ações comuns ou sofisticadas com o agente.

Mantendo os agentes seguros

Os clientes e parceiros do Microsoft 365 podem criar agentes copilot que estendem o Microsoft 365 Copilot com instruções personalizadas, conhecimento de aterramento e ferramentas invocadas por meio de descrições da API REST configuradas pelo agente. As ferramentas capturam dados que influenciam o comportamento do seu Microsoft 365 Copilot, inclusive de fontes não confiáveis, como emails e tíquetes de suporte. Os invasores podem criar cargas úteis nessas fontes não confiáveis para manipular o comportamento do agente, como responder incorretamente a perguntas ou invocar ações personalizadas.

Para proteger seu agente contra ataques, use os controles no Copilot Studio para configurar conectores seguros usados para conhecimento e ações personalizadas.

Pré-requisitos

• Usuários e criadores devem ter uma licença para usar o Microsoft 365 Copilot.
• Os criadores devem ter permissões para criar e ter acesso a um ambiente do Copilot Studio.

Criar e configurar um agente personalizado

Confira os seguintes artigos para obter detalhes sobre a criação e configuração para agentes personalizados:

• Criar um agente personalizado
• Adicionar conhecimento a um agente personalizado
• Adicionar ferramentas a um agente personalizado

Crie um agente do Copilot

A criação de agentes do Copilot no Copilot Studio é semelhante à de agentes personalizados, pois usa uma experiência de criação de conversa.

No entanto, o ponto de partida é diferente para os agentes Copilot.

Os agentes personalizados usam o fluxo de criação do agente principal por meio de Criar>Novo agente ou Agentes>Novo agente.

Os agentes do Copilot, por outro lado, são criados a partir da página do agente do Copilot para o Microsoft 365 em Agentes.

Para criar um agente do Copilot para o Microsoft 365 Copilot:

1. Faça login no Copilot Studio em https://copilotstudio.microsoft.com

2. Navegue até Agentes no painel de navegação do lado esquerdo.

3. Selecione Copilot para Microsoft 365 na lista de agentes.

4. A partir daqui, selecione Adicionar no cartão Agentes. Você será enviado para a experiência de criação de conversa.

5. Em frases completas, descreva o que o agente deve ser capaz de fazer e saber.

6. Quando a interação for concluída, selecione Terminei no chat.

   Observação

   Ignore a interface de conversa a qualquer momento, escolhendo Ignorar para configurar.

7. Selecione Criar para acessar a página de visão geral do agente.

O agente do Copilot agora foi criado. Você pode interagir com o agente na tela de teste ou adicionar mais recursos e conhecimento a ele. Até agora, o agente não tem fontes de conhecimento adicionadas. A única informação que o agente tem são os dados fornecidos nas instruções. O agente não tem acesso ao conhecimento corporativo ou a quaisquer outras ações no momento, portanto, todas as respostas são fornecidas a partir do próprio conhecimento da IA generativa.

Você pode ver o agente do Copilot recém-criado na guia Agentes na página do Copilot para Microsoft 365. Como o agente não é um agente personalizado, ele não aparece na lista de agentes principais.

Adicionar conhecimento a um agente do Copilot

Quando você cria um agente pela primeira vez, ele começa apenas com o conhecimento básico de IA generativa. O agente não tem conhecimento de nenhuma outra fonte de dados. Para dar mais conhecimento, adicione conhecimento na página Visão Geral do seu agente ou na página Conhecimento.

Há três tipos principais de conhecimento que podem ser adicionados a um agente:

Nome	Definição
SharePoint	Caminhos para recursos do SharePoint na organização. O Microsoft 365 Copilot usa as credenciais do usuário para garantir que ele receba apenas respostas de informações às quais eles tem acesso.
Conectores do Copilot (Graph)	Os conectores são fontes de dados configuradas pelo administrador do locatário para adicionar conhecimento ao Microsoft Copilot e aos agentes. Saiba mais sobre conectores copilot
Pesquisa na Web	O agente também pode usar a pesquisa na Web pública (via Bing) para recuperar resultados da Web

Observação

A Pesquisa na Web é configurada por meio do cartão de recursos na página de visão geral, não na página de conhecimento.

Para começar a adicionar conhecimento ao agente:

1. Retorne à página de visão geral do agente.
2. No cartão Conhecimento, selecione Adicionar Conhecimento.
3. Escolher uma fonte de dados.
   • Se você estiver usando o SharePoint, forneça um caminho para a raiz da biblioteca ou do site. Uma única página ou arquivo que está sendo especificado não é compatível no momento.
   • Se você estiver usando um conector Copilot e o administrador configurou um conector Copilot no Microsoft 365, você poderá escolher um conector Copilot nas fontes de dados configuradas.
   • A pesquisa na Web pode ser habilitada/desabilitada na página de visão geral do agente no cartão Configurações Adicionais .

Várias fontes de conhecimento podem ser adicionadas com uma mistura de tipos para um agente. Além disso, para o SharePoint, até quatro caminhos podem ser incluídos.

Com as fontes de conhecimento configuradas, o agente com conhecimento fica imediatamente disponível no chat de teste. Feche o painel de conhecimento, escolha a gesto de atualização na parte superior do chat de teste para obter um novo chat e, em seguida, tente fazer perguntas que devem estar presentes na fonte de dados.

Observação

Se os resultados não forem retornados, envie comentários para Microsoft para análise e melhoria do produto.

Adicionar uma ferramenta a um agente do Copilot

Uma ferramenta é usada para permitir que um agente recupere informações ou execute uma tarefa, como atualizar um registro ou concluir uma transação. As ferramentas podem ser criadas a partir de conectores Copilot (também conhecidos como conectores do Power Platform). Os tipos de ação incluem prompts do AI Builder, conectores predefinidos e conectores personalizados. Para obter mais informações sobre conectores Copilot, consulte Adicionar ações a agentes personalizados.

Observação

Atualmente, os agentes do Copilot não dão suporte aos fluxos de agente.

Adicionar uma ferramenta requer um planejamento extra por parte do criador versus a adição de conhecimento. Várias considerações ocorrem:

• A ferramenta deve usar a autenticação do usuário ou a autenticação do fabricante?
• O criador pode fornecer descrições para informar a IA generativa quando e como invocar a ferramenta?
• Os parâmetros da função devem ser sempre preenchidos automaticamente ou o criador deve preenchê-los no momento da criação?

Cada uma dessas considerações entra em jogo ao adicionar ferramentas a um agente.

Para adicionar uma ferramenta:

1. Retorne à página de visão geral do agente Copilot.

2. No cartão Ferramentas , escolha Adicionar ferramenta.

3. Pesquise a ferramenta desejada ou escolha Nova ferramenta.

   Se você selecionar Nova ferramenta, você receberá um painel Adicionar ferramentas , no qual poderá selecionar o tipo de ferramenta a ser adicionada. As opções disponíveis são:

   • Rápido
   • Uso do computador
   • Conector personalizado
   • API REST
   • Protocolo de contexto do modelo

   Os fluxos de agente não estão disponíveis no momento como uma opção para estender os agentes do Copilot.

4. Para cada uma das novas opções de ferramenta, depois de selecionar o tipo de nova ferramenta a ser adicionada, você será levado por meio de uma experiência guiada para criar a ferramenta. A experiência é semelhante à usada para adicionar uma nova ferramenta a um agente personalizado.

Exibir e atualizar configurações de ferramentas

Depois de criar uma ferramenta, ela aparecerá na lista de ferramentas na página de visão geral do agente, em Ferramentas. Você pode selecionar a entrada da ferramenta para exibir e editar a configuração da ferramenta. Na configuração da ferramenta, existem três abas:

• Detalhes
• Entradas
• Saídas

Seção Detalhes

A seção Detalhes é usada para configurar o nome da ferramenta, o nome de exibição e a descrição.

• Nome da ferramenta: o nome da ação, conforme visto no Microsoft 365 Copilot nas citações. Essas informações também podem ser influentes para ajudar o Microsoft 365 Copilot a escolher a ação a ser executada.
• Nome de exibição: nome amigável para a ação, conforme visto na experiência do usuário do Microsoft 365 Copilot.
• Descrição para o agente saber quando usar essa ferramenta: uma descrição de conversa completa de quando o Copilot deve usar essa ação e o tipo de perguntas que a disparam.

Seções de entradas e saídas

O Copilot Studio preenche automaticamente um conjunto de entradas e saídas inspecionando o objeto do conector. O criador pode permitir que Copilot preencha esses campos ou preencha-os manualmente durante a criação.

Por padrão, nenhuma personalização é necessária nessa experiência, a menos que o criador opte por preencher manualmente um campo ou opte por substituir uma descrição.

Teste sua ferramenta

Depois de fazer ajustes, você pode testar a ferramenta no chat de teste do Copilot Studio. Selecione Atualizar na parte superior do chat de teste e faça uma pergunta que deve chamar a ação.

Na primeira vez que o usuário dispara a ação, o agente apresenta um cartão de conexão no chat. Esse cartão é usado para solicitar que o usuário entre na ação com suas próprias credenciais ou use suas credenciais de SSO (logon único), conforme aplicável.

Pedidos sugeridos

Muitas vezes, quando os usuários interagem pela primeira vez com qualquer tipo de agente, eles não sabem o que podem perguntar ou não entendem a riqueza do agente. Como resultado, eles tendem a fazer perguntas simples. O Microsoft 365 Copilot resolve esse problema oferecendo uma experiência com sugestões de prompts. Os prompts sugeridos são apresentados ao usuário com prompts fáceis de introdução.

O Copilot Studio gera automaticamente prompts sugeridos quando você usa a experiência de conversação para criar seu agente. Você também pode editar ou criar o seu próprio a qualquer momento na seção Prompts Sugeridos na página Visão Geral .

Reconhecimento de prompts sugeridos

Uma maneira de usar os prompts sugeridos é como um atalho para perguntas simples que você espera que os usuários façam. No entanto, eles também são uma oportunidade de apresentar prompts mais sofisticados que, de outra forma, o usuário talvez não entendesse que são possíveis.

Nos prompts sugeridos, os autores de agente têm acesso total a recursos do modelo de linguagem grande do Microsoft 365 Copilot, inclusive as ações e o conhecimento adicionados por você. Considere a criação de prompts sofisticados que ajudem os usuários a realizar tarefas comuns com facilidade.

Prompts sugeridos pelo autor

1. Vá para a página visão geral do agente.
2. Role para baixo até os prompts sugeridos e selecione Editar.
3. Adicione até seis prompts sugeridos e selecione Salvar.

Publicar um agente personalizado no canal do Teams + Microsoft 365

Você também pode estender o Microsoft 365 Copilot com um agente personalizado publicando o agente no canal + Microsoft 365 do Teams. Consulte Conectar e configurar um agente para o Teams e Microsoft 365 para obter detalhes sobre como publicar seu agente personalizado no canal + Microsoft 365 do Teams.

Publicando um agente do Copilot

Quando o agente estiver trabalhando como você deseja na experiência de teste do Copilot Studio, você estará pronto para publicar. A publicação converte o agente de um estado de rascunho em um estado publicado, pronto para ser carregado no catálogo da organização. Ao contrário de um agente autônomo, um agente do Copilot não é implantado automaticamente no Microsoft 365 Copilot e no Teams quando publicado.

Publicar seu agente do Copilot

1. Navegue de volta à página Visão geral do agente.

2. Escolha Publicar no canto superior direito.

   As informações no formulário subsequente são usadas para preencher a entrada de catálogo nos Catálogos do Office e do Teams da organização e na lista de Aplicativos Integrados do Centro de Administração da Microsoft. Ele não é usado pelo modelo de linguagem do Microsoft 365 Copilot.

3. Preencha os campos, conforme necessário, e selecione Publicar.

   Quando a operação estiver concluída, você será levado para a página Opções de disponibilidade.

Observação

Quando você seleciona Publicar, um recurso de bot é provisionado no ambiente do Microsoft Entra ID do locatário, correspondente ao agente do Copilot. O recurso permite que os usuários interajam com o agente no Microsoft Teams.

Definir opções de disponibilidade

A página Opções de disponibilidade é usada para distribuir o agente à conta do criador do agente a ser usada ou para pequenos grupos de pares regidos por listas de distribuição ou para ser publicada no catálogo da organização por um administrador.

Observação

Se um administrador desabilitou o carregamento lateral ou a publicação para o locatário, um ou mais desses recursos poderão ser bloqueados. Trabalhe com o administrador do locatário para determinar o mecanismo de distribuição apropriado para o locatário.

Opção de Disponibilidade	Descrição
Link de Compartilhamento	Você pode copiar um link profundo no Microsoft Teams para chamar o agente publicado. Abrir o link no locatário abre uma experiência de chat com o agente.
Mostrar aos meus colegas de equipe e usuários compartilhados	Permite que você conceda acesso a outras pessoas para participar da criação do agente ou a grupos de segurança para conceder a elas acesso para usar o agente no Microsoft 365 Chat ou Teams.
Mostrar a todos na minha organização	Envie ao administrador do locatário para adicionar ao catálogo organizacional para que todos os usuários do locatário façam a instalação desejada.
Baixar como um .zip	Baixar como uma pasta zip. Essa opção de disponibilidade permite que você carregue manualmente no Teams/Microsoft 365 Copilot para enviar ao administrador para revisão ou carregar diretamente no catálogo organizacional.

Mais informações sobre o gerenciamento de aplicativos no catálogo do Teams podem ser encontradas aqui: Gerenciar aplicativos do Power Platform

Use o agente do Copilot no Microsoft 365 Copilot ou no Microsoft Teams

O agente agora deve estar disponível para experimentar no Microsoft 365 Copilot ou no Teams. Os usuários podem interagir com o agente pelo @mentioning agente na interface de chat do Microsoft 365 Copilot ou selecionando o agente na barra lateral. Depois que um usuário seleciona um agente, o usuário interage apenas com o agente até terminar essa conversa e retornar ao Copilot ou ao Teams.

Na captura de tela abaixo, o usuário solicita informações que estejam no conhecimento incluído no agente. A IA generativa, avaliando as instruções, o conhecimento e as ações do agente, determina que a melhor maneira de solucionar a solicitação é usando seu conhecimento para gerar uma resposta. A IA generativa também inclui referências para as fontes que usa para gerar a resposta.

Dicas para criadores de agente

• O Microsoft 365 Copilot armazena em cache respostas de perguntas feitas anteriormente em uma determinada sessão, mesmo que tenha chamado uma ação para recuperar os dados. Para quebrar esse cache, use o botão Novo Chat.
• Para ver mais informações sobre por que a IA generativa seleciona ou não uma ação, insira o desenvolvedor na caixa de entrada do Microsoft 365 Copilot e faça a pergunta.
• Os resultados que você vê no runtime no Microsoft 365 Copilot podem ser diferentes dos que você vê na tela de teste do Copilot Studio e no Microsoft Teams.
• Ao contrário dos agentes personalizados, os agentes do Copilot não coletam dados na guia Análise do Copilot Studio. Esse recurso está sendo avaliado para versões futuras.
• Ao usar o Microsoft 365 Copilot para testar seu agente, use a experiência de comentários de polegar para baixo para fornecer comentários à equipe do Microsoft Copilot para revisar e resolver problemas. O feedback não afeta diretamente a qualidade do acionamento do Microsoft 365 Copilot.