Guías de usuario

Bienvenido a InfoLens. Esta guía le permitirá ejecutar su primera consulta RAG en menos de 5 minutos. Primero, asegúrese de que Docker esté instalado y en ejecución. Clone el repositorio, copie .env.example a .env y agregue su clave API de Gemini. Abra http://localhost:24001 en su navegador, inicie sesión, suba un documento y luego vaya a Chat para hacer su primera pregunta.

Los agentes son el componente principal de InfoLens. Cada agente es un asistente impulsado por IA que responde preguntas utilizando un conjunto específico de colecciones de documentos. Para crear su primer agente, vaya a la página de Agentes y haga clic en "Nuevo agente". Asígnele un nombre y una descripción, luego seleccione a qué colecciones de documentos debe tener acceso. Una vez creado, vaya a la página de detalle del agente para configurar su comportamiento, crear claves API y obtener el código de integración.

InfoLens admite una amplia gama de formatos de documentos: PDF, TXT, DOCX, HTML, CSV, JSON, PPTX, XLSX y Markdown. Para subir documentos, navegue a la página de Documentos y haga clic en "Subir" o arrastre y suelte archivos directamente. Para obtener mejores resultados, utilice documentos bien estructurados con encabezados y párrafos claros.

El widget de InfoLens es un fragmento ligero de JavaScript que agrega una interfaz de chat impulsada por IA a cualquier sitio web. Para obtener el código de integración, abra la página de detalle de su agente y vaya a la pestaña "Integración y SDK". Encontrará un fragmento HTML listo para copiar. El widget admite personalización: cambie el mensaje de bienvenida, el texto de ejemplo, los colores y la posición.

Cada agente en InfoLens se puede ajustar a través de su panel de configuración. Las opciones clave incluyen el prompt del sistema, la temperatura, la selección del modelo y los tokens máximos. El prompt del sistema es la configuración más importante. Le indica a la IA cómo comportarse y qué tono usar. Los límites de uso se pueden establecer por agente para controlar el uso diario y mensual.

InfoLens utiliza un sistema RBAC dinámico impulsado por Casbin. El modelo de permisos incluye 14 recursos y 35 permisos. Como administrador, puede invitar usuarios a su tenant y asignarles roles. Los roles predeterminados incluyen propietario, administrador, profesor, estudiante y auditor. Para gestionar usuarios, vaya a Administración > Usuarios. Para configurar roles, vaya a Administración > Roles.

InfoLens se integra con prácticamente cualquier sitio web o plataforma. El método más sencillo es el widget de integración. Para WordPress: instale un plugin como "Insert Headers and Footers". Para Shopify: vaya a Tienda en línea > Temas > Editar código. Para aplicaciones React/Next.js, use el paquete @infolens/sdk de TypeScript para una integración más profunda.

InfoLens admite dos métodos de autenticación: tokens Bearer JWT y claves API. Ambos funcionan en todos los endpoints de la API. Para obtener un token JWT, inicie sesión con el flujo de correo sin contraseña: envíe una solicitud POST a /v1/users/login/otp/request con su correo y, a continuación, POST /v1/users/login/otp/verify con el código de 6 dígitos que llega por correo. La respuesta incluye un access_token que se incluye en el encabezado Authorization como "Bearer {token}". Los tokens caducan tras el TTL configurado. El inicio de sesión OAuth con Google y GitHub también está disponible cuando está configurado: descubra los métodos habilitados mediante GET /v1/users/auth/methods. Las claves API son ideales para integraciones servidor a servidor y el servidor MCP.

InfoLens puede ingerir contenido directamente de páginas web. Para extraer un sitio web, use la API de carga de documentos con una URL en lugar de un archivo. Para extracción masiva, puede proporcionar múltiples URLs a través de la API. Cada URL se convierte en un documento separado. Tenga en cuenta que la extracción web respeta robots.txt y requiere que el sitio de destino sea accesible desde su servidor.

InfoLens incluye varias funciones para el cumplimiento del GDPR y la privacidad de datos. La arquitectura multi-tenant garantiza el aislamiento completo de datos entre organizaciones. El registro de auditoría rastrea todas las acciones significativas: creación de usuarios, cambios de roles, cargas de documentos y modificaciones de configuración. Para la retención de datos, configure los límites por tenant a través de Administración > Configuración.