# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/sharepoint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.