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

# Modelos de Análisis

> Gestiona los modelos de evaluación en la aplicación

## Que son los Modelos?

Los modelos de análisis definen **como** Neuracall evalúa cada llamada. Cada modelo contiene:

* **Categorías**: Agrupaciones de criterios relacionados
* **Variables**: Criterios específicos a evalúar
* **Pesos**: Importancia relativa de cada criterio

## Ver Modelos Disponibles

En la aplicación, los modelos aparecen en:

1. **Selector de modelo** en filtros del Dashboard
2. **Selector de modelo** al crear nuevo análisis
3. **Campo de modelo** en el detalle de análisis

## Estructura de un Modelo

### Ejemplo: Modelo de Servicio al Cliente

<Tree>
  <Tree.Folder name="Modelo: Evaluación Servicio Cliente" defaultOpen>
    <Tree.Folder name="Apertura (25%)" defaultOpen>
      <Tree.File name="Saludo cordial (10 pts)" />

      <Tree.File name="Identificación correcta (10 pts)" />

      <Tree.File name="Detección de necesidad (5 pts)" />
    </Tree.Folder>

    <Tree.Folder name="Desarrollo (50%)" defaultOpen>
      <Tree.File name="Escucha activa (15 pts)" />

      <Tree.File name="Solución propuesta (20 pts)" />

      <Tree.File name="Manejo de objeciones (15 pts)" />
    </Tree.Folder>

    <Tree.Folder name="Cierre (25%)" defaultOpen>
      <Tree.File name="Resumen de acuerdos (10 pts)" />

      <Tree.File name="Ofrecimiento adicional (5 pts)" />

      <Tree.File name="Despedida profesional (10 pts)" />
    </Tree.Folder>
  </Tree.Folder>
</Tree>

## Categorías

Las categorías organizan los criterios de evaluación en grupos logicos:

| Categoría Tipica | Proposito                           |
| ---------------- | ----------------------------------- |
| Apertura         | Evaluación del inicio de la llamada |
| Desarrollo       | Cuerpo principal de la interacción  |
| Cierre           | Finalizacion de la llamada          |
| Cumplimiento     | Elementos legales/regulatorios      |

## Variables

Cada variable representa un criterio específico:

| Propiedad   | Descripción                                  |
| ----------- | -------------------------------------------- |
| Key         | Identificador único (ej: `greeting_quality`) |
| Nombre      | Nombre legible (ej: "Calidad del Saludo")    |
| Descripción | Que se evalúa exactamente                    |
| Tipo        | STRING, INTEGER, DECIMAL, BOOLEAN, etc.      |
| Peso        | Puntuación maxima posible                    |

## Crear Modelos via API

Los modelos se crean y gestionan principalmente via API:

```bash theme={null}
curl -X POST https://api.neuracall.com/v1/models \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Modelo de Evaluación",
    "description": "Modelo para llamadas de soporte",
    "prompt": "...",
    "template_variables": [...]
  }'
```

<Card title="API de Modelos" icon="code" href="/api-reference/models/create">
  Ver documentación completa de la API
</Card>

## Mejores Practicas

### Diseño de Categorías

<Tip>
  Usa 3-5 categorías principales. Demasiadas categorías hacen dificil identificar patrones.
</Tip>

### Variables Efectivas

1. **Especificas**: "Menciono su nombre" vs "Fue cordial"
2. **Medibles**: Comportamientos observables
3. **Relevantes**: Alineadas con objetivos de negocio

### Pesos Balanceados

* Asigna más peso a lo más importante
* Evita que una sola variable domine el score
* Revisa periodicamente la distribucion

## Iterar y Mejorar

1. **Analiza resultados**: Revisa si los scores reflejan la calidad real
2. **Ajusta pesos**: Si una categoría siempre es perfecta, puede ser muy facil
3. **Agrega criterios**: Segun evoluciónen tus estándares
4. **Elimina redundancia**: Variables que miden lo mismo

<CardGroup cols={2}>
  <Card title="Concepto de NeuraScore" icon="chart-line" href="/concepts/neurascore">
    Entender el sistema de puntuación
  </Card>

  <Card title="Mas sobre Modelos" icon="book" href="/concepts/analysis-models">
    Documentación técnica de modelos
  </Card>
</CardGroup>