StructuredOutput ArrayOf Issue

[iosviluppo-net]

Hello everyone,
I am trying to set up a structured output where a value is an ArrayOf a class.

class ContrattoMutuoSchema {
    #[SchemaProperty(description: 'anagrafica completa dei soggetti del contratto di mutuo', required: true)]
    #[ArrayOf(Anagrafica::class)]
    public array $soggetti;
}

class Anagrafica {
    #[SchemaProperty(description: 'tipo di Soggetto, persona fisica, ditta individuale, società di persone, società di capitali.', required: true)]
    public string $subjectType;

    #[SchemaProperty(description: 'Nome di battesimo della persona fisica o ditta individuale', required: true)]
    public string $name;

    #[SchemaProperty(description: 'Cognome di battesimo della persona fisica o ditta individuale', required: true)]
    public string $surname;

    #[SchemaProperty(description: 'Ragione sociale o denominazione della società do persone o socità di capitali', required: true)]
    public string $ragioneSociale;

    #[SchemaProperty(description: 'codice fiscale', required: true)]
    public string $codiceFiscale;

    #[SchemaProperty(description: 'partita iva', required: true)]
    public string $partitaIva;

    #[SchemaProperty(description: 'ruolo nel contratto di mutuo, mutuante, mutuatario, garante, terzo datore d\'ipoteca', required: true)]
    public string $ruolo;
}

I followed the example in the documentation but I have this error:

PHP Fatal error: Uncaught Error: Attribute class "ArrayOf" not found in /neuron-ai/vendor/inspector-apm/neuron-ai/src/StructuredOutput/Validation/Validator.php:33

Is it a consequence of the recent changes made to the framework or am I doing something wrong?

[ilvalerione]

Hi @iosviluppo-net I forgot to mention in the attribute documentation that you need to provide the doc-block of the child class.

I updated the section accordingly: https://docs.neuron-ai.dev/advanced/structured-output#arrayof

[ilvalerione]

Did you import the class?

use NeuronAI\StructuredOutput\Validation\Rules\ArrayOf;

[iosviluppo-net]

my mistake i forgot to use NeuronAI\StructuredOutput\Validation\Rules\ArrayOf;

but OpenAI response is "The LLM wasn't able to generate a structured response for the class ContrattoMutuoSchema"
i seen another thread with this issue, i'm using gpt-4.1-mini

[ilvalerione]

Remember to add the doc-block

[iosviluppo-net]

done and works well now,
thank you.