Referência ao Copilot (prévia)

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

Importante

Esta é uma funcionalidade de pré-visualização.

  • Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
  • Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
  • A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
  • Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Note

Ferramentas específicas para Microsoft 365 MCP (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User e Word) são destinadas apenas a fins de retrocompatibilidade e não devem ser usadas em ambientes de produção ou novos projetos. Para novos projetos que exigem acesso a recursos do Microsoft 365, use o Work IQ MCP com o harness do GitHub Copilot. Para mais informações, veja Work IQ MCP no Copilot Studio.

Visão geral

ID de servidor URL no nível do locatário Nome de exibição Descrição
mcp_M365Copilot https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/
servers/mcp_M365Copilot		 Copilot Ferramenta para qualquer solicitação de usuário que possa exigir encontrar, pesquisar, descobrir ou localizar informações contidas no conteúdo do Microsoft 365 — incluindo documentos, PDFs, planilhas, e-mails, sites, relatórios ou arquivos — independentemente de a pergunta parecer geral ou específica de domínio.

Se o pedido do usuário puder plausivelmente ser respondido usando conteúdo organizacional, você deve invocar essa ferramenta, a menos que exista uma ferramenta específica para a carga de trabalho para esse cenário. Quando nenhuma ferramenta dedicada (email, calendário, Teams, OneDrive, SharePoint etc.) estiver disponível, essa ferramenta se tornará o principal mecanismo de recuperação.

Se a solicitação mencionar uma carga de trabalho específica e sua ferramenta não estiver disponível, você pode usar essa ferramenta de busca como plano B. Se a ferramenta de busca não conseguir recuperar a informação, deixe claro que ela não está acessível pelas ferramentas disponíveis, em vez de responder pelo conhecimento geral.

Ferramentas disponíveis

Bate-papo do Copilot

Descrição: pesquise em seu ecossistema de Microsoft 365, incluindo sites do SharePoint, arquivos do OneDrive, mensagens de email, chats do Teams e outros conteúdos de Microsoft 365 conectados, para localizar informações armazenadas em sua organização.

Essa ferramenta permite a descoberta de documentos, PDFs, planilhas, apresentações, emails, sites e outros conteúdos corporativos consultando suas fontes de dados Microsoft 365. Use essa ferramenta sempre que a solicitação do usuário puder envolver informações que possam existir dentro de Microsoft 365 ou quando mais contexto organizacional puder ser útil além do conhecimento geral.

Se uma ferramenta específica da carga de trabalho (e-mail, calendário, Teams, etc.) não estiver disponível para uma solicitação que faça referência a essa carga de trabalho, essa ferramenta de busca pode ser usada como um recurso para tentar a recuperação. Se uma conversationId já estiver fornecida, a ferramenta continuará o mesmo thread; caso contrário, uma nova conversa será criada automaticamente.

Parâmetros requeridos:

  • Mensagem: O texto da mensagem de chat do usuário a ser enviado para Copilot

Parâmetros opcionais:

  • conversationId: ID da conversa existente do Microsoft Copilot (isso é criado automaticamente se estiver faltando)
  • agentId: ID do agente para a conversa do Microsoft Copilot (isso só é enviado quando fornecido)
  • fileUris: Matriz de referências de arquivo com propriedade URI para fundamentar a resposta (SharePoint, OneDrive, etc.)

Características principais

Integração com Microsoft Copilot

  • Integração de chat direto com Microsoft Copilot
  • Suporte para conversa multi-turno
  • IDs persistentes de conversa para retenção de contexto

Chat Contextual

  • Suporte ao contexto de localização e fuso horário
  • Aterramento de arquivos para respostas contextuais
  • Anexar arquivos como recursos contextuais

Gerenciamento de Conversa

  • Iniciar uma nova conversa
  • Continue as conversas existentes com conversationId
  • Conversas específicas para agentes

Casos de uso

  • Pesquisando documentos, PDFs, planilhas e apresentações no Microsoft 365
  • Localizando informações em emails, chats do Teams e sites de SharePoint
  • Descobrir conteúdo organizacional quando a questão pode ser específica de um domínio
  • Pesquisa de contingência quando as ferramentas específicas para a carga de trabalho não estão disponíveis
  • Basear respostas em URIs de arquivo específicas do SharePoint ou OneDrive
  • Manter o contexto da conversa em conversationId interações múltiplas
  • Última atualização em