10-03-03 — Desafio: Agente SharePoint+Teams
TL;DR
Desafio prático do módulo 10: construir um agente declarativo no Copilot Studio que responde perguntas sobre documentos de políticas no SharePoint e publica no Teams. Tempo estimado: 2-3 horas. Ao final você terá um agente funcional em produção que qualquer colaborador pode usar no Teams.
O Desafio
Cenário real: A Impar tem políticas de RH espalhadas em documentos Word no SharePoint. Os colaboradores frequentemente perguntam ao RH por email ou Teams sobre: férias, home office, benefícios, processo de promoção. O objetivo é um agente que responda essas perguntas automaticamente, 24/7, direto no Teams.
Requisitos do agente
- ✅ Responde perguntas sobre políticas usando documentos do SharePoint como fonte
- ✅ Cita o documento e parágrafo de onde veio a resposta
- ✅ Quando não encontrar resposta, sugere contatar o RH via Teams
- ✅ Publica no Teams como app da organização
- ✅ Funciona apenas para usuários autenticados (sem resposta anônima)
Passo a passo
1. Preparar o SharePoint
- Criar site
https://suaempresa.sharepoint.com/sites/PoliticasRH - Upload dos documentos de política (Word, PDF)
- Verificar permissões: todos os colaboradores devem ter acesso de leitura
2. Criar o agente no Copilot Studio
- Acesse copilotstudio.microsoft.com
- Create → New agent
- Nome: "Assistente RH"
- Instructions (system prompt):
// Instructions do agente (system prompt)
Você é o assistente de RH da [Empresa].
Responda perguntas sobre políticas internas com base nos documentos disponíveis.
Sempre cite qual documento e qual seção embasou sua resposta.
Se não encontrar a informação, diga: "Não encontrei essa informação nas políticas.
Para dúvidas específicas, contate o RH pelo Teams no canal #rh-suporte."
Seja conciso. Responda em português.
Não responda perguntas fora do tema de RH e políticas internas.
3. Configurar Knowledge Source
- Knowledge → Add knowledge source
- SharePoint → URL do site de políticas
- Aguardar indexação (pode levar até 24h na primeira vez)
4. Configurar autenticação
- Settings → Security → Authentication
- Selecionar: Authenticate with Microsoft (SSO)
- Configurar App Registration no Azure AD
5. Publicar no Teams
- Publish → Publish to Teams
- Download do Teams App Package (.zip)
- Teams Admin Center → Manage apps → Upload custom app → distribuir para organização
Critérios de sucesso
| Critério | Como verificar |
|---|---|
| Responde perguntas sobre férias corretamente | Testar: "Quantos dias de férias tenho por ano?" |
| Cita a fonte | Verificar se a resposta inclui nome do documento |
| Recusa perguntas off-topic | Testar: "Qual o preço do dólar hoje?" |
| SSO funciona | Verificar que usuário não-autenticado não acessa |
| Aparece no Teams | Verificar app na organização do Teams |
Próximo nível: Após completar este desafio, tente adicionar um topic para abertura de chamado de RH usando um Power Automate flow que cria uma tarefa no Planner. Você terá um agente que tanto responde perguntas quanto executa ações.
Recursos de apoio
Como isso se conecta
- Este desafio consolida: 10-01-01, 10-01-02, 10-01-03, 10-03-01, 10-03-02
- Próximo módulo: Microsoft Fabric — os dados que alimentam agentes mais sofisticados