> ## 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 Dify
> Guía detallada sobre cómo configurar y usar el servicio de API de GccAi en la plataforma LLMOps de Dify. Esta guía le ayudará a configurar la API de GccAi en Dify para construir aplicaciones de IA potentes.
## Requisitos previos
Antes de comenzar, asegúrese de:
1. **Tener una cuenta de Dify registrada**
Visite el [sitio web oficial de Dify](https://dify.ai/) para registrar una cuenta, elija la versión en la nube o autoalojada
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 sesión en Dify y acceder a la configuración
### 1.1 Acceder a la plataforma Dify
* **Versión en la nube:** Visite [https://cloud.dify.ai](https://cloud.dify.ai) e inicie sesión
* **Versión autoalojada:** Visite la dirección de su despliegue de Dify
*Interfaz principal de Dify que muestra la lista de aplicaciones y el botón de crear aplicación*
### 1.2 Navegar a la configuración de modelos
1. Haga clic en el **icono de avatar** en la esquina superior derecha
2. Seleccione **Settings**
3. Elija **Model Provider** en el menú izquierdo
*Encuentre la opción "Model Provider" en el menú izquierdo*
> [!NOTE]
>
> **Nota:** Dify admite la configuración de múltiples proveedores de modelos. Puede usar GccAi junto con otros proveedores.
## Paso 2: Añadir el proveedor de modelos GccAi
> [!NOTE]
>
> **Métodos de configuración:** Hay dos maneras de configurar GccAi en Dify:
>
> **Método 1 (Recomendado):** Usar la función de API personalizada del proveedor OpenAI
>
> * En la configuración del proveedor OpenAI, modifique directamente la Base URL a `https://gccai.heqingsong.uk/v1`
> * Introduzca su API Key de GccAi
> * Configuración más rápida y simple
>
> **Método 2:** Añadir como proveedor de modelos personalizado (método de esta guía)
>
> * Más flexible, puede gestionar el proveedor GccAi por separado
> * Conveniente para usar múltiples proveedores de API simultáneamente
>
> Ambos métodos son funcionalmente idénticos. Elija según su preferencia.
### 2.1 Seleccionar el método de configuración
#### Método 1: Usar la API personalizada de OpenAI (Recomendado)
1. Busque el proveedor **OpenAI** en la página Model Provider
2. Haga clic en el botón **Configure** o **Settings**
3. En la página de configuración:
* **API Key**: Introduzca su clave de API de GccAi (`sk-xxxxxxxxxxxx`)
* **API Base URL** o **Base URL**: Introduzca `https://gccai.heqingsong.uk/v1`
4. Haga clic en **Save**
*Configure la API Key y la Base URL de GccAi en el proveedor OpenAI*
5. Tras la configuración, regrese a la página del proveedor OpenAI y vea la **Model List**
6. En la lista de modelos, busque los modelos que necesita (p. ej., `gpt-4o`, `gpt-4o-mini`, `chatgpt-4o-latest`, etc.)
7. Haga clic en el **interruptor** en el lado derecho del modelo para habilitarlo (azul indica habilitado)
*Habilite los modelos que necesita en la lista de modelos de OpenAI*
> [!WARNING]
>
> **Importante:** ¡Habilite solo los modelos que sean realmente compatibles con GccAi!
>
> Aunque la lista de modelos de OpenAI de Dify muestra muchos modelos, solo aquellos compatibles con GccAi funcionarán correctamente. Habilitar modelos no compatibles provocará fallos en las llamadas a la API.
>
> Consulte la [Documentación de la API de GccAi](https://gccai.heqingsong.uk) para ver la lista completa de modelos compatibles.
> [!TIP]
>
> **Modelos compatibles y recomendados de GccAi:**
>
> **Serie GPT:**
>
> * `gpt-5` / `gpt-5-chat-latest`: modelos de la serie GPT-5
> * `chatgpt-4o-latest` / `gpt-4o`: último modelo GPT-4o
> * `gpt-4o-mini`: versión rápida y económica
> * `gpt-4.1` / `gpt-4.1-mini`: serie GPT-4.1
>
> **Serie Claude:**
>
> * `claude-sonnet-4-5-20250929`: Claude Sonnet 4.5
> * `claude-haiku-4-5-20251001`: Claude Haiku 4.5
>
> **Serie Gemini:**
>
> * `gemini-2.0-flash-exp`: Google Gemini 2.0 Flash
>
> Puede habilitar múltiples modelos simultáneamente y cambiar entre ellos de forma flexible en sus aplicaciones.
Tras finalizar, puede usarlo directamente. Salte al **Paso 3**.
#### Método 2: Añadir un proveedor de modelos personalizado
En la página Model Provider:
1. Desplácese hacia abajo hasta la sección **Custom Model**
2. Haga clic en el botón **+ Add Model**
*Desplácese hasta la sección de modelo personalizado y haga clic en el botón "+ Add Model"*
### 2.2 Configurar el proveedor GccAi
En el cuadro de diálogo de configuración, complete la siguiente información:
| Campo | Valor |
| - | - |
| **Model Name** | `GccAi` o nombre personalizado |
| **Model Type** | Seleccione `LLM` (Large Language Model) |
| **API Key** | Su clave de API de GccAi (`sk-xxxxxxxxxxxx`) |
| **API endpoint URL** | `https://gccai.heqingsong.uk/v1` |
| **Endpoint model name** | Introduzca el nombre del modelo específico (p. ej., `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929`, etc.) |
*Complete la configuración del proveedor 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-`
> * Asegúrese de que su clave de API tenga saldo suficiente
### 2.3 Añadir más modelos (opcional)
Para añadir más modelos, repita los pasos anteriores:
1. En la sección de modelo personalizado, haga clic de nuevo en el botón **+ Add Model**
2. Complete la información de configuración para otro modelo
3. Haga clic en Save
*Repita los pasos de añadir modelo para configurar múltiples modelos diferentes*
**Modelos recomendados para añadir:**
#### Serie GPT-4/5
| ID del modelo | Nombre del modelo | Longitud del contexto | Caso de uso |
| - | - | - | - |
| `gpt-5` | GPT-5 | 128.000 | Tareas complejas, procesamiento de texto largo |
| `gpt-4o` | GPT-4o | 128.000 | Chat de alta calidad, generación de código |
| `gpt-4o-mini` | GPT-4o Mini | 128.000 | Respuesta rápida, económico |
#### Serie Claude
| ID del modelo | Nombre del modelo | Longitud del contexto | Caso de uso |
| - | - | - | - |
| `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 | 200.000 | Razonamiento complejo, análisis de código |
| `claude-haiku-4-5-20251001` | Claude Haiku 4.5 | 200.000 | Respuesta rápida, tareas simples |
#### Serie Gemini
| ID del modelo | Nombre del modelo | Longitud del contexto | Caso de uso |
| - | - | - | - |
| `gemini-2.0-flash-exp` | Gemini 2.0 Flash | 32.000 | Multimodal, aplicaciones en tiempo real |
> [!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`
## Paso 3: Usar modelos de GccAi en aplicaciones
### 3.1 Crear una nueva aplicación
1. Regrese a la página de inicio de Dify
2. Haga clic en el botón **Create App**
3. Seleccione el tipo de aplicación:
* **Chatbot**: aplicación conversacional
* **Text Generator**: aplicación de generación de texto
* **Agent**: agente inteligente
* **Workflow**: aplicación de flujo de trabajo complejo
*Seleccione el tipo de aplicación para crear una nueva app*
### 3.2 Seleccionar un modelo de GccAi
En la página de orquestación de la aplicación:
1. Busque el área **Model Settings**
2. Haga clic en el menú desplegable **Select Model**
3. Seleccione el proveedor **GccAi**
4. Elija su modelo configurado (p. ej., `gpt-4o`)
*Seleccione el modelo del proveedor GccAi en la aplicación*
### 3.3 Configurar los parámetros del modelo
Ajuste los parámetros del modelo 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 |
| **Presence Penalty** | Reducir la repetición | 0.0-0.5 |
| **Frequency Penalty** | Reducir palabras frecuentes | 0.0-0.5 |
*Ajuste los parámetros del modelo según las necesidades de la aplicación*
## Paso 4: Construir y probar la aplicación
### 4.1 Añadir prompts
En la página de orquestación de la aplicación:
1. Escriba los prompts en el área **System Prompt**
2. Use variables para hacer su app dinámica:
* `{{variable_name}}`: variable de entrada del usuario
* `{{context}}`: contexto de la base de conocimiento
**Prompt de ejemplo:**
```
You are a professional customer service assistant, skilled at answering product questions.
Product Information: {{product_info}}
Please provide accurate and friendly answers based on user questions. If unsure, honestly inform the user.
User Question: {{user_question}}
```
*Escriba y configure los prompts en el editor de prompts*
### 4.2 Añadir base de conocimiento (opcional)
Si necesita la capacidad RAG (Generación Aumentada por Recuperación):
1. Haga clic en **Knowledge Base** en el menú izquierdo
2. Cree una nueva base de conocimiento y cargue documentos
3. Vincule la base de conocimiento en la página de orquestación de la aplicación
4. Configure los parámetros de recuperación
### 4.3 Probar la aplicación
1. Introduzca preguntas de prueba en el panel **Preview** de la derecha
2. Revise la efectividad de la respuesta de la IA
3. Ajuste los prompts y parámetros según sea necesario
4. Repita las pruebas hasta quedar satisfecho
*Pruebe la efectividad de la aplicación en el panel de previsualización*
### 4.4 Publicar la aplicación
Tras las pruebas:
1. Haga clic en el botón **Publish** en la parte superior derecha
2. Seleccione el método de publicación:
* **API Call**: integración mediante API
* **Embed in Website**: generar código embebido
* **Public Link**: generar enlace para compartir
*Seleccione el método de publicación adecuado*
## Paso 5: Supervisar y optimizar
### 5.1 Ver los registros de la aplicación
En la página de detalles de la aplicación:
1. Haga clic en la pestaña **Logs**
2. Vea todos los registros de conversaciones
3. Analice las preguntas de los usuarios y las respuestas de la IA
4. Descubra oportunidades de mejora
*Vea y analice los registros de uso de la aplicación*
### 5.2 Supervisar el uso de la API
Acceda a la [Consola de GccAi](https://gccai.heqingsong.uk/overview) para ver:
* 📊 **Estadísticas de llamadas a la API** - Total de llamadas, tasa de éxito
* 💰 **Detalles de costos** - Costos diarios/mensuales
* 📈 **Tendencias de uso** - Tendencias de cambio en el uso
* 🔍 **Registros de solicitudes** - Registros detallados de solicitudes
### 5.3 Optimizar el rendimiento de la aplicación
Optimice según los datos de supervisión:
1. **Ajuste la selección de modelos**
* Use `gpt-4o-mini` para tareas simples para reducir costos
* Use `gpt-4o` o `claude-sonnet-4-5` para tareas complejas para mejorar la calidad
2. **Optimice los prompts**
* Haga los prompts más claros y específicos
* Añada ejemplos para mejorar la efectividad
* Use cadena de pensamiento para un mejor razonamiento
3. **Configure el almacenamiento en caché**
* Habilite el caché para preguntas similares
* Reduzca los costos de llamadas a la API
## Características avanzadas
### Uso de la orquestación de flujos de trabajo
La función de flujos de trabajo de Dify le permite:
1. **Ramificaciones condicionales** - Ejecutar diferente lógica según las condiciones
2. **Colaboración multimodelo** - Combinar las ventajas de varios modelos
3. **Llamadas a herramientas externas** - Llamar a APIs, bases de datos y otros recursos externos
4. **Paso de variables** - Pasar datos entre diferentes nodos
### Configurar capacidades de Agente
Construya agentes inteligentes con los modelos de GccAi:
1. **Llamada a herramientas** - Permita que la IA llame a herramientas externas
2. **Gestión de memoria** - Mantenga la memoria de conversación a largo plazo
3. **Toma de decisiones autónoma** - La IA planifica de forma autónoma los pasos de ejecución
### Aplicaciones multimodales
Aproveche las capacidades multimodales de GccAi:
1. **Comprensión de imágenes** - Use `gpt-4o` o `claude-3` para procesar imágenes
2. **Generación de imágenes** - Integre la API de generación de imágenes de GccAi
3. **Procesamiento de voz** - Integre servicios TTS y STT
## 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 de que el servidor pueda acceder a `https://gccai.heqingsong.uk`
* Las versiones autoalojadas necesitan asegurar la conectividad de red del servidor
### Q2: ¿La respuesta del modelo es 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 longitud del prompt**:
* Reduzca el contexto innecesario
* Simplifique las descripciones del prompt
3. **Ajuste la recuperación de la base de conocimiento**:
* Reduzca el número de documentos recuperados
* Aumente el umbral de similitud
### Q3: ¿Las llamadas a la API fallan o devuelven errores?
**Errores comunes y soluciones:**
| Mensaje de error | Causa | Solución |
| - | - | - |
| `401 Unauthorized` | API Key inválida o expirada | Vuelva a obtener la API Key y actualice la configuración |
| `429 Too Many Requests` | Se excedió el límite de tasa de solicitudes | Ajuste la configuración de concurrencia de la app o espere y vuelva a intentarlo |
| `500 Internal Server Error` | Problema temporal del servidor | Espere unos minutos y vuelva a intentarlo |
| `insufficient_quota` | Saldo de cuenta insuficiente | Recargue en la consola |
| `context_length_exceeded` | La entrada excede la longitud del contexto | Reduzca la longitud de entrada o use un modelo con contexto mayor |
### Q4: ¿Cómo reducir los costos de uso de la API?
**Sugerencias de optimización de costos:**
1. **Selección de modelo**:
* Use `gpt-4o-mini` para tareas simples (el costo es solo 1/10 del de `gpt-4o`)
* Considere modelos más económicos para tareas por lotes
2. **Habilite el almacenamiento en caché**:
* Devuelva resultados en caché para las mismas preguntas
* Configure la coincidencia de similitud en Dify
3. **Optimice la longitud de salida**:
* Establezca un Max Tokens razonable
* Evite generar respuestas demasiado largas
4. **Use salida en streaming**:
* Mejore la experiencia del usuario sin aumentar los costos
### Q5: ¿Cómo manejar datos sensibles?
**Recomendaciones de seguridad de datos:**
1. **Use variables de entorno**:
* No codifique las API Keys en el código
* Use la función de variables de entorno de Dify
2. **Configure el control de acceso**:
* Establezca permisos de acceso a la aplicación
* Habilite la autenticación para las llamadas a la API
3. **Registros de auditoría**:
* Verifique regularmente los registros de la aplicación
* Supervise los patrones de acceso anormales
## Mejores prácticas
### 1. Ingeniería de prompts
**Prompts estructurados:**
```
# Role Definition
You are a professional [role description]
# Task Objective
You need to help users [task description]
# Output Requirements
- Requirement 1
- Requirement 2
- Requirement 3
# Input Information
{{user_input}}
```
### 2. Gestión de la base de conocimiento
* **Estrategia de fragmentación**: Establezca un tamaño razonable de fragmento de documento (se recomiendan 500-1000 caracteres)
* **Etiquetado de metadatos**: Añada metadatos a los documentos para facilitar la recuperación
* **Actualizaciones regulares**: Mantenga el contenido de la base de conocimiento actualizado
### 3. Manejo de errores
* **Mensajes amigables**: Proporcione mensajes de error claros a los usuarios
* **Estrategia de respaldo**: Cambie al modelo de respaldo cuando el principal falle
* **Mecanismo de reintento**: Reintento automático para errores temporales
### 4. Supervisión del rendimiento
* **Establezca alertas**: Alerta de saldo bajo, altas tasas de error
* **Análisis regular**: Analice los datos de uso semanal/mensualmente
* **Optimización continua**: Ajuste la configuración según los datos
## Ejemplos de casos de uso
### 1. Atención al cliente inteligente
**Configuración de la aplicación:**
* Modelo: `gpt-4o-mini` (económico)
* Base de conocimiento: documentos de producto, FAQ
* Características: respuesta automática a preguntas comunes, escalar problemas complejos a humanos
### 2. Asistente de creación de contenido
**Configuración de la aplicación:**
* Modelo: `gpt-4o` o `claude-sonnet-4-5` (alta calidad)
* Características: generación de artículos, reescritura, pulido
* Parámetros: Temperature=0.8 (potenciar la creatividad)
### 3. Asistente de código
**Configuración de la aplicación:**
* Modelo: `claude-sonnet-4-5` (excelente para código)
* Características: generación de código, explicación, depuración
* Base de conocimiento: documentos del proyecto, documentos de la API
### 4. Asistente de análisis de datos
**Configuración de la aplicación:**
* Modelo: `gpt-4o` (gran capacidad de razonamiento)
* Herramientas: ejecución de código Python, visualización de datos
* Características: análisis de datos, generación de informes
## Características
Usando Dify + GccAi, puede:
* 🤖 **Construir aplicaciones de IA rápidamente** - Cree aplicaciones de IA potentes sin codificar
* 📚 **Mejora con base de conocimiento** - La tecnología RAG permite a la IA responder según sus datos
* 🔧 **Flujos de trabajo flexibles** - Orqueste visualmente lógica de IA compleja
* 🎯 **Gestión precisa de prompts** - Control de versiones y pruebas A/B
* 📊 **Supervisión y análisis completos** - Comprenda el uso y el rendimiento de la app
* 🔌 **Múltiples métodos de integración** - API, embebido, WebApp y más
* 👥 **Colaboración en equipo** - Admite desarrollo colaborativo multiusuario
* 🌐 **Soporte multimodelo** - Cambie de forma flexible entre diferentes modelos de IA
## Soporte y ayuda
Si encuentra algún problema:
* 📚 [Documentación de GccAi](https://gccai.heqingsong.uk)
* 📚 [Documentación oficial de Dify](https://docs.dify.ai)
* 💬 [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 aplicaciones de IA potentes en Dify!
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.