Este guia explica como habilitar e usar o suporte nativo para anexos de PDF e documentos ao interagir com bots de IA no Discourse. Os usuários podem fazer upload de PDFs e outros documentos diretamente em conversas com personas de IA.
Nível de usuário necessário: Administrador
Resumo
O Discourse AI agora suporta o gerenciamento nativo de anexos, permitindo que os usuários façam upload de PDFs e outros tipos de documentos diretamente ao conversar com bots de IA. A IA pode ler e entender o conteúdo desses anexos, possibilitando casos de uso como análise de documentos, sumarização e resposta a perguntas com base nos arquivos enviados.
Este recurso requer:
- Um modelo LLM com visão habilitada
- Tipos de anexo permitidos configurados no LLM
- Uma persona que suporte visão
- Que a extensão do arquivo esteja autorizada nas configurações de upload do seu site
Provedores Suportados
O suporte nativo a anexos funciona com modelos dos seguintes provedores:
- Anthropic (Modelos Claude)
- Google (Modelos Gemini)
- OpenAI (Modelos GPT)
Cada provedor lida com anexos de maneira diferente no nível da API, mas o Discourse AI gerencia isso automaticamente. Tenha em mente que provedores diferentes implementam níveis variados de suporte para diferentes tipos de anexo.
Tipos de Anexo Suportados
Os seguintes tipos de documentos podem ser configurados para processamento pela IA:
| Tipo | Extensões |
|---|---|
pdf |
|
| Texto Simples | txt |
| Microsoft Word | doc, docx |
| Rich Text Format | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
Imagens são tratadas separadamente através da configuração “Visão habilitada” e não requerem configuração de tipo de anexo.
Configuração
Passo 1: Autorizar extensões de arquivo para upload
Antes que os usuários possam fazer upload de anexos, certifique-se de que as extensões de arquivo estejam autorizadas nas configurações do seu site.
- Navegue até Admin → Files (Arquivos)
- Encontre a configuração
authorized extensions(extensões autorizadas) - Adicione as extensões que deseja permitir (ex:
pdf|txt|docx)
Passo 2: Configurar o modelo LLM
- Navegue até Admin → Plugins → Discourse AI → LLMs
- Selecione o modelo LLM que deseja configurar (ou crie um novo)
- Habilite Vision enabled (Visão habilitada) - isso é necessário para o suporte a anexos
- No campo Allowed attachments (Anexos permitidos), selecione ou digite as extensões de arquivo que você deseja que o modelo aceite (ex:
pdf,txt,docx)
Se você deixar o campo “Allowed attachments” em branco, os anexos de documentos serão desabilitados para aquele modelo. Imagens são controladas separadamente através da chave “Vision enabled”.
Passo 3: Configurar a persona
- Navegue até Admin → Plugins → Discourse AI → AI Personas (Personas de IA)
- Selecione ou crie uma persona
- Certifique-se de que o Vision support (Suporte a visão) esteja habilitado para a persona
- Defina o Default model (Modelo padrão) para um LLM que tenha visão e anexos configurados
Como funciona
Quando um usuário faz upload de um documento em uma conversa com um bot de IA:
- O documento é enviado para o Discourse usando o gerenciamento de upload padrão
- O Discourse AI codifica o conteúdo do documento (base64)
- O conteúdo codificado é enviado ao LLM junto com a mensagem do usuário
- O LLM processa tanto a mensagem de texto quanto o conteúdo do documento
- A IA responde com base no contexto combinado
Detalhes técnicos
- Documentos são codificados como base64 e enviados embutidos na requisição
- Cada provedor recebe os anexos em seu formato nativo:
- Anthropic: Usa o tipo
documentcom fonte base64 - Gemini: Usa o formato
inlineData - OpenAI: Usa o tipo
filecomfile_datacontendo o conteúdo base64
- Anthropic: Usa o tipo
- Limites de tamanho de arquivo são regidos pela configuração
max attachment size kb(tamanho máximo de anexo em kb) do seu site
Casos de Uso
O suporte nativo a anexos possibilita vários fluxos de trabalho:
- Análise de documentos: Envie contratos, relatórios ou artigos de pesquisa para a IA resumir ou responder perguntas sobre eles
- Revisão de conteúdo: Peça à IA para revisar e fornecer feedback sobre rascunhos de documentos
- Extração de dados: Extraia informações específicas de documentos enviados
- Assistência de tradução: Envie documentos em um idioma e discuta o conteúdo ou solicite traduções
- Suporte técnico: Usuários podem enviar arquivos de log ou de configuração para assistência na solução de problemas
Limitações
- Tamanho do arquivo: Anexos são limitados pelas configurações de tamanho de upload do seu site e pelo fornecedor do LLM
- Suporte do provedor: Apenas modelos da Anthropic, Google e OpenAI suportam anexos atualmente
- Requisito de visão: O LLM deve ter recursos de visão habilitados
- Correspondência de extensão: A extensão do arquivo deve ser autorizada para upload no seu site e permitida na configuração de tipos de anexo do LLM
- Resultados variam: Como os fornecedores de LLM e os LLMs estão processando os arquivos, o custo/precisão e os resultados variarão. A Anthropic tende a usar mais tokens para análise do que a OpenAI ou o Google.
- Habilitar cache: Para a OpenAI, certifique-se de usar a API de respostas, que oferece suporte mais consistente para cache (quando o pensamento está habilitado); para modelos Anthropic, talvez seja necessário habilitar o cache explicitamente na configuração do LLM. Isso pode ser particularmente importante ao ter conversas com várias voltas.
Solução de Problemas
Anexos não estão sendo processados
- Verifique se a extensão do arquivo está na configuração
authorized extensionsdo seu site - Verifique se o LLM tem a opção “Vision enabled” ativada
- Confirme se o tipo de arquivo está listado na configuração “Allowed attachments” do LLM
- Certifique-se de que a persona tenha o suporte a visão habilitado e esteja usando um LLM configurado corretamente
O upload falha
- Verifique sua configuração
max attachment size kb - Verifique se a extensão do arquivo está autorizada
- PDFs muito grandes podem não ser suportados; cada fornecedor de LLM tem diferentes tamanhos máximos de upload.
A IA não entende o documento
- Certifique-se de estar usando um modelo que suporte a compreensão de documentos
- Tente um modelo mais capaz (ex: Claude Sonnet 4.5, GPT-5.1, Gemini Pro 3)
Perguntas Frequentes
Os usuários podem enviar vários documentos em uma única mensagem?
Sim, os usuários podem incluir vários anexos em uma única mensagem, e a IA terá acesso a todos eles.
Isso funciona no chat, assim como em mensagens privadas?
Sim, o suporte a anexos funciona tanto em mensagens privadas com bots de IA quanto em mensagens diretas de chat, desde que a persona esteja configurada para esses métodos de interação.
Isso é diferente dos uploads RAG nas personas?
Sim. Uploads RAG são documentos adicionados por administradores à base de conhecimento de uma persona, que são indexados e pesquisados. O suporte nativo a anexos permite que os usuários finais enviem documentos durante as conversas para análise imediata, sem indexação.
O que acontece com os documentos enviados?
Os documentos são processados de acordo com o manuseio de upload padrão e as políticas de retenção do seu site. Eles são armazenados como uploads normais do Discourse.