Configurar Silvio en tu instancia

Para qué sirve

Dejar Silvio listo para que tu equipo lo use: agente activo, prompt definido, modelo IA conectado y herramientas autorizadas.

Antes de empezar

• Permiso de administrador en la instancia Futuh.
• Una clave de API del proveedor del modelo IA que vayas a usar (por defecto: OpenRouter).
• Idea clara de qué herramientas quieres que Silvio pueda invocar (puedes ajustarlas más adelante).
• Tiempo estimado: 20-30 min para la primera configuración.

Verificar el agente Silvio

Silvio viene preconfigurado como un agente IA llamado Silvio Web en instancias Futuh nuevas.

1. Abre Ajustes → Técnico → IA → Agentes IA.
2. Verifica que aparece el registro Silvio Web con estado activo.
3. Haz clic sobre el registro para abrirlo.
4. Comprueba que tiene asignado un prompt del sistema y un modelo IA. Si alguno está vacío, sigue las secciones siguientes.

Si no existe el agente, créalo desde el botón Nuevo. El nombre canónico es Silvio Web para que coincida con la documentación.

Ajustar el prompt del sistema

El prompt del sistema define cómo se comporta Silvio: tono, qué puede prometer, cuándo escalar a humano, en qué idioma responder.

1. Desde la ficha del agente, abre el campo Prompt del sistema y haz clic en el enlace.
2. Verás un registro de tipo ai.system.prompt con el contenido del prompt.
3. Edita el campo Rol para cambiar la descripción del agente.
4. Edita Comportamiento y Restricciones para ajustar el tono, los límites o la lista de motivos por los que Silvio debe transferir a humano.
5. Guarda y cierra.

Cambios en caliente

Los cambios en el prompt se aplican a las conversaciones nuevas. Las conversaciones ya abiertas siguen con el prompt anterior hasta que se cierran.

Conectar el modelo IA

Silvio necesita un modelo IA externo para generar respuestas. La configuración por defecto usa Claude Sonnet 4 a través de OpenRouter. Se puede cambiar a Mistral, GPT u otros modelos compatibles.

1. Ve a Ajustes → Técnico → IA → Proveedores IA.
2. Abre el proveedor OpenRouter (o crea uno nuevo si vas a usar otro).
3. Pega tu clave de API en el campo API Key.
4. Guarda. Verás el estado Conectado si la clave es válida.
5. Vuelve a la ficha del agente Silvio y, en Modelo IA, elige el modelo que quieres usar por defecto.

Para configurar varios modelos en cascada (uno principal, otros de respaldo), ver Conectar tu propia IA. Si tu organización tiene política de no depender de proveedores externos, esa misma página describe cómo apuntar Silvio a un modelo desplegado en tu infraestructura.

Autorizar herramientas

Silvio solo puede invocar las herramientas o tools que tenga autorizadas en su tema (ai.topic). Por defecto vienen activas las herramientas básicas de consulta. Las herramientas de escritura están desactivadas hasta que las autorices.

1. Desde la ficha del agente, abre el campo Tema.
2. Verás la lista de herramientas disponibles. Cada una tiene nombre canónico (read_lead, do_create_task, etc.).
3. Marca las herramientas que quieres autorizar. Las que empiezan por read_ consultan datos. Las que empiezan por do_ modifican datos.
4. Guarda.

Permisos y herramientas

Que Silvio tenga una herramienta autorizada no anula los permisos del usuario que conversa. Si Silvio invoca read_lead por encargo de una persona sin acceso al módulo CRM, la herramienta devolverá vacío. La capa de seguridad del ERP sigue mandando.

Instalar un Agent Pack

Un Agent Pack es un conjunto de agentes, prompts y herramientas que se distribuyen como paquete. La Federación Futuh publica packs sectoriales que tu instancia puede instalar para ganar agentes especializados (por ejemplo, un agente de incidencia política, otro de gestión de ayudas).

1. Ve a Ajustes → Apps.
2. Busca el módulo futuh_agents_pack (o el nombre del pack sectorial que te interesa).
3. Instálalo. Esto creará automáticamente los agentes y prompts del pack.
4. Revisa los agentes nuevos en IA → Agentes IA y ajusta el modelo IA o las herramientas si lo necesitas.

Los Agent Packs publicados por la Federación se actualizan periódicamente. Cuando se publica una versión nueva del pack, tu instancia recibe el aviso desde el Hub Central. La actualización es opcional.

Configurar la persona que recibe las transferencias

Cuando Silvio transfiere una conversación, la pasa a la persona que hayas designado como soporte humano.

1. Ve a Ajustes → Técnico → Parámetros del sistema.
2. Busca el parámetro futuh_chatbot.transfer_user_id.
3. Pon el ID del usuario que recibirá las transferencias. Por defecto es la persona administradora.
4. Guarda. Los cambios se aplican a las transferencias nuevas.

Próximos pasos

• Chatear con Silvio en el día a día: para validar que la configuración funciona desde la vista del operador.
• Instalar el widget en una web propia: si quieres exponer Silvio también en la web pública.
• Conectar tu propia IA: para configurar modelos alternativos o despliegues locales.
• Glosario: agente, tool, agent pack: si los términos de esta página te suenan nuevos.