# 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 eccessivamente lunga;
* Risposta della funzione eccessivamente lunga.

Vediamo queste due problematiche nel dettaglio 👇

### Descrizione troppo lunga

Se la descrizione della tua funzione supera i 1024 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à "Mi dispiace, le mie risposte sono limitate. Devi farmi le domande giuste", a prescindere che la funzione sia 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 1024 caratteri.

-> Questo ti permetterà, in caso di disservizi, di poter cambiare rapidamente modello e provider senza ulteriori configurazioni.

{% hint style="info" %}
Anche se ti suggeriamo ti mantenere la descrizione entro i 1024 caratteri, su AIsuru **potrai comunque scrivere descrizioni più lunghe**, anche se visualizzi un limite di 1024 caratteri per il campo della descrizione.
{% endhint %}

### Risposta della funzione eccessivamente lunga

Se la tua funzione risponde con un testo eccessivamente lungo, il modello linguistico potrebbe rifiutarsi di rispondere dicendo "Mi dispiace, le mie risposte sono limitate. Devi farmi le domande giuste".

Questo problema si verifica perché ogni modello linguistico ha un [limite massimo di contesto che può gestire](/ai-generativa/provider.md#cosa-e-il-contesto). Il limite varia in base al modello scelto ed è particolarmente comune quando usi un 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. Considerare l'**uso di un modello con una finestra di contesto più ampia**.

In questo modo, l'Agente potrà elaborare le informazioni senza superare i limiti del modello.

{% hint style="info" %}
**Nota per la navigazione web**:\
La funzione di ricerca web integrata ha un limite di 200.000 caratteri per le pagine HTML. Se stai usando funzioni personalizzate per accedere a pagine web molto lunghe, considera di utilizzare la funzione integrata di navigazione web o di pre-elaborare i contenuti per ridurne la dimensione.
{% 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 (es. `prenota_appuntamento` invece di `prenota_appuntamento_medico_specialistico_con_notifica_email`)
2. Evita ripetizioni nel nome
3. Utilizza abbreviazioni comuni quando appropriato

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

### Come verificare se le funzioni avanzate vengono chiamate?

Per controllare se le tue funzioni vengono 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. Clicca sull'icona dello scarafaggio ![](/files/KTqxYB1bcSfQURizH8vQ) per vedere i dettagli della chiamata alla funzione

Questo ti permetterà di verificare rapidamente se le tue funzioni vengono chiamate e che risultati stanno restituendo.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/avanzate/integrazioni/funzioni/funzioni-avanzate/problemi-comuni-con-le-funzioni-avanzate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.