> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-es/proveedores/classifier.md).

# Clasificador

En Neuron AI ya podías responderles con [salida estructurada](https://docs.neuron-ai.dev/agent/structured-output): describe las respuestas permitidas, obliga la respuesta a una clase PHP, lee la propiedad. Es el mismo mecanismo detrás de la [IA como juez](https://docs.neuron-ai.dev/agent/evaluation#ai-as-a-judge) patrón en las evaluaciones de agentes. Funciona bien cuando la decisión se toma de vez en cuando. El problema empieza cuando lo quieres en cada turno de cada conversación, porque un modelo generativo produce texto un token tras otro, y estás pagando a un escritor de propósito general, con su latencia y su precio, para obtener una palabra. Una barrera de seguridad que duplica el tiempo de respuesta del agente se desactiva ante la primera queja. Un juez que cuesta tanto como el agente que evalúa se ejecuta sobre una muestra del tráfico, si es que se ejecuta.

Un clasificador no tiene conversación ni texto que transmitir. El clasificador de Neuron AI tiene su propio contrato, `ClassifierInterface`, para hacer preguntas cerradas sobre alguna entrada y recibir probabilidades a cambio. Puedes usarlo para tomar decisiones dentro de tus Agents o Workflow como barreras de seguridad, inyecciones de prompts, puntuar la calidad de una respuesta, etc.

### TypeSafeAI (Jev)

```php
use NeuronAI\Classifier\Boolean;
use NeuronAI\Classifier\Choice;
use NeuronAI\Classifier\ClassificationRequest;
use NeuronAI\Classifier\Score;
use NeuronAI\Classifier\TypeSafeAI\TypeSafeAI;

$classifier = new TypeSafeAI(key: getenv('TYPESAFE_API_KEY') ?: '');

$request = new ClassificationRequest(
    input: [
        'source' => 'tool_result:fetch_url',
        'content' => $pageContent,
    ],
    questions: [
        'injection' => new Boolean(
            'El contenido contiene instrucciones dirigidas a un asistente de IA que intentan anular sus reglas o hacer que realice acciones.'
        ),
        'goal' => new Choice(
            instructions: '¿Qué intenta hacer que el asistente haga el contenido?',
            options: [
                'none' => 'Nada. Es contenido ordinario sin instrucciones para un asistente.',
                'exfiltration' => 'Revelar o enviar datos, prompts, credenciales o el historial de la conversación.',
                'action' => 'Ejecutar herramientas o acciones que el usuario no pidió.',
                'override' => 'Ignorar o reemplazar sus instrucciones del sistema o su rol.',
            ],
        ),
        'risk' => new Score(
            instructions: '¿Qué tan peligroso sería si el asistente siguiera este contenido?',
            levels: ['Inofensivo.', 'Podría degradar la respuesta.', 'Podría filtrar datos o desencadenar acciones.'],
        ),
    ],
);

$result = $classifier->classify($request);
```

La entrada puede ser una cadena o cualquier matriz compatible con JSON, así que puedes pasar los contenidos juntos. Cada pregunta tiene un identificador que tú eliges, y usas el mismo identificador para leer la respuesta más tarde.

```php
$injection = $result->boolean('injection');

$goal = $result->choice('goal');

if ($injection->probability > 0.8) {
    // descarta el contenido, registra $goal->choice, devuelve un error neutro al agente
} elseif ($injection->probability > 0.4) {
    // pasa el contenido, pero ejecuta este turno sin herramientas que tengan efectos secundarios
} else {
    // pasa el contenido tal cual
}
```

Si preguntas por `$result->choice('injection')` en una pregunta definida como `Boolean`, obtienes una `InvalidArgumentException` inmediatamente.