Uso de OneAster en Dify

​

Requisitos previos

1. Tener una cuenta de Dify registrada Visite el sitio web oficial de Dify para registrar una cuenta, elija la versión en la nube o autoalojada
2. Haber obtenido una clave de API de OneAster Acceda a la Consola de OneAster para obtener su clave de API (comienza con sk-)

​

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 e inicie sesión
• Versión autoalojada: Visite la dirección de su despliegue de Dify

​

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

​

Paso 2: Añadir el proveedor de modelos OneAster

​

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 OneAster (sk-xxxxxxxxxxxx)
   • API Base URL o Base URL: Introduzca https://api.oneaster.ai/v1
4. Haga clic en Save

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)

​

Método 2: Añadir un proveedor de modelos personalizado

1. Desplácese hacia abajo hasta la sección Custom Model
2. Haga clic en el botón + Add Model

​

2.2 Configurar el proveedor OneAster

​

2.3 Añadir más modelos (opcional)

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

​

Serie GPT-4/5

​

Serie Claude

​

Serie Gemini

​

Paso 3: Usar modelos de OneAster 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

​

3.2 Seleccionar un modelo de OneAster

1. Busque el área Model Settings
2. Haga clic en el menú desplegable Select Model
3. Seleccione el proveedor OneAster
4. Elija su modelo configurado (p. ej., gpt-4o)

​

3.3 Configurar los parámetros del modelo

​

Paso 4: Construir y probar la aplicación

​

4.1 Añadir prompts

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

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}}

​

4.2 Añadir base de conocimiento (opcional)

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

​

4.4 Publicar la aplicación

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

​

Paso 5: Supervisar y optimizar

​

5.1 Ver los registros 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

​

5.2 Supervisar el uso de la API

• 📊 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

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

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

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

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 OneAster
3. Procesamiento de voz - Integre servicios TTS y STT

​

Preguntas frecuentes

​

Q1: ¿No se puede conectar al servicio de OneAster?

1. Verifique la Base URL:
   • Asegúrese de que sea https://api.oneaster.ai/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 OneAster
3. Verifique la conexión de red:
   • Asegúrese de que el servidor pueda acceder a https://api.oneaster.ai
   • Las versiones autoalojadas necesitan asegurar la conectividad de red del servidor

​

Q2: ¿La respuesta del modelo es lenta?

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?

​

Q4: ¿Cómo reducir los costos de uso de la API?

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?

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

# 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

• 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

• 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

• 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

• 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

• 🤖 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

• 📚 Documentación de OneAster
• 📚 Documentación oficial de Dify
• 💬 Comunidad de Discord
• 🐦 Twitter @oneaster_
• 📧 Soporte técnico: [email protected]