Documentación de AI Super Agent

Tabla de Contenidos

Introducción

AI Super Agent es un plugin premium para WordPress que le permite crear e implementar múltiples asistentes impulsados por IA en su sitio web. Cada agente tiene su propia interfaz, instrucciones y apariencia, lo que le permite ofrecer experiencias de IA personalizadas a sus visitantes.

El plugin se conecta a varios proveedores de IA (OpenAI, Anthropic Claude, Mistral AI) y puede utilizarse para una amplia variedad de aplicaciones como soporte al cliente, consultas especializadas, asistencia técnica, asesoramiento legal, ayuda organizativa, apoyo psicológico y mucho más.

Instalación

Requisitos Previos

WordPress 5.0 o superior
PHP 7.2 o superior
Acceso de administrador a su sitio WordPress

Procedimiento de Instalación

Descargue el archivo ZIP del plugin desde su área de cliente o el email de confirmación de compra
En su panel de WordPress, vaya a Plugins > Añadir Nuevo
Haga clic en Subir Plugin en la parte superior de la página
Seleccione el archivo ZIP descargado y haga clic en Instalar Ahora
Una vez completada la instalación, haga clic en Activar Plugin

Después de la activación, aparecerá un nuevo menú de AI Super Agent en su panel de WordPress.

Configuración Global

Antes de crear sus agentes, necesita configurar los ajustes globales del plugin.

En el menú de WordPress, haga clic en AI Super Agent > Ajustes Globales
En la pestaña Ajustes de API, configure:
- Proveedor de API: Seleccione su proveedor preferido (OpenAI, Anthropic o Mistral)
- Clave API: Introduzca su clave API para el proveedor seleccionado
- Modelo de IA: Elija el modelo de IA que desea utilizar

Obtención de Claves API

OpenAI: Regístrese en https://platform.openai.com/ y cree una clave API en la sección API Keys
Anthropic (Claude): Obtenga una clave API en https://console.anthropic.com/
Mistral AI: Regístrese en https://console.mistral.ai/ para obtener una clave API

Configuración de Notificaciones

En la pestaña Notificaciones:

Email de Notificación: Establezca la dirección de email que recibirá las notificaciones de envío de formularios

Configuración de reCAPTCHA (opcional)

Si desea proteger sus formularios contra spam:

En la pestaña reCAPTCHA, configure:

Versión de reCAPTCHA: Elija entre reCAPTCHA v2 (casilla de verificación) o v3 (invisible)
Clave del Sitio: Introduzca su clave de sitio reCAPTCHA
Clave Secreta: Introduzca su clave secreta reCAPTCHA

Para obtener estas claves, visite https://www.google.com/recaptcha/admin y cree un nuevo sitio.

Creación y Gestión de Agentes

Crear un Nuevo Agente

En el menú de WordPress, vaya a AI Super Agent > Agentes
Haga clic en el botón Añadir Agente en la parte superior de la página
Complete la información básica en la pestaña General:
- Nombre del Agente: Asigne un nombre descriptivo a su agente (visible solo en administración)
- Descripción: Añada una descripción para ayudarle a identificar el agente
- Nombre del Parámetro: Personalice el parámetro utilizado en el shortcode (predeterminado: «id»)
- Estado del Agente: Habilite o deshabilite el agente

Gestionar Agentes Existentes

En la página AI Super Agent > Agentes, puede:

Habilitar/Deshabilitar un agente haciendo clic en el indicador de estado
Editar un agente para cambiar su configuración
Duplicar un agente para crear una copia con los mismos ajustes
Eliminar un agente que ya no utilice

Personalización de Formularios

La pestaña Formulario le permite personalizar la interfaz de usuario de su agente.

Plantilla de Formulario

La plantilla de formulario utiliza un sistema de shortcodes para crear diferentes tipos de campos:

Área de texto: [textarea* field_name] (el asterisco indica un campo obligatorio)
Botones de radio: [radio field_name default:1 "Opción 1" "Opción 2"]
Casillas de verificación: [checkbox field_name "Opción 1" "Opción 2" "Opción 3"]
Fecha: [date* field_name]
Campo de texto: [text field_name]

Ejemplo de un formulario simple:

<p>Describa su problema en detalle para obtener un análisis y solución.</p>

<label>Describa su problema:</label>
[textarea* problem_description placeholder "Explique su problema en detalle..."]

<label>Fecha límite (si aplica):</label>
[date deadline]

<label>Dominio específico:</label>
[radio domain default:1 "Técnico" "Legal" "Organizativo" "Personal" "Otro"]

<label>Contexto adicional (opcional):</label>
[textarea additional_context placeholder "Cualquier información adicional relevante..."]

Texto del Botón de Envío

Personalice el texto del botón que envía el formulario (por ejemplo: «Analizar», «Enviar», «Obtener una respuesta», etc.).

Configuración de Prompts

La pestaña Prompt de IA le permite configurar las instrucciones enviadas a la IA.

Prompt de Análisis

El prompt de análisis es el texto enviado a la IA cuando un usuario envía el formulario. Puede utilizar variables entre llaves {nombre_variable} para insertar los valores de los campos del formulario.

Ejemplo de prompt:

