Este guia explica como ativar e usar o suporte nativo a PDFs e anexos de documentos ao interagir com bots de IA no Discourse. Os usuários podem carregar PDFs e outros documentos diretamente nas conversas com agentes de IA.
Nível de usuário necessário: Administrador
Resumo
O Discourse AI agora suporta o tratamento 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 compreender o conteúdo desses anexos, viabilizando casos de uso como análise de documentos, resumização e resposta a perguntas com base nos arquivos enviados.
Esta funcionalidade requer:
- Tipos de anexos permitidos configurados no LLM
- Um agente com a visão ativada (isso controla se os uploads são incluídos nas mensagens)
- A extensão do arquivo 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)
- AWS Bedrock (modelos Claude via Bedrock)
- Google (modelos Gemini)
- OpenAI (modelos GPT)
- Azure (modelos compatíveis com OpenAI)
- OpenRouter (modelos compatíveis com OpenAI)
Cada provedor lida com os anexos de maneira diferente a nível de API, mas o Discourse AI gerencia isso automaticamente. Tenha em mente que diferentes provedores implementam níveis diferentes de suporte para vários tipos de anexos.
Tipos de anexos suportados
Os seguintes tipos de documentos podem ser configurados para processamento por 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 pela configuração “Visão ativada” e não requerem configuração de tipo de anexo.
Configuração
Etapa 1: Autorizar extensões de arquivo para upload
Antes que os usuários possam carregar anexos, certifique-se de que as extensões de arquivo estão autorizadas nas configurações do seu site.
- Navegue até Admin → Arquivos
- Encontre a configuração
authorized extensions(extensões autorizadas) - Adicione as extensões que deseja permitir (ex.:
pdf|txt|docx)
Etapa 2: Configurar o modelo LLM
- Navegue até Admin → Plugins → Discourse AI → LLMs
- Selecione o modelo LLM que deseja configurar (ou crie um novo)
- No campo Allowed attachments (Anexos permitidos), selecione ou digite as extensões de arquivo que o modelo deve aceitar (ex.:
pdf,txt,docx)
Se você deixar o campo “Allowed attachments” (Anexos permitidos) em branco, os anexos de documentos serão desativados para esse modelo. As imagens são controladas separadamente pelo botão de alternância “Vision enabled” (Visão ativada).
Etapa 3: Configurar o agente
- Navegue até Admin → Plugins → Discourse AI → Agentes
- Selecione ou crie um agente
- Certifique-se de que Vision enabled (Visão ativada) esteja ligado — isso controla se os uploads (tanto imagens quanto documentos) são incluídos nas mensagens enviadas ao LLM
- Defina o Default model (Modelo padrão) como um LLM que tenha anexos configurados
Como funciona
Quando um usuário faz upload de um documento em uma conversa com um bot de IA:
- O documento é enviado ao Discourse usando o tratamento padrão de uploads
- 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
- Os documentos são codificados em base64 e enviados inline com a requisição
- Cada provedor recebe os anexos em seu formato nativo:
- Anthropic: Usa tipo
documentcom fonte base64 - Gemini: Usa formato
inlineData - OpenAI (Chat Completions API): Usa tipo
filecomfile_datacontendo o conteúdo base64 - OpenAI (Responses API): Usa tipo
input_filecomfile_datacontendo o conteúdo base64
- Anthropic: Usa tipo
- Os limites de tamanho de arquivo são regidos pela configuração
max attachment size kbdo seu site
Casos de uso
O suporte nativo a anexos viabiliza vários fluxos de trabalho:
- Análise de documentos: Faça upload de contratos, relatórios ou artigos de pesquisa para a IA resumir ou responder a perguntas sobre eles
- Revisão de conteúdo: Faça a IA revisar e fornecer feedback sobre documentos de rascunho
- Extração de dados: Extraia informações específicas de documentos enviados
- Assistência de tradução: Faça upload de documentos em um idioma e discuta o conteúdo ou solicite traduções
- Suporte técnico: Os usuários podem fazer upload de arquivos de log ou arquivos de configuração para obter assistência na solução de problemas
Limitações
- Tamanho do arquivo: Os anexos são limitados pelas configurações de tamanho de upload do seu site e pelo provedor do LLM
- Suporte do provedor: O suporte a anexos requer um dialeto de provedor que lide com documentos (Anthropic, AWS Bedrock, Google, OpenAI, Azure e OpenRouter)
- Requisito de visão do agente: O agente deve ter “Vision enabled” (Visão ativada) ligado para que os uploads sejam incluídos nas mensagens
- Correspondência de extensão: A extensão do arquivo deve estar tanto autorizada para upload no seu site quanto permitida na configuração de tipos de anexos do LLM
- Resultados variam: Como os fornecedores de LLMs e os próprios LLMs estão processando os arquivos, a relação custo/precisão e os resultados variam. A Anthropic tende a usar mais tokens para análise do que a OpenAI ou o Google.
- Ativar cache: Para a OpenAI, certifique-se de usar a Responses API, que oferece suporte mais consistente ao cache (quando o pensamento/razão está ativado). Para modelos Anthropic, pode ser necessário ativar o cache explicitamente na configuração do LLM. Isso pode ser particularmente importante em conversas de múltiplas rodadas.
Solução de problemas
Anexos não estão sendo processados
- Verifique se a extensão do arquivo está na configuração
authorized extensions(extensões autorizadas) do seu site - Confirme se o tipo de arquivo está listado na configuração “Allowed attachments” (Anexos permitidos) do LLM
- Garanta que o agente tenha “Vision enabled” (Visão ativada) ligado e use um LLM configurado corretamente
Falha no upload
- Verifique sua configuração
max attachment size kb(tamanho máximo do anexo em KB) - Verifique se a extensão do arquivo está autorizada
- PDFs muito grandes podem não ser suportados; cada fornecedor de LLM tem tamanhos máximos de upload diferentes.
A IA não entende o documento
- Garanta que você está usando um modelo que suporta 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 bem como nas MP (Mensagens Privadas)?
Sim, o suporte a anexos funciona tanto em mensagens privadas com bots de IA quanto em mensagens diretas de chat, desde que o agente esteja configurado para esses métodos de interação.
Isso é diferente dos uploads RAG em agentes?
Sim. Os uploads RAG são documentos adicionados por administradores à base de conhecimento de um agente, os quais são indexados e pesquisados. O suporte nativo a anexos permite que usuários finais enviem documentos durante conversas para análise imediata sem indexação.
O que acontece com os documentos enviados?
Os documentos são processados de acordo com as políticas padrão de tratamento de uploads e retenção do seu site. Eles são armazenados como uploads regulares do Discourse.