Visão geral de APIs do Microsoft 365 Copilot

As APIs do Microsoft 365 Copilot permitem que você acesse com segurança os recursos do Microsoft 365 Copilot em seus próprios aplicativos e agentes de mecanismo personalizados, enquanto se alinha aos padrões de conformidade do Microsoft 365. Se você estiver criando um agente de mecanismo personalizado para o Microsoft 365 Copilot com seus próprios modelos ou orquestrador ou uma experiência de conversação em seus próprios aplicativos, as APIs do Copilot fornecem acesso a componentes que potencializam as experiências do Microsoft 365 Copilot.

Os desenvolvedores corporativos enfrentam um desafio crítico hoje: como aproveitar o poder da IA e, ao mesmo tempo, manter o acesso seguro ao conhecimento organizacional, sem comprometer a conformidade ou a governança. As abordagens tradicionais forçam você a criar sistemas de IA complexos do zero e extrair dados confidenciais em fontes externas. As APIs do Microsoft 365 Copilot oferecem acesso a recursos de IA prontos para produção que funcionam diretamente com seus dados do Microsoft 365.

Ao acessar ou usar as APIs do Microsoft 365 Copilot, você concorda com os Termos de Uso das APIs do Microsoft 365 Copilot (versão prévia).

Dica

Você quer explorar as APIs antes de escrever código? Experimente a Demonstração Interativa para ver solicitações e respostas de API ao vivo com seus dados do Microsoft 365.

Recursos da API do Copilot

As APIs do Copilot fornecem um conjunto abrangente de recursos que permitem criar aplicativos com tecnologia de IA baseados em dados corporativos.

A tabela a seguir lista as APIs e descreve suas funcionalidades e cenários.

API Use-o para Cenário de exemplo
API de recuperação Recupere informações relevantes do conteúdo do Microsoft 365 de maneira segura e compatível. Conecte seus próprios modelos de IA ao conteúdo do Microsoft 365 sem extração de dados. Crie assistentes especializados que respondam com base na documentação, nas políticas e nas bases de conhecimento atualizadas da sua organização. Esses aplicativos podem fornecer informações contextualmente relevantes para usuários em todos os departamentos, respeitando os controles de acesso a documentos e rótulos de confidencialidade.
Pesquisar API (visualização) Realize pesquisas híbridas (semânticas e lexicais) no OneDrive para conteúdo corporativo ou de estudante usando consultas em linguagem natural com compreensão contextual e resultados inteligentes. Crie aplicativos de pesquisa com tecnologia de IA que ajudam os usuários a descobrir documentos e arquivos relevantes usando consultas em linguagem natural em vez de correspondências exatas de palavras-chave, mantendo a segurança e a conformidade.
API de Exportação de Interação Habilite soluções de conformidade para capturar e arquivar interações do usuário com o Copilot em aplicativos do Microsoft 365. Desenvolva sistemas que mantenham registros abrangentes das interações com a IA, permitam o monitoramento do uso da IA e garantam a conformidade com as políticas organizacionais e os requisitos regulatórios. Essas soluções são valiosas para setores regulamentados em que é necessário documentar e revisar a geração de conteúdo assistida por IA.
API de Notificações de Alteração de Interações de IA (versão prévia) Assine as notificações de alteração para interações do Copilot no Microsoft 365. Crie aplicativos que monitoram e registram interações de IA em tempo real, permitindo verificações proativas de conformidade, detecção de anomalias e auditoria.
API de insights de reunião Extraia anotações de reunião, itens de ação e tópicos de discussão gerados por IA para reuniões do Teams. Crie aplicativos que extraem e organizam automaticamente itens de ação, decisões e resumos de reuniões do Teams. Vincule-os a ferramentas de gerenciamento de projetos, sistemas de CRM ou fluxos de trabalho personalizados. Esses sistemas podem transformar reuniões de tempo gasto em valor criado capturando, organizando e ativando os resultados da reunião automaticamente.
API de Notificações de Alteração do Insights da IA (versão prévia) Assine as notificações de alteração para o Copilot Insights da IA da IA das reuniões do Teams. Crie aplicativos que usam o Teams reunindo o Insights da IA, garantindo a captura consistente dos principais detalhes e promovendo o alinhamento.
API de Chat (versão prévia) Habilite experiências de conversa da plataforma Microsoft 365 Copilot em seus aplicativos personalizados. Integre o Microsoft 365 Copilot aos seus aplicativos empresariais que podem responder a perguntas, executar tarefas e fornecer orientações com base nos dados do Microsoft 365 e no contexto do usuário. Essas interfaces podem melhorar a produtividade do usuário, trazendo recursos de IA diretamente para as ferramentas que eles usam todos os dias, desde portais personalizados até aplicativos móveis.
API de relatórios de uso do Copilot Consulte as contagens de usuários e os dados de uso do Microsoft 365 Copilot em sua organização. Crie relatórios para acompanhar a adoção do Microsoft 365 Copilot por seus usuários.
API de gerenciamento de pacotes Visualize e gerencie agentes em toda a sua organização. Crie um inventário de todos os agentes em sua organização.

Observação

A API do Chat retorna respostas textuais; ela responde a perguntas e fornece orientações, mas não executa ações como criar arquivos, enviar emails ou agendar reuniões. Para obter detalhes, consulte as limitações conhecidas da API do Chat.

Principais benefícios

