> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/sharepoint.md).

# SharePoint

### **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.

<table><thead><tr><th width="283">Requisito</th><th>Descrição</th></tr></thead><tbody><tr><td>Assinatura Azure</td><td>Acesso como <strong>Owner</strong> ou <strong>Contributor</strong> na assinatura e no grupo de recursos</td></tr><tr><td>Licença Microsoft 365 Copilot</td><td>Ao menos <strong>1 licença ativa</strong> durante todo o período de uso</td></tr><tr><td>Permissão de Leitura no SharePoint</td><td>O usuário precisa de acesso de leitura nos sites e documentos a serem consultados</td></tr><tr><td>Serviço Pay-as-you-go da API Retrieval</td><td>(Melhor Alternativa para não precisar contratar licenças copilot para os usuários)</td></tr></tbody></table>

{% hint style="info" %}

## 💡 **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.
{% endhint %}

***

### 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**.

   <figure><img src="/files/4pc4lhwl330N5TMaNEA5" alt=""><figcaption></figcaption></figure>
2. Selecione a aba **Billing policies e +Add a billing policy**.
3. Preencha as configurações da política:

<figure><img src="/files/Lj786SGcIVITd9CAAyEo" alt=""><figcaption></figcaption></figure>

* **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

<figure><img src="/files/HbkAsSnaqzgQnQ4IwxKs" alt=""><figcaption></figcaption></figure>

* **Orçamento (opcional):** ative *Set a budget for this policy* e defina um valor máximo, ou deixe sem limite

<figure><img src="/files/ZSUpWwX0QAZq46wtWWxT" alt=""><figcaption></figcaption></figure>

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**.

   <figure><img src="/files/6G1vNBHtSVZfD195gsbh" alt=""><figcaption></figcaption></figure>
2. Localize o item **Microsoft 365 Copilot Retrieval API**.
3. Confirme que o status está como **Connected**.

<figure><img src="/files/JtwMKKhCnyYpsQx5RHVs" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

## ⚠️ **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.
{% endhint %}

***

#### **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**.

   <figure><img src="/files/1LKoMNQRgjLjRm39F7PB" alt=""><figcaption></figcaption></figure>
2. Preencha:

   * **Nome** do agente
   * **Objetivo** do agente

   <figure><img src="/files/wfcfNJEeFOWU95TZaEU3" alt=""><figcaption></figcaption></figure>
3. Adicione as **fontes de dados** (arquivos específicos ou todo o conteúdo do site).

   <figure><img src="/files/EBXPUzOJy4ygxq86F80b" alt=""><figcaption></figcaption></figure>
4. Defina as **instruções de comportamento** do agente.

   <figure><img src="/files/FwSQ1yrCbpmzIKCYOMgB" alt=""><figcaption></figcaption></figure>
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**.

   <figure><img src="/files/AC1lEf3DccyBzAP9OdYD" alt=""><figcaption></figcaption></figure>
2. Clique em **Create**.

   <figure><img src="/files/yEtCijhbS5VBoStOsX7F" alt=""><figcaption></figcaption></figure>
3. Selecione o conector do **SharePoint**.
4. Preencha:

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

   <figure><img src="/files/egYmiXL5IOCGEHeEF6QU" alt=""><figcaption></figcaption></figure>

**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>`

   <figure><img src="/files/jHBh1TBFXLYQaet4glvY" alt=""><figcaption></figcaption></figure>
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**.

   <figure><img src="/files/HSAq1fmqUaiz56e6cLH3" alt=""><figcaption></figcaption></figure>
3. Adicione o conector criado.

   <figure><img src="/files/cXxX862w8sI1eCooDmeF" alt=""><figcaption></figcaption></figure>
4. Salve e teste o agente.

{% hint style="info" %}

## 📌 **Limitação**

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

***

### 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