> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/funzioni/funzioni-avanzate/problemi-comuni-con-le-funzioni-avanzate.md).

# Problemi comuni con le funzioni avanzate

Quando utilizzi [le funzioni avanzate (function calling)](/avanzate/integrazioni/funzioni/funzioni-avanzate.md), 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;](/ai-generativa/prompt-engineering.md)
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.

{% hint style="info" %} <mark style="color:blue;">Anche se consigliamo di mantenere la descrizione entro 1.024 caratteri, su AIsuru</mark> <mark style="color:blue;">**puoi comunque scrivere descrizioni più lunghe**</mark><mark style="color:blue;">, anche se il campo della descrizione mostra un limite di 1.024 caratteri.</mark>
{% endhint %}

### 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](https://github.com/memori-ai/docs/blob/main/en/generative-ai/advanced/providers-api-keys/providers.md#what-is-context). 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.

{% hint style="info" %} <mark style="color:blue;">**Nota sulla navigazione web**</mark><mark style="color:blue;">:</mark>\ <mark style="color:blue;">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.</mark>
{% endhint %}

#### 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;

{% hint style="warning" %} <mark style="color:$warning;">Il limite di 64 caratteri si applica a</mark> <mark style="color:$warning;">**tutti i provider**</mark> <mark style="color:$warning;">(OpenAI, Anthropic, Mistral, ecc.) ed è un vincolo tecnico.</mark>
{% endhint %}

### 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.