Esta guía explica cómo habilitar y utilizar el soporte nativo de PDF y adjuntos de documentos al interactuar con bots de IA en Discourse. Los usuarios pueden subir PDFs y otros documentos directamente en las conversaciones con agentes de IA.
Nivel de usuario requerido: Administrador
Resumen
Discourse AI ahora admite el manejo nativo de adjuntos, lo que permite a los usuarios subir PDFs y otros tipos de documentos directamente al conversar con bots de IA. La IA puede leer y comprender el contenido de estos adjuntos, habilitando casos de uso como el análisis de documentos, la elaboración de resúmenes y la respuesta a preguntas basadas en archivos subidos.
Esta función requiere:
- Tipos de adjuntos permitidos configurados en el LLM
- Un agente que tenga activada la visión (esto controla si las subidas se incluyen en los mensajes)
- Que la extensión de archivo esté autorizada en la configuración de subidas de su sitio
Proveedores admitidos
El soporte nativo de adjuntos funciona con modelos de los siguientes proveedores:
- Anthropic (modelos Claude)
- AWS Bedrock (modelos Claude a través de Bedrock)
- Google (modelos Gemini)
- OpenAI (modelos GPT)
- Azure (modelos compatibles con OpenAI)
- OpenRouter (modelos compatibles con OpenAI)
Cada proveedor maneja los adjuntos de manera diferente a nivel de API, pero Discourse AI gestiona esto automáticamente. Tenga en cuenta que diferentes proveedores implementan distintos niveles de soporte para diversos tipos de adjuntos.
Tipos de adjuntos admitidos
Se pueden configurar los siguientes tipos de documentos para el procesamiento por IA:
| Tipo | Extensiones |
|---|---|
pdf |
|
| Texto plano | txt |
| Microsoft Word | doc, docx |
| Formato de texto enriquecido (RTF) | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
Las imágenes se manejan por separado a través de la configuración “Visión habilitada” y no requieren configuración de tipo de adjunto.
Configuración
Paso 1: Autorizar extensiones de archivo para la subida
Antes de que los usuarios puedan subir adjuntos, asegúrese de que las extensiones de archivo estén autorizadas en la configuración del sitio.
- Vaya a Admin → Archivos
- Busque la configuración
authorized extensions(extensiones autorizadas) - Añada las extensiones que desea permitir (por ejemplo,
pdf|txt|docx)
Paso 2: Configurar el modelo LLM
- Vaya a Admin → Plugins → Discourse AI → LLMs
- Seleccione el modelo LLM que desea configurar (o cree uno nuevo)
- En el campo Allowed attachments (Adjuntos permitidos), seleccione o escriba las extensiones de archivo que desea que el modelo acepte (por ejemplo,
pdf,txt,docx)
Si deja el campo “Allowed attachments” en blanco, los adjuntos de documentos estarán deshabilitados para ese modelo. Las imágenes se controlan por separado mediante la opción “Vision enabled” (Visión habilitada).
Paso 3: Configurar el agente
- Vaya a Admin → Plugins → Discourse AI → Agents (Agentes)
- Seleccione o cree un agente
- Asegúrese de que Vision enabled (Visión habilitada) esté activado — esto controla si las subidas (tanto imágenes como documentos) se incluyen en los mensajes enviados al LLM
- Establezca el Default model (Modelo predeterminado) en un LLM que tenga adjuntos configurados
Cómo funciona
Cuando un usuario sube un documento en una conversación con un bot de IA:
- El documento se sube a Discourse utilizando el manejo estándar de subidas
- Discourse AI codifica el contenido del documento (base64)
- El contenido codificado se envía al LLM junto con el mensaje del usuario
- El LLM procesa tanto el mensaje de texto como el contenido del documento
- La IA responde basándose en el contexto combinado
Detalles técnicos
- Los documentos se codifican en base64 y se envían en línea junto con la solicitud
- Cada proveedor recibe adjuntos en su formato nativo:
- Anthropic: Utiliza el tipo
documentcon fuente base64 - Gemini: Utiliza el formato
inlineData - OpenAI (Chat Completions API): Utiliza el tipo
fileconfile_dataque contiene el contenido base64 - OpenAI (Responses API): Utiliza el tipo
input_fileconfile_dataque contiene el contenido base64
- Anthropic: Utiliza el tipo
- Los límites de tamaño de archivo están regidos por la configuración
max attachment size kbde su sitio
Casos de uso
El soporte nativo de adjuntos habilita varios flujos de trabajo:
- Análisis de documentos: Suba contratos, informes o artículos de investigación para que la IA los resuma o responda preguntas sobre ellos
- Revisión de contenido: Pida a la IA que revise y proporcione comentarios sobre borradores de documentos
- Extracción de datos: Extraiga información específica de documentos subidos
- Asistencia en traducción: Suba documentos en un idioma y discuta el contenido o solicite traducciones
- Soporte técnico: Los usuarios pueden subir archivos de registro o archivos de configuración para asistencia en la resolución de problemas
Limitaciones
- Tamaño de archivo: Los adjuntos están limitados por la configuración de tamaño de subida de su sitio y el proveedor del LLM
- Soporte del proveedor: El soporte de adjuntos requiere un dialecto de proveedor que maneje documentos (Anthropic, AWS Bedrock, Google, OpenAI, Azure y OpenRouter)
- Requisito de visión del agente: El agente debe tener “Vision enabled” (Visión habilitada) activado para que las subidas se incluyan en los mensajes
- Coincidencia de extensiones: La extensión del archivo debe estar tanto autorizada para la subida en su sitio como permitida en la configuración de tipos de adjunto del LLM
- Resultados variables: Dado que los proveedores de LLM y los LLM están procesando los archivos, el costo, la precisión y los resultados variarán. Anthropic tiende a usar más tokens para el análisis que OpenAI o Google.
- Habilitar caché: Para OpenAI, asegúrese de usar la API de responses, que ofrece un soporte más consistente para el almacenamiento en caché (cuando el pensamiento está habilitado). Para los modelos de Anthropic, es posible que necesite habilitar la caché explícitamente en la configuración del LLM. Esto puede ser particularmente importante al tener conversaciones de múltiples turnos.
Solución de problemas
Los adjuntos no se están procesando
- Verifique que la extensión del archivo esté en la configuración
authorized extensionsde su sitio - Confirme que el tipo de archivo esté listado en la configuración “Allowed attachments” del LLM
- Asegúrese de que el agente tenga “Vision enabled” (Visión habilitada) activado y utilice un LLM configurado correctamente
La subida falla
- Compruebe su configuración
max attachment size kb - Verifique que la extensión del archivo esté autorizada
- Es posible que los PDFs muy grandes no sean compatibles; cada proveedor de LLM tiene diferentes tamaños máximos de subida.
La IA no entiende el documento
- Asegúrese de estar utilizando un modelo que soporte la comprensión de documentos
- Pruebe con un modelo más capaz (por ejemplo, Claude Sonnet 4.5, GPT-5.1, Gemini Pro 3)
Preguntas frecuentes (FAQs)
¿Pueden los usuarios subir múltiples documentos en un solo mensaje?
Sí, los usuarios pueden incluir múltiples adjuntos en un solo mensaje, y la IA tendrá acceso a todos ellos.
¿Esto funciona también en chat y en mensajes privados (PMs)?
Sí, el soporte de adjuntos funciona tanto en mensajes privados con bots de IA como en mensajes directos de chat, siempre que el agente esté configurado para esos métodos de interacción.
¿Esto es diferente de las subidas RAG en agentes?
Sí. Las subidas RAG son documentos añadidos por los administradores a la base de conocimiento de un agente, que se indexan y buscan. El soporte nativo de adjuntos permite a los usuarios finales subir documentos durante las conversaciones para su análisis inmediato sin indexación.
¿Qué pasa con los documentos subidos?
Los documentos se procesan según el manejo estándar de subidas y las políticas de retención de su sitio. Se almacenan como subidas regulares de Discourse.