chore(i18n): refresh it translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
d7eea54180
commit
ca594d6e56
@ -3,28 +3,28 @@ read_when:
|
||||
- Vuoi capire a cosa serve la memoria attiva
|
||||
- Vuoi attivare la memoria attiva per un agente conversazionale
|
||||
- Vuoi regolare il comportamento della memoria attiva senza abilitarla ovunque
|
||||
summary: Un sotto-agente di memoria bloccante di proprietà del plugin che inserisce la memoria pertinente nelle sessioni di chat interattive
|
||||
summary: Un sotto-agente di memoria bloccante gestito dal plugin che inserisce la memoria pertinente nelle sessioni di chat interattive
|
||||
title: Memoria attiva
|
||||
x-i18n:
|
||||
generated_at: "2026-04-10T08:13:33Z"
|
||||
generated_at: "2026-04-11T08:00:33Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 6a51437df4ae4d9d57764601dfcfcdadb269e2895bf49dc82b9f496c1b3cb341
|
||||
source_hash: e8b0e6539e09678e9e8def68795f8bcb992f98509423da3da3123eda88ec1dd5
|
||||
source_path: concepts/active-memory.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Memoria attiva
|
||||
|
||||
La memoria attiva è un sotto-agente di memoria bloccante opzionale di proprietà del plugin che viene eseguito
|
||||
La memoria attiva è un sotto-agente di memoria bloccante opzionale gestito dal plugin che viene eseguito
|
||||
prima della risposta principale per le sessioni conversazionali idonee.
|
||||
|
||||
Esiste perché la maggior parte dei sistemi di memoria è capace ma reattiva. Si affida
|
||||
all'agente principale per decidere quando cercare nella memoria, oppure all'utente per dire cose
|
||||
come "ricorda questo" o "cerca nella memoria". A quel punto, il momento in cui la memoria avrebbe
|
||||
reso la risposta naturale è già passato.
|
||||
Esiste perché la maggior parte dei sistemi di memoria è capace ma reattiva. Si basa
|
||||
sull'agente principale per decidere quando cercare nella memoria, oppure sull'utente che dica cose
|
||||
come "ricorda questo" o "cerca nella memoria". A quel punto, il momento in cui la memoria
|
||||
avrebbe reso la risposta naturale è già passato.
|
||||
|
||||
La memoria attiva offre al sistema una possibilità limitata di far emergere memoria pertinente
|
||||
La memoria attiva offre al sistema una possibilità limitata di far emergere la memoria pertinente
|
||||
prima che venga generata la risposta principale.
|
||||
|
||||
## Incolla questo nel tuo agente
|
||||
@ -57,22 +57,22 @@ configurazione autonoma e sicura per impostazione predefinita:
|
||||
```
|
||||
|
||||
Questo attiva il plugin per l'agente `main`, lo mantiene limitato per impostazione predefinita alle
|
||||
sessioni in stile messaggio diretto, gli consente di ereditare prima il modello della sessione corrente e
|
||||
sessioni in stile messaggio diretto, gli permette prima di ereditare il modello della sessione corrente e
|
||||
consente comunque il fallback remoto integrato se non è disponibile alcun modello esplicito o ereditato.
|
||||
|
||||
Dopo, riavvia il gateway:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
Per ispezionarlo in tempo reale in una conversazione:
|
||||
Per ispezionarlo dal vivo in una conversazione:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
```
|
||||
|
||||
## Attiva la memoria attiva
|
||||
## Attivare la memoria attiva
|
||||
|
||||
La configurazione più sicura è:
|
||||
|
||||
@ -108,25 +108,25 @@ Inizia con questo in `openclaw.json`:
|
||||
Poi riavvia il gateway:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
Cosa significa:
|
||||
Ecco cosa significa:
|
||||
|
||||
- `plugins.entries.active-memory.enabled: true` attiva il plugin
|
||||
- `config.agents: ["main"]` abilita la memoria attiva solo per l'agente `main`
|
||||
- `config.allowedChatTypes: ["direct"]` mantiene la memoria attiva abilitata solo per impostazione predefinita per le sessioni in stile messaggio diretto
|
||||
- `config.allowedChatTypes: ["direct"]` mantiene la memoria attiva solo per impostazione predefinita per le sessioni in stile messaggio diretto
|
||||
- se `config.model` non è impostato, la memoria attiva eredita prima il modello della sessione corrente
|
||||
- `config.modelFallbackPolicy: "default-remote"` mantiene come impostazione predefinita il fallback remoto integrato quando non è disponibile alcun modello esplicito o ereditato
|
||||
- `config.modelFallbackPolicy: "default-remote"` mantiene il fallback remoto integrato come impostazione predefinita quando non è disponibile alcun modello esplicito o ereditato
|
||||
- `config.promptStyle: "balanced"` usa lo stile di prompt predefinito per uso generale per la modalità `recent`
|
||||
- la memoria attiva viene comunque eseguita solo su sessioni di chat persistenti interattive idonee
|
||||
- la memoria attiva continua a essere eseguita solo sulle sessioni di chat interattive persistenti idonee
|
||||
|
||||
## Come vederla
|
||||
## Come visualizzarla
|
||||
|
||||
La memoria attiva inserisce contesto di sistema nascosto per il modello. Non espone
|
||||
tag raw `<active_memory_plugin>...</active_memory_plugin>` al client.
|
||||
tag grezzi `<active_memory_plugin>...</active_memory_plugin>` al client.
|
||||
|
||||
## Interruttore della sessione
|
||||
## Attivazione/disattivazione per sessione
|
||||
|
||||
Usa il comando del plugin quando vuoi mettere in pausa o riprendere la memoria attiva per la
|
||||
sessione di chat corrente senza modificare la configurazione:
|
||||
@ -137,8 +137,8 @@ sessione di chat corrente senza modificare la configurazione:
|
||||
/active-memory on
|
||||
```
|
||||
|
||||
Questo è limitato alla sessione. Non modifica
|
||||
`plugins.entries.active-memory.enabled`, il targeting dell'agente o altre
|
||||
Questo vale per la sessione corrente. Non modifica
|
||||
`plugins.entries.active-memory.enabled`, la selezione dell'agente o altre
|
||||
configurazioni globali.
|
||||
|
||||
Se vuoi che il comando scriva la configurazione e metta in pausa o riprenda la memoria attiva per
|
||||
@ -154,7 +154,7 @@ La forma globale scrive `plugins.entries.active-memory.config.enabled`. Lascia
|
||||
`plugins.entries.active-memory.enabled` attivo in modo che il comando resti disponibile per
|
||||
riattivare la memoria attiva in seguito.
|
||||
|
||||
Se vuoi vedere cosa sta facendo la memoria attiva in una sessione in tempo reale, attiva la modalità
|
||||
Se vuoi vedere cosa sta facendo la memoria attiva in una sessione dal vivo, attiva la modalità
|
||||
verbose per quella sessione:
|
||||
|
||||
```text
|
||||
@ -166,23 +166,23 @@ Con verbose abilitato, OpenClaw può mostrare:
|
||||
- una riga di stato della memoria attiva come `Active Memory: ok 842ms recent 34 chars`
|
||||
- un riepilogo di debug leggibile come `Active Memory Debug: Lemon pepper wings with blue cheese.`
|
||||
|
||||
Queste righe derivano dallo stesso passaggio della memoria attiva che alimenta il contesto di
|
||||
sistema nascosto, ma sono formattate per le persone invece di esporre markup raw del prompt.
|
||||
Queste righe derivano dallo stesso passaggio di memoria attiva che alimenta il contesto di
|
||||
sistema nascosto, ma sono formattate per gli esseri umani invece di esporre markup grezzo del prompt.
|
||||
|
||||
Per impostazione predefinita, la trascrizione del sotto-agente di memoria bloccante è temporanea e viene eliminata
|
||||
dopo il completamento dell'esecuzione.
|
||||
|
||||
Flusso di esempio:
|
||||
Esempio di flusso:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
quali ali dovrei ordinare?
|
||||
what wings should i order?
|
||||
```
|
||||
|
||||
Forma prevista della risposta visibile:
|
||||
Forma attesa della risposta visibile:
|
||||
|
||||
```text
|
||||
...normale risposta dell'assistente...
|
||||
...normal assistant reply...
|
||||
|
||||
🧩 Active Memory: ok 842ms recent 34 chars
|
||||
🔎 Active Memory Debug: Lemon pepper wings with blue cheese.
|
||||
@ -190,44 +190,43 @@ Forma prevista della risposta visibile:
|
||||
|
||||
## Quando viene eseguita
|
||||
|
||||
La memoria attiva usa due criteri:
|
||||
La memoria attiva usa due controlli:
|
||||
|
||||
1. **Adesione esplicita nella configurazione**
|
||||
1. **Consenso esplicito tramite configurazione**
|
||||
Il plugin deve essere abilitato e l'id dell'agente corrente deve comparire in
|
||||
`plugins.entries.active-memory.config.agents`.
|
||||
2. **Idoneità rigorosa in fase di esecuzione**
|
||||
Anche quando è abilitata e selezionata, la memoria attiva viene eseguita solo per
|
||||
sessioni di chat persistenti interattive idonee.
|
||||
Anche se abilitata e selezionata, la memoria attiva viene eseguita solo per le
|
||||
sessioni di chat interattive persistenti idonee.
|
||||
|
||||
La regola effettiva è:
|
||||
|
||||
```text
|
||||
plugin abilitato
|
||||
plugin enabled
|
||||
+
|
||||
id agente selezionato
|
||||
agent id targeted
|
||||
+
|
||||
tipo di chat consentito
|
||||
allowed chat type
|
||||
+
|
||||
sessione di chat persistente interattiva idonea
|
||||
eligible interactive persistent chat session
|
||||
=
|
||||
la memoria attiva viene eseguita
|
||||
active memory runs
|
||||
```
|
||||
|
||||
Se uno qualsiasi di questi fallisce, la memoria attiva non viene eseguita.
|
||||
Se uno qualsiasi di questi controlli fallisce, la memoria attiva non viene eseguita.
|
||||
|
||||
## Tipi di sessione
|
||||
|
||||
`config.allowedChatTypes` controlla quali tipi di conversazioni possono eseguire la Memoria
|
||||
attiva.
|
||||
`config.allowedChatTypes` controlla quali tipi di conversazioni possono eseguire la memoria attiva.
|
||||
|
||||
Il valore predefinito è:
|
||||
L'impostazione predefinita è:
|
||||
|
||||
```json5
|
||||
allowedChatTypes: ["direct"]
|
||||
```
|
||||
|
||||
Questo significa che la Memoria attiva viene eseguita per impostazione predefinita nelle sessioni in stile messaggio diretto, ma
|
||||
non nelle sessioni di gruppo o di canale a meno che tu non le abiliti esplicitamente.
|
||||
Questo significa che la memoria attiva viene eseguita per impostazione predefinita nelle sessioni in stile
|
||||
messaggio diretto, ma non nelle sessioni di gruppo o canale a meno che tu non le abiliti esplicitamente.
|
||||
|
||||
Esempi:
|
||||
|
||||
@ -246,16 +245,16 @@ allowedChatTypes: ["direct", "group", "channel"]
|
||||
## Dove viene eseguita
|
||||
|
||||
La memoria attiva è una funzionalità di arricchimento conversazionale, non una
|
||||
funzionalità di inferenza valida per tutta la piattaforma.
|
||||
funzionalità di inferenza estesa a tutta la piattaforma.
|
||||
|
||||
| Superficie | Esegue la memoria attiva? |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| Sessioni persistenti di chat in Control UI / web chat | Sì, se il plugin è abilitato e l'agente è selezionato |
|
||||
| Altre sessioni di canale interattive sullo stesso percorso di chat persistente | Sì, se il plugin è abilitato e l'agente è selezionato |
|
||||
| Esecuzioni headless one-shot | No |
|
||||
| Esecuzioni heartbeat/background | No |
|
||||
| Percorsi interni generici `agent-command` | No |
|
||||
| Esecuzione di sotto-agenti/helper interni | No |
|
||||
| Surface | La memoria attiva viene eseguita? |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------ |
|
||||
| Sessioni persistenti del Control UI / chat web | Sì, se il plugin è abilitato e l'agente è selezionato |
|
||||
| Altre sessioni di canale interattive sullo stesso percorso di chat persistente | Sì, se il plugin è abilitato e l'agente è selezionato |
|
||||
| Esecuzioni headless una tantum | No |
|
||||
| Esecuzioni heartbeat/background | No |
|
||||
| Percorsi interni generici `agent-command` | No |
|
||||
| Esecuzione di sotto-agenti/helper interni | No |
|
||||
|
||||
## Perché usarla
|
||||
|
||||
@ -275,20 +274,20 @@ Funziona particolarmente bene per:
|
||||
|
||||
- automazione
|
||||
- worker interni
|
||||
- attività API one-shot
|
||||
- attività API una tantum
|
||||
- contesti in cui una personalizzazione nascosta sarebbe sorprendente
|
||||
|
||||
## Come funziona
|
||||
|
||||
La forma di esecuzione è:
|
||||
La struttura in fase di esecuzione è:
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
U["Messaggio utente"] --> Q["Crea query di memoria"]
|
||||
Q --> R["Sotto-agente di memoria bloccante della memoria attiva"]
|
||||
R -->|NONE or empty| M["Risposta principale"]
|
||||
R -->|relevant summary| I["Aggiungi contesto di sistema nascosto active_memory_plugin"]
|
||||
I --> M["Risposta principale"]
|
||||
U["User Message"] --> Q["Build Memory Query"]
|
||||
Q --> R["Active Memory Blocking Memory Sub-Agent"]
|
||||
R -->|NONE or empty| M["Main Reply"]
|
||||
R -->|relevant summary| I["Append Hidden active_memory_plugin System Context"]
|
||||
I --> M["Main Reply"]
|
||||
```
|
||||
|
||||
Il sotto-agente di memoria bloccante può usare solo:
|
||||
@ -309,10 +308,10 @@ propenso o rigoroso quando decide se restituire memoria.
|
||||
|
||||
Stili disponibili:
|
||||
|
||||
- `balanced`: valore predefinito per uso generale per la modalità `recent`
|
||||
- `strict`: il meno propenso; ideale quando vuoi pochissima influenza dal contesto vicino
|
||||
- `balanced`: impostazione predefinita per uso generale per la modalità `recent`
|
||||
- `strict`: il meno propenso; ideale quando vuoi pochissima contaminazione dal contesto vicino
|
||||
- `contextual`: il più favorevole alla continuità; ideale quando la cronologia della conversazione dovrebbe contare di più
|
||||
- `recall-heavy`: più disposto a far emergere memoria anche con corrispondenze meno forti ma comunque plausibili
|
||||
- `recall-heavy`: più disposto a far emergere memoria su corrispondenze meno forti ma comunque plausibili
|
||||
- `precision-heavy`: preferisce in modo aggressivo `NONE` a meno che la corrispondenza non sia ovvia
|
||||
- `preference-only`: ottimizzato per preferiti, abitudini, routine, gusti e fatti personali ricorrenti
|
||||
|
||||
@ -324,7 +323,7 @@ recent -> balanced
|
||||
full -> contextual
|
||||
```
|
||||
|
||||
Se imposti `config.promptStyle` esplicitamente, quell'override prevale.
|
||||
Se imposti esplicitamente `config.promptStyle`, questa sostituzione ha la precedenza.
|
||||
|
||||
Esempio:
|
||||
|
||||
@ -334,18 +333,18 @@ promptStyle: "preference-only"
|
||||
|
||||
## Criterio di fallback del modello
|
||||
|
||||
Se `config.model` non è impostato, la Memoria attiva prova a risolvere un modello in questo ordine:
|
||||
Se `config.model` non è impostato, la memoria attiva prova a risolvere un modello in questo ordine:
|
||||
|
||||
```text
|
||||
modello esplicito del plugin
|
||||
-> modello della sessione corrente
|
||||
-> modello primario dell'agente
|
||||
-> fallback remoto integrato opzionale
|
||||
explicit plugin model
|
||||
-> current session model
|
||||
-> agent primary model
|
||||
-> optional built-in remote fallback
|
||||
```
|
||||
|
||||
`config.modelFallbackPolicy` controlla l'ultimo passaggio.
|
||||
|
||||
Valore predefinito:
|
||||
Impostazione predefinita:
|
||||
|
||||
```json5
|
||||
modelFallbackPolicy: "default-remote"
|
||||
@ -357,8 +356,8 @@ Altra opzione:
|
||||
modelFallbackPolicy: "resolved-only"
|
||||
```
|
||||
|
||||
Usa `resolved-only` se vuoi che la Memoria attiva salti il recupero invece di usare
|
||||
il valore predefinito remoto integrato quando non è disponibile alcun modello esplicito o
|
||||
Usa `resolved-only` se vuoi che la memoria attiva salti il richiamo invece di fare
|
||||
fallback al valore remoto integrato predefinito quando non è disponibile alcun modello esplicito o
|
||||
ereditato.
|
||||
|
||||
## Meccanismi di uscita avanzati
|
||||
@ -371,69 +370,69 @@ Queste opzioni intenzionalmente non fanno parte della configurazione consigliata
|
||||
thinking: "medium"
|
||||
```
|
||||
|
||||
Valore predefinito:
|
||||
Impostazione predefinita:
|
||||
|
||||
```json5
|
||||
thinking: "off"
|
||||
```
|
||||
|
||||
Non abilitarlo per impostazione predefinita. La Memoria attiva viene eseguita nel percorso della risposta, quindi tempo di
|
||||
Non abilitarlo per impostazione predefinita. La memoria attiva viene eseguita nel percorso della risposta, quindi il tempo di
|
||||
thinking aggiuntivo aumenta direttamente la latenza visibile all'utente.
|
||||
|
||||
`config.promptAppend` aggiunge istruzioni supplementari per l'operatore dopo il prompt predefinito della Memoria
|
||||
attiva e prima del contesto della conversazione:
|
||||
`config.promptAppend` aggiunge istruzioni extra dell'operatore dopo il prompt predefinito della memoria attiva
|
||||
e prima del contesto della conversazione:
|
||||
|
||||
```json5
|
||||
promptAppend: "Dai priorità alle preferenze stabili a lungo termine rispetto agli eventi una tantum."
|
||||
promptAppend: "Prefer stable long-term preferences over one-off events."
|
||||
```
|
||||
|
||||
`config.promptOverride` sostituisce il prompt predefinito della Memoria attiva. OpenClaw
|
||||
continua comunque ad aggiungere dopo il contesto della conversazione:
|
||||
`config.promptOverride` sostituisce il prompt predefinito della memoria attiva. OpenClaw
|
||||
continua comunque ad aggiungere il contesto della conversazione subito dopo:
|
||||
|
||||
```json5
|
||||
promptOverride: "Sei un agente di ricerca della memoria. Restituisci NONE o un fatto utente compatto."
|
||||
promptOverride: "You are a memory search agent. Return NONE or one compact user fact."
|
||||
```
|
||||
|
||||
La personalizzazione del prompt non è consigliata a meno che tu non stia testando deliberatamente un
|
||||
contratto di recupero diverso. Il prompt predefinito è regolato per restituire `NONE`
|
||||
oppure un contesto compatto di fatti utente per il modello principale.
|
||||
La personalizzazione del prompt non è consigliata a meno che tu non stia deliberatamente testando un
|
||||
contratto di richiamo diverso. Il prompt predefinito è ottimizzato per restituire `NONE`
|
||||
oppure un contesto compatto basato su fatti dell'utente per il modello principale.
|
||||
|
||||
### `message`
|
||||
|
||||
Viene inviato solo l'ultimo messaggio dell'utente.
|
||||
|
||||
```text
|
||||
Solo l'ultimo messaggio dell'utente
|
||||
Only the latest user message
|
||||
```
|
||||
|
||||
Usalo quando:
|
||||
Usa questa modalità quando:
|
||||
|
||||
- vuoi il comportamento più veloce
|
||||
- vuoi il bias più forte verso il recupero di preferenze stabili
|
||||
- i turni successivi non hanno bisogno del contesto conversazionale
|
||||
- vuoi il comportamento più rapido
|
||||
- vuoi il bias più forte verso il richiamo di preferenze stabili
|
||||
- i turni successivi non richiedono contesto conversazionale
|
||||
|
||||
Timeout consigliato:
|
||||
|
||||
- inizia intorno a `3000` a `5000` ms
|
||||
- inizia intorno a `3000` - `5000` ms
|
||||
|
||||
### `recent`
|
||||
|
||||
Vengono inviati l'ultimo messaggio dell'utente più una piccola coda conversazionale recente.
|
||||
|
||||
```text
|
||||
Coda recente della conversazione:
|
||||
Recent conversation tail:
|
||||
user: ...
|
||||
assistant: ...
|
||||
user: ...
|
||||
|
||||
Ultimo messaggio dell'utente:
|
||||
Latest user message:
|
||||
...
|
||||
```
|
||||
|
||||
Usalo quando:
|
||||
Usa questa modalità quando:
|
||||
|
||||
- vuoi un miglior equilibrio tra velocità e ancoraggio conversazionale
|
||||
- le domande di follow-up spesso dipendono dagli ultimi pochi turni
|
||||
- le domande di follow-up dipendono spesso dagli ultimi turni
|
||||
|
||||
Timeout consigliato:
|
||||
|
||||
@ -444,21 +443,21 @@ Timeout consigliato:
|
||||
L'intera conversazione viene inviata al sotto-agente di memoria bloccante.
|
||||
|
||||
```text
|
||||
Contesto completo della conversazione:
|
||||
Full conversation context:
|
||||
user: ...
|
||||
assistant: ...
|
||||
user: ...
|
||||
...
|
||||
```
|
||||
|
||||
Usalo quando:
|
||||
Usa questa modalità quando:
|
||||
|
||||
- la massima qualità del recupero conta più della latenza
|
||||
- la migliore qualità di richiamo conta più della latenza
|
||||
- la conversazione contiene impostazioni importanti molto indietro nel thread
|
||||
|
||||
Timeout consigliato:
|
||||
|
||||
- aumentalo in modo significativo rispetto a `message` o `recent`
|
||||
- aumentalo in modo sostanziale rispetto a `message` o `recent`
|
||||
- inizia intorno a `15000` ms o più, a seconda della dimensione del thread
|
||||
|
||||
In generale, il timeout dovrebbe aumentare con la dimensione del contesto:
|
||||
@ -467,17 +466,18 @@ In generale, il timeout dovrebbe aumentare con la dimensione del contesto:
|
||||
message < recent < full
|
||||
```
|
||||
|
||||
## Persistenza della trascrizione
|
||||
## Persistenza delle trascrizioni
|
||||
|
||||
Le esecuzioni del sotto-agente di memoria bloccante della memoria attiva creano una vera trascrizione `session.jsonl` durante la chiamata del sotto-agente di memoria bloccante.
|
||||
Le esecuzioni del sotto-agente di memoria bloccante della memoria attiva creano una vera trascrizione `session.jsonl`
|
||||
durante la chiamata al sotto-agente di memoria bloccante.
|
||||
|
||||
Per impostazione predefinita, quella trascrizione è temporanea:
|
||||
|
||||
- viene scritta in una directory temporanea
|
||||
- viene usata solo per l'esecuzione del sotto-agente di memoria bloccante
|
||||
- viene eliminata immediatamente dopo la fine dell'esecuzione
|
||||
- viene eliminata immediatamente al termine dell'esecuzione
|
||||
|
||||
Se vuoi conservare su disco quelle trascrizioni del sotto-agente di memoria bloccante per debug o
|
||||
Se vuoi mantenere su disco quelle trascrizioni del sotto-agente di memoria bloccante per debug o
|
||||
ispezione, attiva esplicitamente la persistenza:
|
||||
|
||||
```json5
|
||||
@ -498,22 +498,22 @@ ispezione, attiva esplicitamente la persistenza:
|
||||
```
|
||||
|
||||
Quando è abilitata, la memoria attiva archivia le trascrizioni in una directory separata sotto la
|
||||
cartella delle sessioni dell'agente di destinazione, non nel percorso principale della trascrizione
|
||||
della conversazione utente.
|
||||
cartella delle sessioni dell'agente di destinazione, non nel percorso della trascrizione principale
|
||||
della conversazione dell'utente.
|
||||
|
||||
Il layout predefinito è, concettualmente:
|
||||
La struttura predefinita è concettualmente:
|
||||
|
||||
```text
|
||||
agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jsonl
|
||||
```
|
||||
|
||||
Puoi modificare la sottodirectory relativa con `config.transcriptDir`.
|
||||
Puoi cambiare la sottodirectory relativa con `config.transcriptDir`.
|
||||
|
||||
Usalo con attenzione:
|
||||
Usa questa opzione con cautela:
|
||||
|
||||
- le trascrizioni del sotto-agente di memoria bloccante possono accumularsi rapidamente nelle sessioni molto attive
|
||||
- la modalità di query `full` può duplicare molto contesto conversazionale
|
||||
- queste trascrizioni contengono contesto nascosto del prompt e memorie recuperate
|
||||
- queste trascrizioni contengono contesto di prompt nascosto e memorie richiamate
|
||||
|
||||
## Configurazione
|
||||
|
||||
@ -525,32 +525,32 @@ plugins.entries.active-memory
|
||||
|
||||
I campi più importanti sono:
|
||||
|
||||
| Chiave | Tipo | Significato |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
|
||||
| `enabled` | `boolean` | Abilita il plugin stesso |
|
||||
| `config.agents` | `string[]` | ID agente che possono usare la memoria attiva |
|
||||
| `config.model` | `string` | Riferimento facoltativo al modello del sotto-agente di memoria bloccante; se non è impostato, la memoria attiva usa il modello della sessione corrente |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | Controlla quanta parte della conversazione vede il sotto-agente di memoria bloccante |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controlla quanto il sotto-agente di memoria bloccante sia propenso o rigoroso nel decidere se restituire memoria |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Override avanzato del thinking per il sotto-agente di memoria bloccante; valore predefinito `off` per velocità |
|
||||
| `config.promptOverride` | `string` | Sostituzione avanzata completa del prompt; non consigliata per l'uso normale |
|
||||
| `config.promptAppend` | `string` | Istruzioni supplementari avanzate aggiunte al prompt predefinito o sostituito |
|
||||
| `config.timeoutMs` | `number` | Timeout rigido per il sotto-agente di memoria bloccante |
|
||||
| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo di active-memory |
|
||||
| `config.logging` | `boolean` | Emette log della memoria attiva durante la regolazione |
|
||||
| Chiave | Tipo | Significato |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
|
||||
| `enabled` | `boolean` | Abilita il plugin stesso |
|
||||
| `config.agents` | `string[]` | ID agente che possono usare la memoria attiva |
|
||||
| `config.model` | `string` | Riferimento facoltativo al modello del sotto-agente di memoria bloccante; se non impostato, la memoria attiva usa il modello della sessione corrente |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | Controlla quanta parte della conversazione vede il sotto-agente di memoria bloccante |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controlla quanto il sotto-agente di memoria bloccante sia propenso o rigoroso quando decide se restituire memoria |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Sostituzione avanzata del livello di thinking per il sotto-agente di memoria bloccante; impostazione predefinita `off` per maggiore velocità |
|
||||
| `config.promptOverride` | `string` | Sostituzione avanzata completa del prompt; non consigliata per l'uso normale |
|
||||
| `config.promptAppend` | `string` | Istruzioni avanzate aggiuntive accodate al prompt predefinito o sostituito |
|
||||
| `config.timeoutMs` | `number` | Timeout rigido per il sotto-agente di memoria bloccante |
|
||||
| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo della memoria attiva |
|
||||
| `config.logging` | `boolean` | Emette log della memoria attiva durante la regolazione |
|
||||
| `config.persistTranscripts` | `boolean` | Mantiene su disco le trascrizioni del sotto-agente di memoria bloccante invece di eliminare i file temporanei |
|
||||
| `config.transcriptDir` | `string` | Directory relativa delle trascrizioni del sotto-agente di memoria bloccante sotto la cartella delle sessioni dell'agente |
|
||||
|
||||
Campi utili per la regolazione:
|
||||
|
||||
| Chiave | Tipo | Significato |
|
||||
| ----------------------------- | -------- | ----------------------------------------------------------------- |
|
||||
| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo di active-memory |
|
||||
| `config.recentUserTurns` | `number` | Turni utente precedenti da includere quando `queryMode` è `recent` |
|
||||
| Chiave | Tipo | Significato |
|
||||
| ----------------------------- | -------- | --------------------------------------------------------------- |
|
||||
| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo della memoria attiva |
|
||||
| `config.recentUserTurns` | `number` | Turni utente precedenti da includere quando `queryMode` è `recent` |
|
||||
| `config.recentAssistantTurns` | `number` | Turni assistente precedenti da includere quando `queryMode` è `recent` |
|
||||
| `config.recentUserChars` | `number` | Numero massimo di caratteri per turno utente recente |
|
||||
| `config.recentAssistantChars` | `number` | Numero massimo di caratteri per turno assistente recente |
|
||||
| `config.cacheTtlMs` | `number` | Riutilizzo della cache per query identiche ripetute |
|
||||
| `config.recentUserChars` | `number` | Numero massimo di caratteri per ogni turno utente recente |
|
||||
| `config.recentAssistantChars` | `number` | Numero massimo di caratteri per ogni turno assistente recente |
|
||||
| `config.cacheTtlMs` | `number` | Riutilizzo della cache per query identiche ripetute |
|
||||
|
||||
## Configurazione consigliata
|
||||
|
||||
@ -576,8 +576,8 @@ Inizia con `recent`.
|
||||
}
|
||||
```
|
||||
|
||||
Se vuoi ispezionare il comportamento in tempo reale durante la regolazione, usa `/verbose on` nella
|
||||
sessione invece di cercare un comando di debug separato per active-memory.
|
||||
Se vuoi ispezionare il comportamento dal vivo durante la regolazione, usa `/verbose on` nella
|
||||
sessione invece di cercare un comando di debug separato per la memoria attiva.
|
||||
|
||||
Poi passa a:
|
||||
|
||||
@ -586,15 +586,15 @@ Poi passa a:
|
||||
|
||||
## Debug
|
||||
|
||||
Se la memoria attiva non compare dove ti aspetti:
|
||||
Se la memoria attiva non compare dove te l'aspetti:
|
||||
|
||||
1. Conferma che il plugin sia abilitato in `plugins.entries.active-memory.enabled`.
|
||||
2. Conferma che l'ID dell'agente corrente sia elencato in `config.agents`.
|
||||
3. Conferma che il test avvenga tramite una sessione di chat persistente interattiva.
|
||||
3. Conferma di stare testando tramite una sessione di chat interattiva persistente.
|
||||
4. Attiva `config.logging: true` e osserva i log del gateway.
|
||||
5. Verifica che la ricerca in memoria funzioni con `openclaw memory status --deep`.
|
||||
5. Verifica che la ricerca nella memoria stessa funzioni con `openclaw memory status --deep`.
|
||||
|
||||
Se i risultati di memoria sono troppo rumorosi, restringi:
|
||||
Se i risultati della memoria sono rumorosi, restringi:
|
||||
|
||||
- `maxSummaryChars`
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user