> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/ai/architettura-e-funzionalita-del-chatbot/chatbot-per-la-pa/casi-duso.md).

# Casi d'uso

Il chatbot supporta i cittadini in diversi casi d'uso: fornisce informazioni sui servizi, indirizza verso le fonti corrette e risponde alle domande in modo pertinente.

<details>

<summary>Richiedere informazioni sui servizi tramite chatbot</summary>

Il chatbot risponde alle richieste di informazioni sui servizi, ad esempio quando un cittadino chiede di conoscere le scadenze di pagamento dell'IMU (Imposta Municipale Unica).

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FL80MW87RmodrU3QRVM6P%2Fchatbot-risposta-scadenze-imu.png?alt=media&amp;token=c840781f-d01f-4931-8068-af3846be69d2" alt=""><figcaption></figcaption></figure>

OpenCity AI Chatbot non si limita a una risposta testuale generica, ma interpreta la richiesta dell'utente per fornire un supporto a tre livelli:

{% stepper %}
{% step %}

## Estrazione delle scadenze principali

Il sistema estrae e presenta chiaramente le due scadenze principali ("Acconto" e "Saldo"), rispondendo in modo diretto al dubbio dell'utente.
{% endstep %}

{% step %}

## Accesso alle informazioni di dettaglio

Viene fornito il link alla pagina informativa dedicata sul sito dell'ente, dove il cittadino può consultare aliquote, detrazioni e regolamenti aggiornati.
{% endstep %}

{% step %}

## Accesso al servizio

Il chatbot facilita il passaggio alla fase operativa, guidando l'utente verso la Stanza del Cittadino per l'attivazione del servizio, per esempio l'accesso al calcolatore IMU o la presentazione di una dichiarazione.
{% endstep %}
{% endstepper %}

Una volta ottenute le risposte, l'interazione continua. L'utente può approfondire l'argomento trattato oppure iniziare una conversazione su temi diversi.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2F4c6ogf63thq8nfb1oVaz%2Fchatbot-continua-conversazione-1.png?alt=media&amp;token=bef8935e-6fba-4a84-bdd2-ab762e188193" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FfDikq9TEvvhodYwyGywU%2Fchatbot-continua-conversazione-2.png?alt=media&amp;token=5279c61e-b264-491c-972f-2b687a774ef5" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Consultazione del calendario eventi e manifestazioni</summary>

Il chatbot fornisce informazioni sugli eventi organizzati sul territorio, ad esempio quando un cittadino chiede quali sono le manifestazioni in programma per la settimana corrente.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FQnChRZM0SbzW4KK2dJwf%2Fchatbot-calendario-eventi-settimana.png?alt=media&amp;token=87405640-4136-4d79-84b7-de9da35efce7" alt=""><figcaption></figcaption></figure>

OpenCity AI Chatbot agisce come un facilitatore tra il cittadino e l'agenda culturale dell'ente:

{% stepper %}
{% step %}

## Interpretazione della richiesta temporale

Il sistema interpreta la richiesta temporale dell'utente ("settimana corrente") e comunica in modo chiaro che sono previsti due eventi: il primo per martedì 20 gennaio, dalle ore 18:00, e il secondo a partire da domenica 25 gennaio.
{% endstep %}

{% step %}

## Collegamenti agli eventi

Per ogni evento individuato, il chatbot fornisce un link diretto al contenuto dedicato presente sul sito web istituzionale.
{% endstep %}

{% step %}

## Consultazione immediata dei dettagli

Grazie a questo approccio, il cittadino non deve navigare l'intero calendario eventi del portale, ma viene indirizzato immediatamente alla scheda specifica per consultare dettagli, locandine o eventuali modalità di prenotazione.
{% endstep %}
{% endstepper %}

</details>

<details>

<summary>Accompagnare l'utente nell'invio di una segnalazione o una richiesta di appuntamento</summary>

Il chatbot guida il cittadino che desidera segnalare un'anomalia sul territorio, come la presenza di buche stradali, verso la procedura ufficiale per trasmettere l'informazione all'ente.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FacsFJS1EeacfEhavohvW%2Fchatbot-segnalazione-disservizio.png?alt=media&amp;token=0b0dd893-c0ee-4a73-8da1-148e565176d5" alt=""><figcaption></figcaption></figure>

