ZaruDate a ogni esecuzione di Zaru solo le connessioni utili
Anche in: English, Español, Português, 日本語, Deutsch, Français, 한국어, 简体中文, हिन्दी · Tutte le guide in italiano
Trasparenza: Zaru è sviluppato da 100monkeys AI, Inc., quindi leggete questa guida come il resoconto di chi lo costruisce. L'ha scritta in bozza uno dei nostri agenti di IA a partire dalla pagina Profiles della documentazione di Zaru, letta il 29 ottobre 2026, e dai testi di questo sito, e l'azienda l'ha rivista; questa edizione italiana è una traduzione della guida originale in inglese. Ogni regola e ogni messaggio citati qui sotto sono di quella pagina, in inglese con la traduzione accanto. Dove non dice come funziona qualcosa, lo diciamo invece di descriverlo.
Una volta che Zaru ha la vostra casella di posta, il vostro calendario e un token GitHub, la domanda è quali di questi possa toccare una certa conversazione, esecuzione o pianificazione. Un profilo risponde con una sola scelta: un insieme con nome delle vostre connessioni e degli strumenti che possono usare. Un'esecuzione senza profilo e senza connessioni scelte non ne raggiunge nessuna. Questa guida crea un profilo, ne restringe gli strumenti e lo usa in una chat, in una pianificazione e in un client MCP.
Che cos'è un profilo
La documentazione: un profilo è "your own named set of connections (a mailbox, a calendar account, a Carbon Forge (formerly Nuclear Notes) token, a GitHub token and so on, any number of any kind) with a list of the tools they may use, and optional defaults." (il vostro insieme con nome di connessioni, cioè una casella di posta, un account di calendario, un token Carbon Forge, già Nuclear Notes, un token GitHub e così via, in qualsiasi numero e tipo, con l'elenco degli strumenti che possono usare e valori predefiniti facoltativi). La regola che lo rende utile è stampata sopra l'elenco nella pagina Profiles stessa: "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none." (un'esecuzione, una pianificazione o una chiave API raggiunge solo le connessioni indicate da un profilo; senza profilo non ne raggiunge nessuna).
Passo 1. Create un account e collegate ciò che usate
Premete Get Zaru free (Prova Zaru gratis); per registrarsi bastano un nome e un indirizzo email. Collegate email e calendario dal Vault, come descrive il sito. Un profilo può elencare solo connessioni che avete già, quindi collegate prima.
Passo 2. Aprite Vault, Profiles
L'elenco si trova in /vault/profiles e mostra ogni profilo con le sue connessioni e il numero di strumenti. Premete New profile (nuovo profilo). Lo stesso modulo serve poi a modificare un profilo.
Passo 3. Dategli il nome di un lavoro e sceglietene le connessioni
Un nome va da 1 a 64 caratteri ed è unico tra i vostri profili. Chiamatelo come il lavoro, non come l'account: l'esempio della documentazione si chiama "Fundraising". Poi spuntate le connessioni che servono al lavoro; il modulo le raggruppa per tipo. Una connessione che revocate o eliminate in seguito resta elencata come removed, e il profilo dice "A connection in this profile was removed." (una connessione di questo profilo è stata rimossa).
Passo 4. Restringete gli strumenti
Ogni voce è il nome esatto di uno strumento, come mail.reply, o una famiglia scritta <family>.*, come carbon-forge.*. Un elenco vuoto significa "All tools these connections allow" (tutti gli strumenti consentiti da queste connessioni). Il profilo di esempio della documentazione consente:
"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]Il modulo segna uno strumento che attende la vostra approvazione con "Needs your approval" (richiede la vostra approvazione). Un profilo può solo restringere: una voce che il vostro piano non consente viene rifiutata con "A profile can only narrow the tools your plan allows; <pattern> is not one of them." (un profilo può solo restringere gli strumenti consentiti dal vostro piano; <pattern> non è tra questi).
Passo 5. Sappiate cosa il profilo non cambia
Un profilo governa gli strumenti delle famiglie delle sue connessioni: mail.*, calendar.* e la famiglia del provider per tutto il resto, come github.*. Strumenti come fs.*, cmd.run o web.* non sono governati da un profilo; li decide solo il contesto di sicurezza. E uno strumento consentito incontra comunque il varco di approvazione. mail.send, mail.reply, mail.forward, mail.delete e mail.archive attendono la vostra risposta qualunque cosa dica il profilo. Così un profilo con mail.reply e senza mail.send lascia che un'esecuzione risponda in un thread, con ogni risposta in attesa di voi, e rifiuta subito un messaggio nuovo.
Passo 6. Aggiungete i valori predefiniti
Tre campi facoltativi risparmiano battute: un repository predefinito, uno dei vostri collegamenti a repository git; un workspace Carbon Forge predefinito, usato "when a Carbon Forge call names none" (quando una chiamata Carbon Forge non ne indica uno); e instructions per le conversazioni su questo profilo, al massimo 4.000 caratteri. A Zaru vengono comunicati il nome del profilo, il suo workspace e le vostre istruzioni.
Passo 7. Sceglietelo in una conversazione
Aprite il pannello della conversazione sopra il campo di input della chat. La sua sezione Context elenca None, poi Profiles, poi le vostre connessioni per tipo. Scegliere un profilo azzera le connessioni scelte, e la riga sopra l'input dice "Profile: <name>". Il profilo viene salvato con la conversazione, quindi i turni successivi e le esecuzioni che avviano lo usano. Un'esecuzione porta un profilo o connessioni scelte, mai entrambi: "Choose one profile, or choose connections without a profile; not both." (scegliete un profilo, oppure connessioni senza profilo; non entrambi).
Passo 8. Usatelo per una pianificazione e una chiave API
Il modulo delle pianificazioni salva un profilo o connessioni scelte, mai entrambi, e repository e workspace del profilo compilano il modulo. In Settings → API Keys, la riga di ogni chiave ne sceglie il profilo, con None per primo. Una chiave senza profilo non raggiunge nessuna delle vostre connessioni.
Passo 9. Sceglietelo da un client MCP
Un client invia il profilo a ogni richiesta della sua connessione, in un solo header che contiene soltanto la chiave riservata @profile:
x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}Quell'id è l'esempio della documentazione; usate l'id del vostro profilo. @profile accanto a qualsiasi altra chiave riceve 400.
Passo 10. Leggete un rifiuto
Ogni chiamata governata viene controllata sul profilo così com'è in quel momento. Uno strumento fuori dal profilo viene rifiutato con TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this run." (questo strumento non è nel profilo scelto per questa esecuzione). Zaru Web mostra una scheda con il link al profilo, così potete aggiungere lo strumento o lasciarlo fuori. Un'esecuzione avviata da un'altra esecuzione non va mai oltre le connessioni scelte da quella. Una scelta "Always allow" (consenti sempre) fatta su un'esecuzione di un profilo vale solo per quel profilo, ed eliminare il profilo la revoca.
Cosa non dice la documentazione
- Dove trovare l'id di un profilo per l'header MCP. La risposta REST lo contiene; la pagina non dice se Zaru Web lo mostra.
- Come si sceglie un profilo nelle impostazioni di un client MCP. È data la forma dell'header, non la configurazione di un client.
- Se modificare un profilo cambia un'esecuzione già in corso. Le chiamate sono controllate "as it stands at that moment" (così com'è in quel momento), ma le connessioni diventano dell'esecuzione al suo avvio.
- Questo sito non parla dei profili; la documentazione è l'unica fonte.
Guide correlate
- Configurare un assistente Zaru che gestisce e-mail e calendario con le approvazioni, che collega la casella e il calendario che un profilo poi restringe.
- FAQ di Zaru
Create un profilo per ogni lavoro, e partite dal minor numero di strumenti.