> ## Content Index
> Fetch the complete content index at: https://www.azurebrasil.cloud/llms.txt
> Use this file to discover other available public pages before exploring further.

# Como Criar um App Interativo com Copilot a Partir de uma Lista do SharePoint
- URL: https://www.azurebrasil.cloud/blog/como-criar-um-app-interativo-com-copilot-a-partir-de-uma-lista-do-sharepoint/
- Published: 2026-08-18T12:06:31.000Z
- Updated: 2026-08-18T12:27:52.000Z
- Description: Veja como transformar uma lista do SharePoint num dashboard interativo completo, com poucos prompts.
- Author: Carlos Erutan 

> Vamos aprender como usar o Copilot em SharePoint para transformar uma lista em colunas, dados de teste e um app HTML interativo, e qual configuração de tenant e de site precisa estar correta antes disso, incluindo o erro mais comum quando o app gerado não carrega os dados.

## Pré-requisitos

| Requisito                                                | Obrigatório? | Notas                                                                                      |
| -------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------ |
| Licença Microsoft 365 Copilot ativa no usuário           | Sim          | Copilot em SharePoint está incluído na licença, sem custo adicional durante o preview      |
| Módulo SharePoint Online Management Shell instalado      | Sim          | Necessário para rodar os comandos de verificação e ajuste do tenant mostrados neste artigo |
| Feature liberada no tenant ( KnowledgeAgentScope )       | Sim          | O valor padrão do parâmetro é NoSites ; muitos tenants nunca chegaram a revisar isso       |
| Site AI settings com o botão do Copilot visível          | Sim          | O dono do site pode ocultar o botão para visitantes                                        |
| Restricted Content Discovery desabilitado no site        | Sim          | Se estiver habilitado, o Copilot em SharePoint não aparece, mesmo com o tenant liberado    |
| Ciência dos limites diários e semanais de uso do preview | Recomendado  | Podem interromper uma geração no meio do processo                                          |

## O Que é o Copilot em SharePoint

O recurso usado nesta demo se chama **Copilot em SharePoint**. Ele permite fazer perguntas sobre o conteúdo de um site, automatizar tarefas simples e criar sites, páginas, listas, relatórios interativos e arquivos do Office usando linguagem natural, diretamente na experiência do SharePoint. Para uma equipe de TI que já tem uma lista organizada, isso significa pular etapas manuais de modelagem de coluna e de montagem de relatório, o foco do restante deste artigo.

## Antes de Testar: a Configuração Que Costuma Faltar

A maioria das demos desse recurso mostra o resultado final sem explicar o que precisa estar habilitado antes. Na prática, quatro pontos determinam se a experiência aparece e funciona.

### Licença

O usuário precisa ter uma licença Microsoft 365 Copilot ativa. Sem ela, o botão do Copilot simplesmente não aparece na lista, independentemente de qualquer outra configuração.

### Disponibilidade da feature no tenant

O Copilot em SharePoint está passando por um rollout como *opt-out preview*, disponível automaticamente para usuários licenciados a partir de meados de junho de 2026\. Isso não significa que todo tenant já está com a feature ativa: se sua organização participou de uma fase anterior do preview e optou por não usar o recurso, essa configuração é respeitada mesmo depois do rollout automático.

O controle fica no parâmetro `KnowledgeAgentScope`, gerenciado pelo SharePoint Online Management Shell. Se você ainda não tem o módulo instalado, instale antes de conectar:

```powershell
# Instalar o módulo (executar como Administrador)
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force

```

Para verificar o estado atual do tenant, conecte usando a URL do **admin center**, não a URL do site raiz do tenant:

```powershell
# Conectar ao SharePoint Online como Administrador do SharePoint
# A URL precisa ser a do admin center (sufixo "-admin"), não a do site normal
Connect-SPOService https://suaempresa-admin.sharepoint.com

# Verificar a configuração atual
Get-SPOTenant | Select-Object KnowledgeAgentScope

```

> ⚠️ **Cuidado:** usar a URL do site normal (sem o sufixo `-admin`) no `Connect-SPOService` resulta no erro `Current site is not a tenant administration site.`. Confirme que a URL usada termina em `-admin.sharepoint.com`.

Se o retorno for `NoSites`, o Copilot em SharePoint está desabilitado para todo o tenant. Para liberar em todos os sites:

```powershell
Set-SPOTenant -KnowledgeAgentScope AllSites

```

Ou, para liberar apenas em sites específicos durante um piloto controlado:

```powershell
Set-SPOTenant -KnowledgeAgentScope IncludeSelectedSites
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://suaempresa.sharepoint.com/sites/ti")

```