Eres un experto en resolución de problemas. Por favor, analiza el siguiente problema y proporciona una solución estructurada.

Descripción del problema: {problem_description}

Fecha límite: {deadline}

Dominio: {domain}

Contexto adicional: {additional_context}

Por favor, analiza este problema y proporciona:
1. Un resumen claro del problema
2. Posibles causas o factores subyacentes
3. 2-3 soluciones prácticas con sus ventajas y desventajas
4. Una implementación paso a paso de la mejor solución
5. Recursos o herramientas que podrían ayudar

Sé específico, práctico y orientado a soluciones. Evita consejos genéricos. Si necesitas más información, indica qué sería útil saber.

Plantilla de Resultado

La pestaña Resultado le permite personalizar la visualización de la respuesta de la IA. Utilice la variable {result} para insertar la respuesta de la IA en su plantilla.

Ejemplo de plantilla de resultado:

<h2>Análisis y Solución</h2>
<div class="analysis-container">
    <p align="justify">{result}</p>
</div>

Mostrar Formulario Después del Resultado

Elija si desea que el formulario permanezca visible después de que se muestre el resultado.

Personalización Visual

La pestaña Apariencia le permite personalizar el aspecto visual de su agente.

Opciones de Color

Color de Fondo: Establece el color principal de fondo
Color de Texto: Establece el color del texto
Color del Botón de Envío: Establece el color del botón
Color del Halo: Establece el color del efecto halo (para la animación de estrellas)

Animación de Estrellas

Active o desactive la animación de estrellas en el fondo.

CSS Personalizado

Añada su propio CSS para personalizar aún más la apariencia. Puede utilizar las siguientes variables en su CSS:

{background_color}: Color de fondo seleccionado
{text_color}: Color de texto seleccionado
{submit_button_color}: Color de botón seleccionado
{halo_color}: Color de halo seleccionado

Ejemplo de CSS personalizado:

.aiagent-container::before {
    background: linear-gradient(to bottom, white 0%, {background_color} 20%, {background_color} 80%, white 100%);
}
.aiagent-form {
    color: {text_color};
}
.aiagent-submit-button {
    background-color: {submit_button_color};
}

Seguridad y reCAPTCHA

La pestaña Seguridad le permite configurar opciones de protección contra spam.

Habilitar reCAPTCHA

Si ha configurado reCAPTCHA en los ajustes globales, puede habilitarlo o deshabilitarlo para cada agente individualmente.

Cuando reCAPTCHA está habilitado:

La versión v2 mostrará una casilla «No soy un robot»
La versión v3 funcionará en segundo plano sin requerir interacción del usuario

Notificaciones por Email

La pestaña Notificaciones le permite configurar alertas por email.

Enviar Email con Resultados

Habilite o deshabilite el envío de emails para este agente.

Asunto del Email

Personalice el asunto de los emails de notificación enviados cuando un usuario envía el formulario.

Uso de Shortcodes

Para mostrar un agente en su sitio, utilice el siguiente shortcode en una página o entrada:

[ai_super_agent id="slug-de-su-agente"]

Donde «slug-de-su-agente» es el slug generado automáticamente para su agente (visible en la lista de agentes).

Si ha personalizado el nombre del parámetro (por ejemplo, «agent» en lugar de «id»), puede usar:

[ai_super_agent agent="slug-de-su-agente"]

Colocación Múltiple

Puede colocar diferentes agentes en diferentes páginas o incluso múltiples agentes en la misma página.

Preguntas Frecuentes y Solución de Problemas

Preguntas Frecuentes

P: ¿Cuántos agentes puedo crear?

R: Puede crear un número ilimitado de agentes.

P: ¿Pueden los visitantes ver qué IA se está utilizando?

R: No, el proveedor de IA y el modelo utilizado no son visibles para los visitantes.

P: ¿Puedo usar este plugin sin una clave API?

R: No, debe proporcionar una clave API válida para al menos uno de los proveedores compatibles.

P: ¿El plugin almacena las conversaciones con la IA?

R: No, el plugin no registra las conversaciones en la base de datos. Si habilita las notificaciones por email, las consultas y respuestas se enviarán a la dirección de email especificada.

Problemas Comunes

Error: «Clave API no proporcionada»

Compruebe que ha introducido su clave API en los ajustes globales para el proveedor que seleccionó.

Error: «Error de conexión» o tiempo de espera agotado

Estos errores pueden ocurrir si:

Su servidor tiene problemas de conexión a Internet
El proveedor de IA está experimentando problemas
Su clave API ha alcanzado sus límites de uso

El formulario se muestra pero no se genera ninguna respuesta

Compruebe:

Que su clave API es válida y está activa
Que ha configurado correctamente el prompt de análisis
Que todas las variables en el prompt corresponden a campos existentes en su formulario

Problemas con reCAPTCHA

Si reCAPTCHA no funciona correctamente:

Compruebe que sus claves de sitio y secretas son correctas
Asegúrese de que el dominio de su sitio está autorizado en la consola de reCAPTCHA
Intente deshabilitar temporalmente reCAPTCHA para comprobar si el problema proviene de ahí

Para cualquier otra pregunta o problema, póngase en contacto con nuestro soporte técnico.

Archives

Catégories