Use este guia quando você precisar configurar, entender ou validar **Como adicionar documentos** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Um documento na IAra atua como um recurso de conhecimento para o assistente. Ao vincular sua central de ajuda ou guias, a IAra pode analisar o conteúdo e ajudar de forma eficaz nas dúvidas dos clientes.

Atualmente, oferecemos suporte a URLs de sites e arquivos PDF como fontes, mas planejamos expandir isso para incluir documentos do Notion no futuro.

## Como criar um documento?

No menu da barra lateral, clique na opção **Documentos** em IAra. Você verá uma página como a abaixo.

<!-- iara-context-media:agente-ia-documentos-cenarios-mcp-frame-001 -->
**Na tela:** Abra **Documentos** para adicionar URLs públicas ou arquivos que a IA deve consultar.

![documentos.](https://app.digi2b.com/storage/file/2323w8nmu2qbzhovyafscw8z16v6)

## Como posso verificar se o conteúdo foi analisado corretamente?

Para garantir que o conteúdo seja analisado corretamente, a IAra analisa os documentos fornecidos para identificar possíveis dúvidas. Em seguida, gera uma lista de perguntas frequentes relacionadas ao documento. Ao revisar essas perguntas frequentes, você pode verificar se o conteúdo foi processado com precisão e interpretado corretamente.

Você pode visualizar as FAQs geradas para cada documento. Basta clicar no menu de três pontos no documento e escolher **Visualizar** **Respostas relacionadas** para acessá-las.

<!-- iara-context-media:agente-ia-base-e-playground-frame-002 -->
**Na tela:** Depois de criar o documento, acompanhe se ele aparece na lista e se foi processado corretamente.

![documento processado.](https://app.digi2b.com/storage/file/i8l5nnkdx3yiiuz47r5e29c2xs01)

Isso exibirá as perguntas frequentes relacionadas, conforme mostrado abaixo.

## Limite de uso

Se você não assinou um complemento pago da IAra, o número de documentos que você pode adicionar será limitado. Com o plano Startups você pode adicionar até 100 documentos gratuitamente. Para planos superiores, o limite aumenta para 200 documentos gratuitos no plano Business e 300 documentos gratuitos no plano Enterprise.

---
## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.