Il chatbot fornisce tutte le opzioni disponibili per procedere, guidando il cittadino verso la soluzione più adatta: contatto diretto (telefono o email), assistenza in presenza presso l'URP, oppure, come percorso consigliato, il servizio digitale, con link diretto a "Segnala disservizio".

La stessa logica di orientamento viene applicata anche per la prenotazione di appuntamenti presso gli uffici comunali.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FWTi3MqJlu87mZvsjsMkC%2Fchatbot-prenotazione-appuntamento.png?alt=media&amp;token=d20fd14d-d93f-495e-892c-0e9c77344189" alt=""><figcaption></figcaption></figure>

OpenCity AI Chatbot risponde con una strategia di orientamento completa:

{% stepper %}
{% step %}

## Abilitazione al servizio online

Il chatbot segnala immediatamente la possibilità di utilizzare il servizio digitale, fornendo il link diretto alla piattaforma di prenotazione dell'ente.
{% endstep %}

{% step %}

## Guida alla procedura

Il sistema elenca i passaggi principali necessari per completare l'invio della richiesta:

* selezione dell'ufficio;
* scelta del giorno e dell'orario tra quelli disponibili;
* indicazione del motivo dell'appuntamento, per esempio rilascio CIE (Carta d'Identità Elettronica), certificati, pratiche migratorie;
* inserimento dati anagrafici del richiedente.
  {% endstep %}
  {% endstepper %}

</details>

<details>

<summary>Gestione dei refusi e degli errori di digitazione</summary>

In questo scenario, la domanda posta dall'utente contiene un evidente errore di digitazione, il termine "oline" invece di "online".

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2Fe9PylfiAksfYjMAqG0Bq%2Fimage.png?alt=media&amp;token=fa30f2f3-aa30-4bd9-9b6d-1aaae60235a4" alt=""><figcaption></figcaption></figure>

OpenCity AI Chatbot interpreta correttamente l'obiettivo dell'utente e fornisce immediatamente la procedura per il cambio di residenza.

Questo esempio dimostra la robustezza semantica del modello che, anziché bloccarsi di fronte a refusi ortografici, è in grado di elaborare il contesto della richiesta e restituire informazioni accurate.

Nello specifico, l'elaborazione del sistema permette di:

{% stepper %}
{% step %}

## Superare l'errore materiale

Il termine "oline" viene ricondotto correttamente al concetto di "servizio telematico".
{% endstep %}

{% step %}

## Identificare l'istanza

Il sistema comprende che l'utente non vuole solo informazioni, ma intende avviare una pratica amministrativa specifica.
{% endstep %}

{% step %}

## Abilitare il servizio

Il chatbot risponde fornendo i requisiti necessari e il link diretto alla sezione della Stanza del Cittadino dedicata ai cambi di residenza.
{% endstep %}
{% endstepper %}

</details>

<details>

<summary>Gestione di domande non pertinenti</summary>

Il chatbot non fornisce risposte a domande che non riguardano le attività della Pubblica Amministrazione, come "Qual è la capitale del Brasile?", restando così focalizzato sulle finalità istituzionali dell'ente.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2Fh1W0uA4frdfLGzvY3PET%2Fimage.png?alt=media&amp;token=199bea17-44c7-4910-aad8-3eed92595d5b" alt=""><figcaption></figcaption></figure>

Il chatbot riconosce che la richiesta non riguarda l'ambito dei servizi pubblici e dei contenuti istituzionali.

</details>

<details>

<summary>Gestione delle informazioni non presenti sul sito web</summary>

Quando un cittadino chiede informazioni su un argomento non presente nelle pagine del sito istituzionale o nella base di conoscenza caricata, il chatbot gestisce l'assenza di dati senza interrompere il supporto all'utente.

<figure><img src="https://1485820589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR5qTx8bksn2njb5reyN5%2Fuploads%2FCPLVRnt4f3Jxu5fh2jEm%2Fimage.png?alt=media&amp;token=5039e8b5-5984-4fce-a3f3-21a23e7fedf3" alt=""><figcaption></figcaption></figure>

Invece di provare a indovinare o fornire dati incerti, OpenCity AI Chatbot riconosce di non avere le informazioni necessarie e indirizza l'utente verso i servizi di assistenza o gli uffici competenti, come l'URP.

Il chatbot non "inventa" mai le risposte, ma garantisce comunque un supporto utile guidando il cittadino verso un operatore umano.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.opencityitalia.it/ai/architettura-e-funzionalita-del-chatbot/chatbot-per-la-pa/casi-duso.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.