Voltar para o site

SharePoint

IMPORTANTE


Antes de configurar o conector do SharePoint, conclua as etapas da documentação
Permissão Foundry User.
Essa permissão é necessária para que os usuários possam utilizar o agente do SharePoint pelo Power Omni.

1. Introdução

Essa seção descreve o processo de integração entre o SharePoint e o Power Omni via conector. Ao seguir estas instruções, poderá configurar o acesso aos documentos e sites do SharePoint para que sejam consumidos por agentes de IA no Power Omni.

2. Pré-requisitos

Certifique-se de que todos os itens abaixo estão atendidos antes de iniciar a configuração.

RequisitoDescrição
Assinatura AzureAcesso como Owner ou Contributor na assinatura e no grupo de recursos
Licença Microsoft 365 CopilotAo menos 1 licença ativa durante todo o período de uso
Permissão de Leitura no SharePointO usuário precisa de acesso de leitura nos sites e documentos a serem consultados
Serviço Pay-as-you-go da API Retrieval(Melhor Alternativa para não precisar contratar licenças copilot para os usuários)
💡 Recomendação

O modelo Pay-as-you-go é a alternativa mais econômica para equipes que não precisam de licenças Copilot completas, pagando apenas pelo uso efetivo da API.

3. Configuração

A configuração é dividida em duas partes independentes que devem ser executadas na ordem apresentada.

Parte 1 — Ativar o serviço Pay-as-you-go no Microsoft 365

🔐 Quem executa: Administrador do tenant Microsoft 365.

Passo 1 — Acessar o Admin Center

  1. Acesse https://admin.microsoft.com
  2. Faça login com a conta de administrador do tenant.

Passo 2 — Criar a política de cobrança

  1. No menu lateral, navegue até Copilot → Billing & Usage.

  2. Selecione a aba Billing policies e +Add a billing policy.

  3. Preencha as configurações da política:

  • Nome da política de cobrança
  • Assinatura Azure e Resource Group para faturamento
  • Escopo de usuários: todos os usuários ou um grupo específico
  • Orçamento (opcional): ative Set a budget for this policy e defina um valor máximo, ou deixe sem limite
  1. Revise as informações e clique em Create policy.

Passo 3 — Confirmar a ativação

  1. Ainda em Billing & Usage, selecione a aba Pay-as-you-go.

  2. Localize o item Microsoft 365 Copilot Retrieval API.

  3. Confirme que o status está como Connected.

⚠️ Atenção — Tempo de propagação

Após a ativação, aguarde até 2 horas para o serviço ser propagado por todo o tenant. A primeira chamada de API após esse período pode falhar, este é um comportamento esperado. A partir da segunda chamada, o serviço funcionará normalmente.

Parte 2 — Criar o Agente no SharePoint

🔐 Quem executa: Usuário com licença Microsoft 365 Copilot ativa.

Passo 1 — Acessar o site do SharePoint

Navegue até o site do SharePoint cujos arquivos o agente deverá acessar.

Passo 2 — Criar o agente

  1. Clique em + New → Agent.

  2. Preencha:

    • Nome do agente
    • Objetivo do agente

  3. Adicione as fontes de dados (arquivos específicos ou todo o conteúdo do site).

  4. Defina as instruções de comportamento do agente.

  5. Clique em Create agent.

Passo 3 — Copiar a URL do site

Após salvar, copie a URL do site para uso na próxima etapa. O formato esperado é:

https://<empresa>.sharepoint.com/sites/<nome_do_site>

Parte 3 — Configurar o Conector no Power Omni

Passo 1 — Criar o conector

  1. Acesse Configurações → Artefatos → Conectores.

  2. Clique em Create.

  3. Selecione o conector do SharePoint.

  4. Preencha:

    • Nome do conector
    • Descrição
    • Projeto do Power Omni associado

Passo 2 — Criar a conexão

  1. Clique em Criar nova conexão.

  2. Preencha:

    • Nome da conexão (pode ser o mesmo nome do conector)
    • URL do site SharePoint: https://<empresa>.sharepoint.com/sites/<nome_do_site>

  3. Clique em Salvar.

Passo 3 — Vincular o conector ao agente

  1. Acesse Artefatos → Agentes.

  2. Selecione o agente desejado e vá até a aba Relacionamentos.

  3. Adicione o conector criado.

  4. Salve e teste o agente.

📌 Limitação

Apenas 1 conexão SharePoint por agente é permitida. Para acessar múltiplos sites, crie agentes separados para cada um.

4. Permissões e Modelo de Cobrança

4.1 Acesso para outros usuários

  • Usuários sem licença Copilot podem usar o agente se estiverem incluídos na política de cobrança Pay-as-you-go.

4.2 Custos

Item Valor
Chamada do serviço Pay-as-you-go US$ 0,10 por chamada (preço de preview)
Monitoramento de consumo Azure Cost Management
Limites de uso Configuráveis (diário e mensal) via política de cobrança

5. Conclusão

A integração do SharePoint ao Power Omni permite consultar dados diretamente de sites e documentos do SharePoint dentro de agentes do Power Omni. Siga as três partes da configuração na ordem apresentada e valide cada etapa antes de avançar para a próxima.

Em caso de dúvidas ou falhas, verifique:

  • Se a política Pay-as-you-go está com status Connected
  • Se o tempo de propagação de 2 horas já foi aguardado
  • Se a URL do site SharePoint foi copiada corretamente

Atualizado