As APIs do Copilot fornecem os seguintes benefícios para seus aplicativos:

  • Fundamento seguro, governança e conformidade - Acesse o índice de conhecimento do Microsoft 365 diretamente. Todas as permissões existentes, rótulos de confidencialidade, controles de conformidade, auditoria, registro em log, monitoramento e imposição de políticas são respeitados automaticamente. Para obter mais informações sobre o modelo de segurança e autenticação, confira Segurança e autenticação para APIs do Microsoft 365 Copilot.
  • IA pronta para produção – acelere o desenvolvimento de seus pipelines personalizados de RAG (Geração Aumentada de Recuperação) e o processamento de transcrição de reunião usando os mesmos recursos de IA de nível de produção que alimentam o Microsoft 365 Copilot. Independentemente de você desenvolver suas soluções usando o Fábrica de IA do Azure, o Microsoft Copilot Studio ou o SDK do Microsoft Agents, as APIs do Copilot são perfeitamente integradas à plataforma.
  • IA responsável – ao usar essas experiências inteligentes e do Copilot, você está protegido contra conteúdo prejudicial por meio de verificações de validação de RAI.

Requisitos

Para integrar e desbloquear todo o potencial das APIs do Copilot em seus aplicativos e agentes de mecanismo personalizados, você precisa ter acesso ao seguinte:

  • Licença do Microsoft 365 Copilot - Necessária para cada usuário que acessa a funcionalidade do Microsoft 365 Copilot por meio dessas APIs. Essa licença fornece acesso aos recursos de IA que alimentam as APIs.

  • Assinatura do Microsoft 365: uma assinatura E3 ou E5 (ou equivalente) é a base para o Microsoft 365 Copilot. Essa assinatura fornece acesso aos serviços e dados do Microsoft 365 nos quais o Copilot se baseia.

Do registro do aplicativo ao cliente da API

A criação de um agente ou aplicativo para o Microsoft 365 segue uma cadeia que conecta o Modelo de Aplicativo às APIs do Copilot:

  1. Você cria um pacote do aplicativo — o pacote de manifesto, ícones e metadados definidos pelo Modelo de Aplicativo do Microsoft 365.
  2. Como parte desse pacote, você executa um registro de aplicativo no Microsoft Entra ID, que produz um ID de aplicativo (cliente).
  3. No tempo de execução, você fornece essa ID do aplicativo (cliente) a um provedor de autenticação (como o MSAL) para adquirir tokens de acesso em nome do usuário conectado.
  4. Você passa o token resultante ao chamar as APIs do Copilot (por exemplo, a API de recuperação).

O registro do aplicativo é a ponte entre o modelo de empacotamento e o modelo de consumo de API — é onde a identidade do pacote do aplicativo se torna a credencial que autoriza as chamadas à API do Copilot.

O id campo no manifesto do aplicativo e a ID do aplicativo Entra (cliente) são identificadores diferentes que servem a propósitos diferentes. O manifesto id identifica seu aplicativo dentro do sistema de empacotamento e distribuição do Microsoft 365 e é usado para o gerenciamento do ciclo de vida do aplicativo (publicação, atualização, sideload). A ID do aplicativo Entra (cliente) é usada para autenticação OAuth quando seu aplicativo chama as APIs do Copilot.

Para obter detalhes sobre o pacote do aplicativo, os campos de manifesto e a distribuição, consulte Agentes são aplicativos para Microsoft 365. Para obter uma explicação completa de como as políticas organizacionais e de autenticação se aplicam às chamadas de API do Copilot, consulte Segurança e autenticação para APIs do Microsoft 365 Copilot.

Observação

Ferramentas de desenvolvimento do Work IQ (versão prévia) — Se você estiver criando um agente declarativo, wiqd poderá reduzir esta etapa de configuração: com ambientes nomeados, wiqd agent provision executa o registro do aplicativo Microsoft 365 para o agente e grava as IDs resultantes de volta no arquivo do ambiente, portanto, o registro do aplicativo não é uma primeira etapa manual. Esse processo se aplica ao provisionamento de agentes declarativos, não aos clientes da API do Copilot em geral. Para obter mais informações, consulte a documentação do Work IQ Dev Tools.

Integração da API REST

As APIs do Copilot estão disponíveis como APIs REST padrão no namespace do Microsoft Graph (graph.microsoft.com/v1.0/copilot e graph.microsoft.com/beta/copilot). Essa integração torna as APIs acessíveis de qualquer linguagem de programação ou plataforma que suporte solicitações HTTP. As APIs usam o mesmo processo de autenticação e autorização que outras APIs do Microsoft Graph usam. Todas as APIs do Copilot respeitam as políticas existentes da sua organização, incluindo acesso de identidade, acesso condicional, rótulos de confidencialidade e filtragem de permissão, por padrão.

APIs do Copilot versus APIs do Microsoft Graph

As APIs do Microsoft Graph geralmente fornecem operações CRUD em dados do Microsoft 365. As APIs do Copilot oferecem recursos baseados em IA criados com base nos dados do Microsoft 365. Use APIs do Microsoft Graph quando precisar manipular e acessar dados; use as APIs do Copilot quando precisar de IA para raciocinar sobre esses dados. Essa diferença fundamental se reflete no modelo de licenciamento: as APIs do Microsoft Graph estão disponíveis nos termos de licença padrão do Microsoft 365; as APIs do Copilot exigem uma licença do Microsoft 365 Copilot. Esse modelo de licenciamento oferece recursos de IA de maior valor além do acesso a dados padrão.

Conteúdo relacionado

  • Last updated on