Descrição geral da API de Pesquisa do Microsoft 365 Copilot (pré-visualização)

As APIs Microsoft 365 Copilot fornecem acesso a componentes que alimentam experiências do Copilot. Com estas APIs, pode melhorar os seus agentes de motor personalizados e soluções de IA geradoras com capacidades copilot. A API de Pesquisa copilot permite que os programadores efetuem pesquisas híbridas (semânticas e lexical) em conteúdos escolares ou profissionais do OneDrive através de consultas de linguagem natural que compreendem o contexto e a intenção de devolver documentos e ficheiros relevantes. Outras origens de dados, como o SharePoint, o Copilot Connectors e muito mais, não são atualmente suportadas pela API de Pesquisa, mas serão adicionadas em versões futuras. Para obter detalhes adicionais sobre a indexação semântica, veja Microsoft 365 Copilot índice semântico.

A API de Pesquisa oferece uma solução simplificada para a deteção de documentos semânticos sem a necessidade de replicar, indexar ou gerir os seus dados numa infraestrutura de pesquisa separada. A API aplica o processamento de linguagem natural para compreender a intenção da consulta e executa uma classificação de resultados inteligente para produzir os documentos mais relevantes. Alcançar esta relevância é mais difícil com as abordagens de pesquisa tradicionais baseadas em palavra-chave.

A pesquisa semântica é essencial quando está a criar soluções inteligentes de deteção de conhecimentos e quer apresentar conteúdos do Microsoft 365. Quando implementa a pesquisa semântica, as suas soluções podem fornecer uma deteção de documentos mais precisa e contextualmente relevante fundamentada no vasto repositório dos dados organizacionais. A API de Pesquisa consegue-o ao fornecer ficheiros, pré-visualizações de ficheiros e metadados de ficheiros relevantes do OneDrive para conteúdos escolares ou profissionais. A API de Pesquisa mantém os seus dados implementados e mantém os seus controlos de acesso e governação. A API de Pesquisa garante que os resultados da pesquisa são informados pelos conteúdos mais recentes e relevantes. Este processo melhora a fiabilidade e a utilidade das suas aplicações de pesquisa personalizadas com tecnologia de IA.

Experimente a primeira consulta da API de Pesquisa no Graph Explorer.

Porquê utilizar a API de Pesquisa?

A API de Pesquisa oferece uma forma segura e compatível de executar a pesquisa híbrida (semântica e lexical) em todo o OneDrive para conteúdos escolares ou profissionais, ao mesmo tempo que otimiza a relevância contextual e a compreensão das intenções do utilizador. Assim, não precisa de saída de dados, de interromper permissões ou de comprometer a segurança e a conformidade.

As aplicações de pesquisa personalizadas com tecnologia de IA podem utilizar a API de Pesquisa para detetar documentos armazenados no OneDrive. Em vez de criar e manter índices de pesquisa separados, estas aplicações podem, em vez disso, aplicar capacidades de pesquisa híbrida ao conteúdo do OneDrive para apresentar conteúdos relevantes da mesma forma que Microsoft 365 Copilot Pesquisa.

As aplicações de conhecimento empresariais que necessitam de deteção inteligente de documentos podem utilizar as capacidades de filtragem da API para definir o âmbito de pesquisas para pastas ou caminhos específicos do OneDrive. Esta abordagem garante que os resultados só incluem origens aprovadas, respeitando as barreiras de informação e os controlos de acesso.

As aplicações centradas em documentos podem combinar a compreensão semântica com a filtragem baseada no caminho para criar experiências de pesquisa intuitivas que ajudam os utilizadores a encontrar rapidamente os documentos certos com base em descrições de linguagem natural em vez de correspondências exatas de palavra-chave.

Gerir riscos de conformidade e segurança

A API de Pesquisa utiliza as funcionalidades de conformidade e segurança incorporadas no Microsoft 365 para garantir que as permissões da origem de dados e as definições de compatibilidade são preservadas. Ao procurar dados no local, impede fugas de dados e garante que as informações confidenciais só estão acessíveis aos utilizadores autorizados. Esta capacidade é essencial para manter normas rigorosas de segurança e conformidade. Dentro de uma organização, o modelo de permissões do Microsoft 365 garante que as pessoas só podem obter resultados do conteúdo a que têm permissão para aceder.

