docs: clarify Pi reload and update workflows

2026-08-14 18:34:04 +02:00
parent 59a04123ea
commit a8623a2b18
4 changed files with 147 additions and 104 deletions
@@ -2,6 +2,12 @@

 Pi (il coding agent che orchestra il workflow NL→SQL) può risolvere un `provider/model` in tre modi diversi. Non sono alternativi: coesistono, e la scelta di quale usare dipende da **quanto è standard l'endpoint** e da **quanto deve essere ampia la visibilità** del modello (tutti i progetti vs. un progetto solo).

+> **ThothII operator note:** ThothII runs Pi only in Docker Compose. Paths under
+> `~/.pi/agent/` in this document describe Pi's container-side behavior. Operators edit
+> `deploy/pi/models.json` and `deploy/pi/settings.json` in the ThothII project root and use
+> the protected host credential file selected by `PI_AUTH_FILE`; they do not edit files inside
+> the running container.
+
 ## Credenziali nel backend container

 In produzione configurare una sola sorgente generica: il bundle `THT_SECRETS_FILE` con la voce