Problemi comuni con le funzioni avanzate

Quando utilizzi le funzioni avanzate (function calling), potresti riscontrare problemi con alcuni modelli:

• Descrizione della funzione troppo lunga;

• Risposta della funzione troppo lunga.

Descrizione troppo lunga

Se la descrizione della tua funzione supera 1.024 caratteri, alcuni modelli (come quelli di OpenAI) potrebbero rispondere con un errore e rifiutarsi di rispondere alla richiesta dell'utente. In questo caso, l'Agente risponderà con "Mi dispiace, le mie risposte sono limitate. Devi farmi le domande giuste", indipendentemente dal fatto che la funzione sia stata effettivamente eseguita o meno.

Se hai una funzione con una descrizione molto lunga:

1. Sposta parte della descrizione nelle istruzioni;

2. Mantieni la descrizione della funzione entro 1.024 caratteri.

Questo ti consentirà, in caso di problemi del servizio, di passare rapidamente da un modello o provider all'altro senza configurazioni aggiuntive.

Anche se consigliamo di mantenere la descrizione entro 1.024 caratteri, su AIsuru puoi comunque scrivere descrizioni più lunghe, anche se il campo della descrizione mostra un limite di 1.024 caratteri.

Risposta della funzione troppo lunga

Se la tua funzione restituisce una risposta eccessivamente lunga, il modello linguistico potrebbe rifiutarsi di rispondere con "Mi dispiace, le mie risposte sono limitate. Devi farmi le domande giuste".

Questo accade perché ogni modello linguistico ha un limite massimo di contesto che può gestire. Il limite varia in base al modello ed è particolarmente comune quando utilizzi l'URL di una pagina web come webhook della funzione.

Se hai bisogno di collegare pagine web particolarmente lunghe, ti suggeriamo di:

1. Estrarre solo le sezioni di testo rilevanti dalla pagina;

2. Fornire queste informazioni all'Agente in un formato più conciso (come.txt,.md o.json minimizzato);

3. Valutare l'uso di un modello con una finestra di contesto più ampia.

In questo modo, l'Agente può elaborare le informazioni senza raggiungere i limiti del modello.

Nota sulla navigazione web:\ La funzione di ricerca web integrata ha un limite di 200.000 caratteri per le pagine HTML. Se utilizzi funzioni personalizzate per accedere a pagine web molto lunghe, valuta l'uso della funzione di navigazione web integrata o la pre-elaborazione dei contenuti per ridurne le dimensioni.

Nome della funzione troppo lungo

Se il nome della tua funzione supera i 64 caratteri, tutti i provider restituiranno un errore e la funzione non potrà essere salvata o utilizzata.

Per risolvere questo problema:

1. Usa nomi concisi ma descrittivi (ad es., book_appointment invece di book_specialist_medical_appointment_with_email_notification);

2. Evita ripetizioni nel nome.

3. Usa abbreviazioni comuni quando appropriato;

Il limite di 64 caratteri si applica a tutti i provider (OpenAI, Anthropic, Mistral, ecc.) ed è un vincolo tecnico.

Come verificare se le funzioni avanzate vengono chiamate?

Per verificare che le tue funzioni vengano effettivamente utilizzate:

1. Vai alla sezione Conversazioni del tuo Agente;

2. Apri una conversazione in cui pensi sia stata utilizzata una funzione;

3. Cerca l'icona di debug accanto ai messaggi;

4. Fai clic sull'icona del bug per vedere i dettagli della chiamata alla funzione.

Questo ti consente di verificare rapidamente se le tue funzioni vengono chiamate e quali risultati restituiscono.