> ## Documentation Index > Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt > Use this file to discover all available pages before exploring further. # Uso de GccAi en AnythingLLM > Guía detallada sobre cómo configurar y usar el servicio de API de GccAi en AnythingLLM. Esta guía le ayudará a configurar la API de GccAi en AnythingLLM para crear bases de conocimiento privadas y sistemas de conversación con IA. ## Requisitos previos Antes de comenzar, asegúrese de: 1. **Tener AnythingLLM instalado**\ Descargue e instale AnythingLLM desde el [sitio web oficial](https://anythingllm.com/) o visite [GitHub](https://github.com/Mintplex-Labs/anything-llm) 2. **Haber obtenido una clave de API de GccAi**\ Acceda a la [Consola de GccAi](https://gccai.heqingsong.uk/keys) para obtener su clave de API (comienza con `sk-`) > [!NOTE] > > **Consejo:** Si aún no tiene una cuenta en GccAi, regístrese primero en [GccAi](https://gccai.heqingsong.uk) y obtenga una clave de API. ## Paso 1: Iniciar AnythingLLM y acceder a la configuración ### 1.1 Iniciar la aplicación 1. Inicie la aplicación de escritorio AnythingLLM o acceda a la versión web 2. La pantalla de bienvenida aparecerá en el primer inicio 3. Haga clic en el botón **Open settings** en la esquina inferior izquierda ![AnythingLLM Main Interface](https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/main-interface.png?fit=max\&auto=format\&n=lJVOGiGDkmK1gCcM\&q=85\&s=e33a295a9129e3f7d948219db7609429) *Interfaz principal de AnythingLLM que muestra la lista de espacios de trabajo y el acceso a configuración* > [!NOTE] > > **Nota:** AnythingLLM admite versiones de escritorio (Windows, macOS, Linux) y despliegue con Docker. ### 1.2 Navegar a la configuración del LLM En la página de configuración: 1. Busque **LLM Preference** en el menú izquierdo 2. Haga clic para entrar en la página de configuración del LLM ## Paso 2: Configurar la API de GccAi ### 2.1 Seleccionar el proveedor de LLM En la página de configuración del LLM: 1. Busque el menú desplegable **LLM Provider** 2. Seleccione **Generic OpenAI** ![LLM Provider Selection](https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/llm-provider-selection.png?fit=max\&auto=format\&n=lJVOGiGDkmK1gCcM\&q=85\&s=91bc2ff729de6e22bcea7fab681e2ad4) *Seleccione Generic OpenAI como proveedor de LLM* > [!NOTE] > > **¿Por qué Generic OpenAI?** GccAi proporciona una interfaz de API compatible con OpenAI, por lo que seleccionar el proveedor Generic OpenAI en AnythingLLM le permite usar los servicios de GccAi. ### 2.2 Configurar la información de la API Tras seleccionar Generic OpenAI, complete la siguiente configuración: | Campo | Valor | | - | - | | **API Key** | Su clave de API de GccAi (`sk-xxxxxxxxxxxx`) | | **Base URL** o **API Base Path** | `https://gccai.heqingsong.uk/v1` | | **Chat Model** o **Model Name** | Introduzca el nombre del modelo específico (ver modelos recomendados a continuación) | ![API Configuration](https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/api-configuration.png?fit=max\&auto=format\&n=lJVOGiGDkmK1gCcM\&q=85\&s=1aea88ac0df6d35b5ae6b0dbcc0e8c05) *Complete la API Key, Base URL y el nombre del modelo de GccAi* > [!WARNING] > > **Importante:** > > * La Base URL debe incluir el sufijo `/v1`: `https://gccai.heqingsong.uk/v1` > * La API Key debe obtenerse desde la consola de GccAi y comenzar con `sk-` > * El nombre del modelo debe ser el ID exacto del modelo (p. ej., `gpt-4o`, `claude-sonnet-4-5-20250929`, etc.) > * Asegúrese de que su clave de API tenga saldo suficiente **Modelos recomendados:** | Nombre del modelo | ID del modelo | Características | | - | - | - | | GPT-5 | `gpt-5` | El más reciente y potente | | GPT-4o | `gpt-4o` o `chatgpt-4o-latest` | Conversación de alta calidad | | GPT-4o Mini | `gpt-4o-mini` | Rápido y económico | | Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` | Excelente para código y razonamiento | | Claude Haiku 4.5 | `claude-haiku-4-5-20251001` | Respuesta rápida | | Gemini 2.0 Flash | `gemini-2.0-flash-exp` | Soporte multimodal | > [!TIP] > > **Recomendaciones de rendimiento:** > > * 💰 **Económicos:** `gpt-4o-mini`, `claude-haiku-4-5-20251001` > * 🚀 **Alto rendimiento:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` > * ⚡ **Respuesta rápida:** `gemini-2.0-flash-exp`, `gpt-4o-mini` ### 2.3 Ajustar parámetros del modelo (opcional) Puede ajustar los siguientes parámetros según sea necesario: | Parámetro | Descripción | Valor recomendado | | - | - | - | | **Temperature** | Controla la aleatoriedad de la salida | 0.7 (creativo) / 0.3 (preciso) | | **Max Tokens** | Longitud máxima de la salida | 2000-4000 | | **Top P** | Parámetro de muestreo de núcleo | 0.9 | ### 2.4 Guardar la configuración 1. Haga clic en el botón **Save** en la parte inferior de la página 2. El sistema probará automáticamente la conexión 3. Aparecerá un mensaje de éxito si la configuración es correcta ## Paso 3: Configurar el modelo de embeddings (opcional) AnythingLLM admite embeddings vectoriales para la recuperación de documentos y la funcionalidad de base de conocimiento. ### 3.1 Navegar a la configuración de embeddings En la página de configuración: 1. Busque **Embedding Preference** en el menú izquierdo 2. Haga clic para entrar en la página de configuración del modelo de embeddings ### 3.2 Configurar el modelo de embeddings | Campo | Valor | | - | - | | **Embedding Provider** | Seleccione **Generic OpenAI** | | **API Key** | Su clave de API de GccAi (`sk-xxxxxxxxxxxx`) | | **Base URL** | `https://gccai.heqingsong.uk/v1` | | **Model** | `text-embedding-3-small` o `text-embedding-3-large` | > [!TIP] > > **Recomendaciones de selección de modelo:** > > * `text-embedding-3-small`: rápido y económico, adecuado para la mayoría de escenarios > * `text-embedding-3-large`: mayor precisión, adecuado para escenarios que requieren alta calidad de recuperación ## Paso 4: Crear un espacio de trabajo y cargar documentos ### 4.1 Crear un espacio de trabajo 1. Regrese a la interfaz principal 2. Haga clic en **+ New Workspace** 3. Introduzca el nombre del espacio de trabajo (p. ej., "Asistente de documentación técnica", "Base de conocimiento de atención al cliente") 4. Haga clic en Crear ### 4.2 Cargar documentos AnythingLLM admite varios formatos de documentos: **Tipos de documentos admitidos:** * 📄 **Documentos de texto** - .txt, .md, .pdf, .docx * 💻 **Archivos de código** - .py, .js, .java, .cpp, etc. * 🌐 **Páginas web** - Mediante scraping de URL * 📊 **Archivos de datos** - .csv, .json, .xml **Pasos de carga:** 1. En la página del espacio de trabajo, haga clic en **Upload Documents** 2. Seleccione archivos o arrastre y suelte archivos al área de carga 3. Espere a que se complete el procesamiento del documento 4. Los documentos se vectorizarán automáticamente > [!NOTE] > > **Procesamiento de documentos:** Los documentos cargados se dividen automáticamente en fragmentos y se vectorizan usando el modelo de embeddings, y se almacenan en la base de datos local. ### 4.3 Gestionar documentos En la página de gestión de documentos: 1. Vea todos los documentos cargados 2. Elimine los documentos innecesarios 3. Vea los detalles de fragmentación de documentos 4. Edite los metadatos del documento ## Paso 5: Comenzar las conversaciones Tras la configuración, puede comenzar a usar AnythingLLM: ### 5.1 Conversaciones básicas 1. En el espacio de trabajo, busque el cuadro de entrada de conversación 2. Introduzca su pregunta o solicitud 3. La IA generará respuestas basadas en sus documentos cargados y en los modelos de GccAi ### 5.2 Uso de las funciones de base de conocimiento AnythingLLM automáticamente: 1. Analiza su pregunta 2. Recupera contenido relevante de los documentos cargados 3. Genera respuestas precisas combinando el contenido recuperado y el modelo de IA > [!TIP] > > **Mejore la eficacia de la recuperación:** > > * Cargue documentos estructurados de alta calidad > * Use preguntas claras y específicas > * Actualice y mantenga regularmente la base de conocimiento ### 5.3 Cambiar de espacio de trabajo Puede crear múltiples espacios de trabajo para diferentes proyectos o temas: 1. Haga clic en el nombre del espacio de trabajo en la esquina superior izquierda 2. Seleccione otros espacios de trabajo o cree uno nuevo 3. Cada espacio de trabajo tiene documentos e historial de conversación independientes ## Características avanzadas ### 1. Modo Agente AnythingLLM admite la funcionalidad de Agente, lo que permite a la IA: * 🔍 **Buscar en la web** - Obtener información en tiempo real * 🧮 **Realizar cálculos** - Manejar matemáticas y análisis de datos * 📊 **Generar gráficos** - Visualizar datos * 🔗 **Llamar APIs** - Interactuar con servicios externos **Habilitar modo Agente:** 1. Busque **Agent Configuration** en la configuración del espacio de trabajo 2. Seleccione las herramientas y funciones a habilitar 3. Guarde la configuración ### 2. Gestión del historial de conversaciones * **Exportar conversaciones** - Exporte las conversaciones como texto o formato JSON * **Buscar historial** - Encuentre rápidamente conversaciones históricas * **Eliminar registros** - Limpie el historial de conversaciones innecesario ### 3. Prompts del sistema personalizados En la configuración del espacio de trabajo: 1. Busque **System Prompt** 2. Personalice el rol y comportamiento de la IA 3. Ejemplo: ``` You are a professional technical support engineer, skilled at answering technical questions about products. When answering, please: 1. Maintain professionalism and courtesy 2. Provide detailed step-by-step instructions 3. If uncertain, recommend contacting technical support ``` ### 4. Gestión multiusuario (solo despliegue con Docker) Si usa despliegue con Docker: * Cree múltiples cuentas de usuario * Establezca diferentes niveles de permisos * Gestione los permisos de acceso al espacio de trabajo ### 5. Acceso por API AnythingLLM proporciona una API REST para: * Acceso programático al espacio de trabajo * Cargar y gestionar documentos * Enviar solicitudes de conversación * Integrar en sus aplicaciones ## Preguntas frecuentes ### Q1: ¿No se puede conectar al servicio de GccAi? **Solución:** 1. **Verifique la Base URL**: * Asegúrese de que sea `https://gccai.heqingsong.uk/v1` (incluye `/v1`) * No añada rutas adicionales ni omita `/v1` 2. **Verifique la API Key**: * Confirme que la API Key comience con `sk-` * Compruebe si la clave es válida en la [Consola de GccAi](https://gccai.heqingsong.uk/keys) 3. **Verifique la conexión de red**: * Asegúrese del acceso a `https://gccai.heqingsong.uk` * Compruebe la configuración del firewall o proxy ### Q2: ¿Los documentos no se recuperan correctamente después de cargarlos? **Solución:** 1. **Verifique la configuración del modelo de embeddings**: * Confirme que el modelo de embeddings esté configurado correctamente * Pruebe la conexión del modelo de embeddings 2. **Reprocese los documentos**: * Elimine y vuelva a cargar los documentos * Compruebe si el formato del documento es compatible 3. **Ajuste los parámetros de recuperación**: * Ajuste el umbral de similitud en la configuración del espacio de trabajo * Aumente el número de fragmentos de documento devueltos ### Q3: ¿Respuesta de conversación lenta? **Solución:** 1. **Cambie a modelos más rápidos**: * Use `gpt-4o-mini` en lugar de `gpt-4o` * Use `gemini-2.0-flash-exp` para una respuesta más rápida 2. **Optimice la cantidad de documentos**: * Reduzca el número de documentos en el espacio de trabajo * Elimine archivos grandes innecesarios 3. **Ajuste Max Tokens**: * Reduzca la longitud máxima de la salida * Use prompts más concisos ### Q4: ¿Cómo ver el uso y los costos de la API? Acceda a la [Consola de GccAi](https://gccai.heqingsong.uk/overview) para ver: * 📊 Estadísticas de llamadas a la API * 💰 Detalles de costos * 📈 Gráficos de tendencias de uso * 🔍 Registros detallados de solicitudes ### Q5: ¿Qué opciones de despliegue admite AnythingLLM? AnythingLLM admite múltiples opciones de despliegue: * 🖥️ **Aplicación de escritorio** - Windows, macOS, Linux * 🐳 **Docker** - Despliegue autoalojado * ☁️ **Versión en la nube** - AnythingLLM Cloud (próximamente) ## Ejemplos de casos de uso ### 1. Base de conocimiento empresarial **Configuración:** * Modelo: `gpt-4o-mini` (económico) * Documentos: documentos internos de la empresa, manuales, FAQ * Función: búsqueda rápida de información para empleados **Casos de uso de ejemplo:** * Incorporación de nuevos empleados * Búsqueda rápida de políticas de la empresa * Recuperación de documentación técnica ### 2. Asistente de documentación técnica **Configuración:** * Modelo: `claude-sonnet-4-5-20250929` (excelente para código) * Documentos: documentación de API, especificaciones técnicas, base de código * Función: ayudar a los desarrolladores a encontrar información técnica **Casos de uso de ejemplo:** * Consultas de documentación de uso de API * Recuperación de ejemplos de código * Respuesta a preguntas técnicas ### 3. Base de conocimiento de atención al cliente **Configuración:** * Modelo: `gpt-4o` (conversación de alta calidad) * Documentos: manuales de producto, FAQ, soluciones * Función: respuesta rápida a preguntas de clientes **Casos de uso de ejemplo:** * Respuesta automática a FAQ * Orientación sobre el uso del producto * Sugerencias de solución de problemas ### 4. Asistente de investigación y aprendizaje **Configuración:** * Modelo: `gpt-5` (comprensión potente) * Documentos: artículos de investigación, libros de texto, notas * Función: ayudar en el aprendizaje y la investigación **Casos de uso de ejemplo:** * Resumen y análisis de artículos * Explicación de puntos de conocimiento * Planificación de rutas de aprendizaje ## Características Usando AnythingLLM + GccAi, puede: * 📚 **Base de conocimiento privada** - Construya una base de conocimiento privada y segura localmente * 🔒 **Privacidad de datos** - Todos los datos se almacenan localmente, protegiendo la privacidad * 🤖 **Soporte multimodelo** - Cambie de forma flexible entre diferentes modelos de IA * 📄 **Soporte multiformato** - Admite varios formatos de documentos * 🎯 **Recuperación precisa** - Recuperación inteligente de documentos basada en vectores * 💬 **Conversación contextual** - Mantenga el contexto en conversaciones largas * 🔧 **Altamente personalizable** - Prompts personalizados, parámetros, etc. * 🌐 **Multiplataforma** - Admite Windows, macOS, Linux ## Seguridad y privacidad de datos ### Almacenamiento local de datos Enfoque de almacenamiento de datos de AnythingLLM: * 📁 **Sistema de archivos local** - Los documentos se almacenan localmente * 🗄️ **Base de datos vectorial local** - Los índices vectoriales se almacenan localmente * 💾 **Historial de conversación** - Los registros de conversación se almacenan localmente ### Seguridad de las llamadas a la API * 🔐 **Transmisión cifrada** - Todas las llamadas a la API usan cifrado HTTPS * 🔑 **Protección de la clave** - La API Key se almacena de forma segura * 🚫 **Sin retención de datos** - GccAi no almacena el contenido de sus conversaciones > [!WARNING] > > **Aviso de privacidad:** Aunque los documentos se almacenan localmente, las conversaciones y el contenido recuperado enviados a la IA se transmiten a los servidores de GccAi mediante la API para su procesamiento. Evite cargar o consultar contenido con información sensible. ## Mejores prácticas ### 1. Gestión de documentos * **Actualizaciones regulares** - Mantenga el contenido de los documentos actualizado * **Organización estructurada** - Use una estructura clara de carpetas * **Convenciones de nombres** - Use nombres de archivo significativos * **Eliminar lo obsoleto** - Limpie regularmente los documentos obsoletos ### 2. Optimización de prompts **❌ Prompt deficiente:** ``` You are an assistant ``` **✅ Buen prompt:** ``` You are a professional technical support assistant specializing in helping users resolve product-related technical issues. When answering, please follow these principles: 1. Answer based on provided documentation; if information isn't available, clearly state so 2. Provide detailed step-by-step instructions with examples when necessary 3. Use clear, understandable language 4. For complex issues, recommend contacting the technical support team ``` ### 3. Optimización del rendimiento * **Controle el tamaño de los documentos** - Evite cargar archivos individuales demasiado grandes * **Fragmentación razonable** - Use la configuración predeterminada de fragmentación de documentos * **Elija el modelo adecuado** - Seleccione el modelo según la complejidad de la tarea * **Supervise el uso** - Verifique regularmente el uso de la API ### 4. Planificación del espacio de trabajo * **Divida por proyecto** - Cree espacios de trabajo independientes para diferentes proyectos * **Gestión de permisos** - Configure los permisos del espacio de trabajo de forma adecuada (versión Docker) * **Copia de seguridad de datos** - Haga copias de seguridad regulares de los espacios de trabajo importantes ## Soporte y ayuda Si encuentra algún problema: * 📚 [Documentación de GccAi](https://gccai.heqingsong.uk) * 📚 [Documentación oficial de AnythingLLM](https://docs.anythingllm.com/) * 📚 [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) * 💬 [Comunidad de Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @GccAi\_](https://x.com/GccAi_) * 📧 Soporte técnico: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk) *** > **[Comience a usar GccAi](https://gccai.heqingsong.uk)** > > ¡Regístrese en GccAi ahora, obtenga su clave de API y construya su base de conocimiento privada en AnythingLLM! This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.