![](https://storage.ghost.io/c/00/52/0052dced-0017-4d07-b190-1f5c48e0ab59/content/images/2026/08/image-13.png)

> Este é, na prática, o "script inicial" que a maior parte das demos não menciona. Sem ele, tudo o resto (colunas por linguagem natural, dados fictícios, app interativo) simplesmente não existe na interface do usuário.

### Configurações de site

Mesmo com o tenant liberado, o dono de um site específico pode ocultar o botão do Copilot para visitantes em **Site AI settings**. Uma segunda trava age de forma independente dessa: se o site tiver **Restricted Content Discovery** habilitado, o Copilot em SharePoint e as ações de IA não aparecem naquele site, seja qual for a configuração do tenant. Antes de concluir que a feature "não funciona", confirme essas duas configurações no site específico usado no teste.

### Limites de uso do preview

Durante o preview, o Copilot em SharePoint aplica limites diários e semanais de uso por usuário. Ao atingir o limite, os recursos de IA ficam temporariamente indisponíveis até o reset automático. Se uma geração parece "travar" no meio de uma demo mais longa, esse é um dos motivos possíveis.

## Montando a Demo: Criando a Lista e as Colunas por Linguagem Natural

Com os quatro pontos acima confirmados, o cenário desta demo é um inventário de ativos de TI, um caso de uso comum em qualquer equipe que precisa controlar notebooks, monitores e outros equipamentos por colaborador.

1. Crie uma lista vazia no SharePoint chamada **Inventário de Ativos de TI**.
2. Abra o Copilot na lista e descreva as colunas necessárias em linguagem natural, sem configurar tipos de dado manualmente:

> "Crie as colunas que eu preciso nesta lista: nome do ativo, tipo de ativo, colaborador responsável, departamento, data de compra, validade da garantia, status e número de série."

O Copilot interpreta o contexto de cada nome e escolhe o tipo de coluna adequado. Colaborador responsável, por exemplo, normalmente é criado como coluna do tipo Pessoa ou Grupo, sem que isso precise ser pedido explicitamente.

1. Com as colunas criadas, peça dados de teste para ter algo para visualizar:

> "Crie 50 registros fictícios para popular esta lista, variando os tipos de ativo, os departamentos e o status."

O Copilot mostra uma prévia dos itens que pretende criar antes de aplicar. Revise a amostra, principalmente valores de status e datas de garantia, antes de confirmar a criação.

![](https://storage.ghost.io/c/00/52/0052dced-0017-4d07-b190-1f5c48e0ab59/content/images/2026/08/image-15.png)

## Pedindo o App Interativo (e Como Escrever um Prompt Melhor)

Com a lista populada, o próximo passo é pedir o app interativo. Um prompt direto, no estilo do que normalmente aparece em demos, seria:

> "Preciso de uma página HTML interativa que ajude um administrador de TI a visualizar essas informações em estilo dashboard, com gráficos, e que também deixe os formulários de novo item e de edição mais intuitivos e esteticamente agradáveis."

Esse prompt funciona, mas deixa decisões importantes nas mãos do modelo: quais métricas priorizar, o que conta como "ativo em risco", quais filtros disponibilizar. Um prompt mais específico reduz a ambiguidade e tende a gerar um resultado mais próximo do que a equipe de TI realmente precisa:

![](https://storage.ghost.io/c/00/52/0052dced-0017-4d07-b190-1f5c48e0ab59/content/images/2026/08/image-17.png)

> "Crie uma página HTML interativa e independente, conectada a esta lista, pensada para o uso diário de um administrador de TI. Mostre: total de ativos, ativos com garantia vencida ou a vencer nos próximos 30 dias, distribuição de ativos por status em um gráfico de rosca, e uma lista dos ativos que precisam de atenção imediata. Adicione filtros por departamento, tipo de ativo e status. Redesenhe os formulários de novo item e de edição de forma intuitiva. Indique a data e hora da última atualização dos dados e explique como valores em branco são tratados."

A diferença entre os dois prompts não é estética. O segundo define público, métricas, dimensões de filtro e uma regra de tratamento de dados ausentes, o que facilita validar depois se o resultado está correto.

![](https://storage.ghost.io/c/00/52/0052dced-0017-4d07-b190-1f5c48e0ab59/content/images/2026/08/image-16.png)

Nos dois casos, o retorno costuma incluir um gráfico de rosca por status, contadores de destaque (como total de ativos e ativos em risco) e formulários customizados de criação e edição, todos conectados à lista de origem. O arquivo HTML gerado é salvo na biblioteca **Site Assets** do site.

## Onde Abrir o App Gerado Sem Quebrar a Conexão com a Lista

Ajuste a expectativa antes de distribuir esse app para outras pessoas: o que o Copilot entrega é um relatório HTML interativo gerado por IA, não uma aplicação de produção com autenticação, controle de estado e tratamento de erro construídos sob medida. Ele pode ter aparência e comportamento de aplicativo, com cartões, gráficos, filtros e formulários, mas isso não equivale aos mesmos mecanismos de confiabilidade de uma aplicação projetada e testada como tal.

Isso também afeta como o arquivo deve ser aberto. A documentação oficial descreve o fluxo como algo para ser revisado dentro da experiência suportada do SharePoint, com o Copilot chat disponível ao lado para ajustes. Abrir o arquivo diretamente pela biblioteca de documentos é um caminho diferente desse fluxo de revisão.

Foi exatamente isso que aconteceu neste teste: depois de gerado, o arquivo `Inventário de Ativos de TI Dashboard.html` foi aberto diretamente pela biblioteca Site Assets, pela visualização padrão de documentos (`Forms/AllItems.aspx`). O resultado foi a página travada em "Loading live inventory..." com o erro:

```text
Failed to load data: no content

```

A Microsoft não documenta em detalhe o limite exato de execução desse tipo de artefato gerado. Trate as causas abaixo como prováveis, não como certezas:

- a configuração de `KnowledgeAgentScope` pode ainda não ter propagado totalmente para todos os componentes envolvidos na geração e na leitura de dados;
- o contexto de execução ao abrir o arquivo pela biblioteca de documentos pode não ser o mesmo contexto usado quando o Copilot gera e revisa o app durante a criação;
- a conta usada para abrir o arquivo pode não ter a mesma permissão de leitura sobre a lista de origem que a conta usada na geração.

Na prática, antes de compartilhar o link do app gerado com outras pessoas, reabra e valide o resultado a partir da mesma experiência de Copilot usada na criação, em vez de apenas navegar até o arquivo na biblioteca.

## Checklist de Diagnóstico Quando o App Sai Errado

| Sintoma                                               | Causa provável                                                                                   | Solução                                                                                                                  |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Botão do Copilot não aparece na lista                 | Usuário sem licença M365 Copilot, ou KnowledgeAgentScope igual a NoSites                         | Confirmar a licença do usuário; rodar Get-SPOTenant e habilitar com Set-SPOTenant                                        |
| Botão aparece em um site e some em outro              | Site AI settings oculto pelo dono do site, ou Restricted Content Discovery habilitado nesse site | Revisar as configurações de IA do site específico                                                                        |
| Geração para no meio ou o Copilot recusa continuar    | Limite diário ou semanal de uso do preview atingido                                              | Aguardar o reset automático do limite, ou testar com outra conta licenciada                                              |
| App abre mas mostra "Failed to load data: no content" | Contexto de execução ou permissão de leitura na lista não resolvidos ao abrir pela biblioteca    | Reabrir e validar a partir da experiência de Copilot usada na criação; confirmar permissão de leitura na lista de origem |
| Dados do app não batem com a lista atual              | O artefato pode ser um retrato estático, não uma consulta em tempo real                          | Alterar um item na lista, atualizar a página e confirmar se o valor muda antes de chamar o app de "ao vivo"              |

## O Risco de Negócio de Tratar Isso Como uma Aplicação Pronta

Um artefato gerado por IA que parece uma aplicação funcional, mas falha silenciosamente com uma mensagem genérica como "Failed to load data: no content", é um risco quando é compartilhado com liderança ou com a operação do dia a dia sem validação prévia. A mensagem não indica se o problema é de licença, de configuração de tenant, de permissão ou de contexto de execução, o que torna qualquer diagnóstico apressado pouco confiável.

Isso não invalida o recurso. Para leituras rápidas, protótipos e dashboards leves de uso interno, o Copilot em SharePoint reduz de forma real a distância entre "temos uma lista organizada" e "temos algo visual para mostrar". O ponto de atenção é o próximo passo: um processo de negócio crítico, com regras de aprovação, integrações externas ou necessidade de suporte formal, ainda pede uma solução construída e testada como tal, seja Power Apps, Power BI ou uma aplicação dedicada. A decisão não é "Copilot ou a ferramenta certa": é entender qual nível de confiabilidade o cenário exige antes de generalizar um resultado de demo para uso em produção.

## Fechamento

Com a licença confirmada, o `KnowledgeAgentScope` liberado no tenant, as configurações de site revisadas e os prompts certos, o fluxo completo (colunas por linguagem natural, dados de teste e app interativo) funciona como esperado. O ponto que decide entre um resultado funcional e uma tela travada em "Failed to load data" quase sempre está numa dessas configurações prévias, não na sequência de prompts em si.

Antes de reproduzir esse fluxo no seu tenant, confira o estado atual do `KnowledgeAgentScope` com o comando `Get-SPOTenant` mostrado neste artigo. Se preferir revisar a configuração com apoio, fale com a Azure Brasil.

## Referências

- [Get started with Copilot in SharePoint (preview)](https://learn.microsoft.com/en-us/sharepoint/copilot-in-sharepoint-get-started?ref=azurebrasil.cloud)
- [What's New in Copilot in SharePoint: July 2026](https://techcommunity.microsoft.com/blog/spblog/what%E2%80%99s-new-in-copilot-in-sharepoint-july-2026/4535420?ref=azurebrasil.cloud)
- [Copilot in SharePoint (adoption hub)](https://adoption.microsoft.com/en-us/copilot-in-sharepoint/?ref=azurebrasil.cloud)
- [Manage Copilot agents and integrated apps (Agent 365)](https://learn.microsoft.com/en-us/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps?view=o365-worldwide&ref=azurebrasil.cloud)