Modelos del Agente

Este documento describe cómo puedes configurar diferentes proveedores de IA para tu agente, permitiéndote trabajar con OpenAI, Claude (Anthropic) y Gemini (Google) según tus necesidades.

Configuración

Por defecto, todos los agentes en Plazbot utilizan el token de OpenAI configurado en tu workspace. Sin embargo, puedes habilitar la Configuración Personalizada de IA para:

Usar diferentes proveedores de IA (OpenAI, Claude, Gemini)
Configurar modelos específicos para cada proveedor
Ajustar parámetros como temperatura y longitud de respuesta
Usar tus propios tokens de API para cada proveedor
Tener múltiples proveedores configurados con uno por defecto

Importante: Debes agregar al menos un proveedor de IA después de activar la configuración personalizada. Si el array está vacío, el sistema usará la configuración por defecto del workspace.

Proveedor de IA

Cada proveedor requiere la siguiente información: Campos Obligatorios

Campo	Descripción
Proveedor	Selecciona entre OpenAI, Claude o Gemini
Modelo	Modelo específico del proveedor a utilizar
API Token	Token de autenticación del proveedor

Campos Opcionales

Campo	Descripción	Valor Recomendado
Temperatura	Controla la creatividad de las respuestas (0-2)	0.7
Longitud Máxima	Máximo de tokens en la respuesta	4096
Proveedor por defecto	Define cuál proveedor usar si tienes varios	Activar en uno

Temperatura

La temperatura controla cuán creativas o predecibles serán las respuestas de la IA:

Valor	Comportamiento	Casos de Uso
0 - 0.3	Muy consistente y predecible	Soporte técnico, respuestas precisas
0.5 - 0.7	Balance ideal	Uso general, atención al cliente
1.0 - 1.5	Creativo y variado	Marketing, contenido creativo
1.5 - 2.0	Muy creativo	Escritura creativa, brainstorming

Ejemplos prácticos:

Temperatura 0 - Respuesta Técnica Precisa

Pregunta: “¿Cuál es el proceso para resetear mi contraseña?”Respuesta (Temperatura 0): “Para resetear tu contraseña sigue estos pasos:

Haz clic en ‘Olvidé mi contraseña’
Ingresa tu email registrado
Revisa tu correo y haz clic en el enlace
Crea tu nueva contraseña”

Nota: La respuesta será prácticamente idéntica cada vez.

Temperatura 0.7 - Balance Ideal

Pregunta: “¿Cómo puedo mejorar mi productividad?”Respuesta (Temperatura 0.7): “Aquí te dejo algunas estrategias efectivas:

Usa la técnica Pomodoro (25 min trabajo, 5 min descanso)
Prioriza tareas importantes al inicio del día
Elimina distracciones durante bloques de trabajo
Establece objetivos diarios claros”

Nota: Respuestas útiles y variadas sin ser impredecibles.

Temperatura 1.5 - Creativo

Pregunta: “Dame ideas para un eslogan de marca”Respuesta (Temperatura 1.5): “¡Aquí van algunas opciones creativas!

‘Donde tu visión cobra vida’
‘Innovación que inspira futuro’
‘Tu éxito, nuestra pasión’
‘Transformando sueños en realidad’

¿Te gustaría explorar algún estilo en particular?”Nota: Más creativo y variado en cada generación.

Longitud Máxima (Max Tokens)

Define el límite máximo de tokens que puede generar la IA en su respuesta:

Valor	Longitud	Uso Recomendado
1024	Corta (~700 palabras)	Respuestas breves
2048	Mediana (~1,400 palabras)	Explicaciones moderadas
4096	Larga (~2,800 palabras)	Uso general
8192	Muy larga (~5,600 palabras)	Análisis detallados
16384	Extra larga (~11,200 palabras)	Documentos completos

Recomendación: Usa 4096 tokens para la mayoría de casos. Es suficiente para respuestas completas sin consumir recursos innecesarios.

Ejemplos prácticos:

1024 tokens - Respuesta Concisa

Uso ideal: Preguntas simples, confirmaciones, respuestas rápidasEjemplo: “¿Cuál es el horario de atención?”“Nuestro horario es de lunes a viernes de 9:00 AM a 6:00 PM, y sábados de 10:00 AM a 2:00 PM.”

4096 tokens - Explicación Completa (Recomendado)

Uso ideal: Explicaciones detalladas, tutoriales, consultas complejasEjemplo: “¿Cómo funciona su proceso de onboarding?”“Nuestro proceso de onboarding consta de 5 fases:

Registro inicial - Completas tu perfil con información básica…
Verificación - Validamos tu identidad mediante…
Configuración - Personalizas tu espacio de trabajo…
Capacitación - Accedes a tutoriales interactivos…
Lanzamiento - Empiezas a usar la plataforma…”

8192 tokens - Análisis Extenso

Uso ideal: Análisis profundos, reportes, documentación técnicaEjemplo: “Explícame todo sobre su arquitectura de seguridad”La respuesta incluiría múltiples secciones con detalles técnicos extensos sobre encriptación, autenticación, protocolos, compliance, etc.

Ejemplo de Configuración Múltiple

{
  "customAIConfig": true,
  "aiProviders": [
    {
      "provider": "openai",
      "model": "gpt-4o",
      "apiToken": "sk-proj-xxxxx",
      "temperature": 0.7,
      "maxTokens": 4096,
      "isDefault": true
    },
    {
      "provider": "claude",
      "model": "claude-3-5-sonnet-20241022",
      "apiToken": "sk-ant-xxxxx",
      "temperature": 0.5,
      "maxTokens": 8192,
      "isDefault": false
    },
    {
      "provider": "gemini",
      "model": "gemini-1.5-flash",
      "apiToken": "AIza-xxxxx",
      "temperature": 0.7,
      "maxTokens": 4096,
      "isDefault": false
    }
  ]
}

Nota: Solo un proveedor puede tener `isDefault: true`. Este será el que use el agente para responder consultas.

Seguridad

Nunca compartas tus tokens de API públicamente
Rota tus tokens periódicamente
Configura límites de gasto en las consolas de los proveedores
Revisa logs de uso regularmente

Mejores Prácticas

Empieza con valores por defecto: Usa temperature 0.7 y 4096 tokens
Prueba antes de producción: Experimenta con diferentes configuraciones
Monitorea costos: Revisa tu uso mensual en cada proveedor
Documenta cambios: Registra qué configuración funciona mejor para tu caso
Usa modelos apropiados: No uses modelos caros para tareas simples

Tip Pro: Para casos de uso específicos:

Atención al cliente: GPT-4o o Claude Sonnet con temperatura 0.7
Contenido creativo: GPT-4 con temperatura 1.0-1.5
Análisis técnico: GPT-4o o Claude Opus con temperatura 0.3
Alto volumen/bajo costo: GPT-3.5-turbo o Gemini Flash

Introducción

Primeros Pasos

Contactos

Agente de IA

Marketing

Partners Marca Blanca

Legal

Configuración

Proveedor de IA

Temperatura

Longitud Máxima (Max Tokens)

Ejemplo de Configuración Múltiple

Seguridad

Mejores Prácticas

​Configuración

​Proveedor de IA

​Temperatura

​Longitud Máxima (Max Tokens)

​Ejemplo de Configuración Múltiple

​Seguridad

​Mejores Prácticas

Configuración

Proveedor de IA

Temperatura

Longitud Máxima (Max Tokens)

Ejemplo de Configuración Múltiple

Seguridad

Mejores Prácticas