> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sofiachat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de IA

> Instrucciones, modelo, temperatura, escalado a humano y base de conocimiento.

<Info>Espacios → clic en el nodo **Agente** · Panel con tres pestañas: **Agente**, **Funciones** y **Docs**</Info>

## Pestaña Agente

### Identidad

| Campo           | Qué hace                                                                                                                                                                           |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**      | Cómo se llama el asistente. Puedes usarlo en las instrucciones con la variable `{{nombre_asistente}}`.                                                                             |
| **Instrucción** | El texto más importante de toda la configuración: quién es el agente, cómo habla, qué hace y qué no. Se edita en pantalla completa (ver abajo).                                    |
| **Plantilla**   | Tres puntos de partida: **Atención al cliente**, **Ventas** y **Soporte técnico**. Al elegir una, reemplaza la instrucción. Si la editas, el campo pasa a mostrar *Personalizada*. |

#### Escribir buenas instrucciones

El editor de instrucción muestra el contador de caracteres y dos variables insertables: `{{organizacion}}` (nombre de tu organización) y `{{nombre_asistente}}`.

<Tip>
  **Estructura que funciona:**

  1. **Identidad y tono.** *"Eres {{nombre_asistente}}, asistente de {{organizacion}}. Hablas en español neutro, de usted, con frases cortas."*
  2. **Qué sí hace.** *"Informas sobre pólizas, coberturas y estados de cuenta usando únicamente la base de conocimiento."*
  3. **Qué no hace (con ejemplos).** *"Nunca prometes coberturas, precios ni plazos que no estén en los documentos. Si no sabes algo, dilo y ofrece derivar a un agente."*
  4. **Cuándo escalar.** *"Si reportan un accidente, pide nombre, placa y ubicación y transfiere a un humano de inmediato. Si el cliente pide hablar con una persona, transfiere."*
  5. **Formato.** *"Máximo 3 frases por respuesta. Sin emojis. Sin listas salvo que el cliente pida pasos."*

  Escribe reglas concretas, no adjetivos: *"sé amable"* no cambia nada; *"saluda por el nombre si lo conoces y pregunta en qué puedes ayudar"* sí.
</Tip>

### Modelo

| Campo           | Opciones                                                             | Cuándo                                                                                                                                                                               |
| --------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Motor**       | **SofiaLLM-1** · **SofiaLLM-2**                                      | SofiaLLM-1 es el predeterminado y el más rápido. SofiaLLM-2 sigue instrucciones largas con más precisión; úsalo si el agente "se olvida" de reglas o maneja muchos documentos.       |
| **Temperatura** | Deslizador de *Preciso* (0.00) a *Creativo* (1.00), por defecto 0.70 | Para atención al cliente y datos (pólizas, saldos, pedidos) baja a **0.2–0.4**: respuestas consistentes y pegadas a los documentos. Para ventas o conversación más natural, 0.6–0.8. |

### Comportamiento

**Escalar a humano** (interruptor): permite al agente transferir la conversación a una persona cuando sus instrucciones lo indiquen o el cliente lo pida. Se guarda al instante. Apagado, la IA nunca escala por sí misma y solo un agente puede tomar la conversación manualmente. Ver [Atención humana](/guia/05-hitl).

### Guardar

Nombre, instrucción, motor y temperatura se guardan con **Guardar** al pie del panel. El interruptor de escalado y la pestaña Docs se guardan solos.

## Pestaña Funciones

Lista de herramientas del agente, con el método y la URL de cada una y su estado (**OK** si está configurada, **Sin probar** si le falta la URL). **+ Nueva función** abre el catálogo. Ver [Herramientas](/guia/08-espacios/herramientas).

El contador *N de M en tu plan* muestra el límite de herramientas del plan; al alcanzarlo, **Ampliar plan** abre la comparativa.

## Pestaña Docs (base de conocimiento)

Los documentos que el agente puede consultar para responder: catálogos, condiciones, preguntas frecuentes, políticas, listas de precios.

* **Arrastra archivos** o pulsa **+ Subir archivos** (varios a la vez). Se guardan al subirlos.
* Formatos: PDF, Word (doc, docx), PowerPoint (pptx), texto (txt, md), y archivos de código y datos (json, html, csv como txt, etc.).
* Cada archivo muestra su fecha y un icono para eliminarlo.

<Note>
  **Cómo usa el agente los documentos.** No los "lee" enteros en cada respuesta: busca los fragmentos más relevantes a la pregunta y responde con ellos. Por eso funciona mejor con documentos claros y bien titulados que con un PDF de 200 páginas escaneado. Si un documento es una imagen escaneada sin texto, el agente no podrá leerlo.
</Note>

<Tip>
  **Después de subir un documento, prueba con una pregunta cuya respuesta esté en él.** Si el agente no la encuentra, suele ser porque el documento no la expresa como la preguntaría un cliente: añade una sección de preguntas frecuentes al documento con las preguntas tal como las hacen ellos.
</Tip>