# Regole da seguire per una buona Base di conoscenza

{% stepper %}
{% step %}

### Evitare una knowledge base “sporca”

Una base di conoscenza non deve contenere informazioni di ogni genere in modo disordinato.

L’obiettivo è fornire all’IA solo i dati realmente utili e specifici, evitando ridondanze.

{% hint style="warning" %}
⚠️ Nota bene: l’IA di Bookli ha già una **base di conoscenza nativa molto ampia**, allenata su miliardi di parametri. Non serve reinserire informazioni di pubblico dominio.
{% endhint %}
{% endstep %}

{% step %}

### Contenuti da includere

Inserisci solo informazioni che l’IA non può conoscere da sola, come ad esempio:

* Nomi dei dipendenti o collaboratori
* Indirizzo e recapiti aziendali
* Email specifiche per il supporto
* Dati interni o riservati
* Caratteristiche uniche dei tuoi prodotti o servizi

{% hint style="info" %}
Esempio: “La nostra sede si trova in Via Roma 10, Milano. L’email di supporto clienti è <support@azienda.com>.”
{% endhint %}
{% endstep %}

{% step %}

### Contenuti da escludere

Non è necessario aggiungere dati che sono già **di dominio pubblico** o facilmente accessibili, come:

* Definizioni generiche
* Informazioni storiche
* Concetti tecnici di uso comune

Questi possono essere semplicemente richiamati nelle **istruzioni della task**, senza appesantire la knowledge base.
{% endstep %}

{% step %}

### Coerenza tematica

Ogni knowledge base deve avere un **tema preciso e circoscritto**:

* Se crei una knowledge base sulle **informazioni aziendali**, inserisci solo dati aziendali
* Se crei una knowledge base sui **prodotti**, inserisci solo descrizioni, caratteristiche e schede tecniche dei prodotti

{% hint style="danger" %}
⚠️ Non mescolare contenuti eterogenei: questo riduce la precisione delle risposte.
{% endhint %}
{% endstep %}

{% step %}

### Funzione mirata

Quando costruisci una knowledge base, pensa sempre alla sua funzione pratica:

* Quali domande deve aiutare a risolvere?
* Quali informazioni specifiche deve fornire?
* In quali scenari sarà invocata?

{% hint style="info" %}
Esempio: “Questa knowledge base sarà usata solo se l’utente chiede informazioni sui prodotti artigianali realizzati internamente.”
{% endhint %}
{% endstep %}
{% endstepper %}


---

# 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.bookli.ai/conoscenza/regole-da-seguire-per-una-buona-base-di-conoscenza.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.