Resolver problemas de relevância e atualização

Uma vez que a API de Pesquisa efetua uma pesquisa híbrida diretamente no conteúdo do OneDrive sem duplicação de dados, os resultados são mantidos atualizados e relevantes. Elimina a necessidade de manter infraestruturas de pesquisa separadas e dispendiosas.

Menor custo de posse e esforço de desenvolvimento

A API de Pesquisa elimina a necessidade de criar um pipeline de indexação de pesquisa e exportação de dados seguro que pode incorrer em custos significativos para as organizações. A API suporta as seguintes capacidades necessárias, incluindo:

• Pesquisa híbrida (semântica e lexical)
• Processamento de linguagem natural
• Indexação de conteúdos
• Armazenamento de dados
• Filtragem baseada no caminho com QL por palavra-chave (KQL)
• Segurança e conformidade

Utilize estas funcionalidades incorporadas para evitar despesas e complexidades e manter rigorosos controlos de acesso e conformidade no Microsoft 365.

Licenciamento

A API de Pesquisa está disponível sem custos adicionais para os utilizadores com um suplemento de licença Microsoft 365 Copilot. O suporte para utilizadores sem uma licença de suplemento Microsoft 365 Copilot não está atualmente disponível.

Ao aceder ou utilizar a API de Pesquisa do Microsoft 365 Copilot, está a concordar com os Termos de Utilização (pré-visualização) das APIs Microsoft 365 Copilot.

Práticas recomendadas

As seguintes melhores práticas aplicam-se a consultas não filtradas (consultas sem ) filterExpressione consultas filtradas (consultas com um filterExpression):

• A API de Pesquisa devolve resultados ordenados por relevância.
• Utilize todos os resultados de pesquisa devolvidos pela API de Pesquisa para deteção de documentos abrangente.
• Evite consultas demasiado genéricas que possam aplicar-se a uma grande variedade de conteúdos.
• Forneça o máximo de contexto possível na consulta para uma melhor compreensão semântica.
• Torne a sua query linguagem descritiva e natural baseada em linguagem.
• Evite erros ortográficos em palavras-chave importantes ao construir o seu query.

Aplique a seguinte melhor prática a consultas filtradas (consultas com um filterExpression):

• Para o path parâmetro, utilize o caminho completo do OneDrive, conforme mostrado no painel de detalhes do ficheiro ou pasta (não é uma ligação de partilha ou um endereço do browser). Por exemplo: https://contoso-my.sharepoint.com/personal/username_domain_com/Documents/Project/Report.docx.

Âmbito e restrições atuais

As seguintes restrições aplicam-se atualmente à API de Pesquisa:

• O query parâmetro de pedido tem um limite de 1500 carateres.
• Apenas o OneDrive para trabalho ou escola é suportado como uma origem de dados.
• Apenas path as expressões são suportadas em filterExpression. Mais QL por palavra-chave (KQL) poderão ser suportadas em versões futuras.
• O pageSize parâmetro do pedido tem um valor máximo de 100.
• São suportados até 200 pedidos por utilizador por hora.
• A pesquisa semântica em conteúdos não textuais, incluindo tabelas, imagens e gráficos, não é suportada.
• A pesquisa semântica em ficheiros com extensões de .docx, .pptx e .pdf com mais de 512 MB não é suportada. A pesquisa semântica em ficheiros com qualquer outra extensão com mais de 150 MB não é suportada
• A pesquisa semântica está disponível num conjunto de dados de trabalho personalizado para conteúdo do OneDrive, que não inclui todos os conteúdos no OneDrive do utilizador.
• A pesquisa semântica só está disponível nas seguintes extensões de ficheiro: .aspx, .docx, .pptx, .pdf, .onepart, .doc, .html, .eml, .mp4, .loop, .one, .fluid, .png, .jpg, .json, .csv, .xml, .ppt.
• A API de Pesquisa está sujeita a todas as limitações do índice semântico Microsoft 365 Copilot.
• Se searchHits o payload da resposta estiver vazio, não foram encontrados resultados relevantes.

Próxima etapa

Conteúdo relacionado

• Experimentar com o explorador do Graph