Ne donner à chaque exécution Zaru que les connexions dont elle a besoin

Aussi en: English, Español, Português, 日本語, Deutsch, 한국어, 简体中文, Italiano, हिन्दी · Tous les guides en français

Transparence : Zaru est développé par 100monkeys AI, Inc., lisez donc ce guide comme le récit de son fabricant. Il a été rédigé par l'un de nos agents d'IA à partir de la page Profiles de la documentation de Zaru (en anglais), lue le 29 octobre 2026, et des formulations de ce site, puis relu par l'entreprise ; cette version française est une traduction du guide original en anglais. Chaque règle et chaque message cités ci-dessous viennent de cette page ; les citations restent en anglais, avec leur traduction à côté. Là où elle ne dit pas comment une chose fonctionne, nous le disons plutôt que de la décrire.

Dès que Zaru détient votre boîte mail, votre agenda et un jeton GitHub, la question est de savoir lesquels une conversation, une exécution ou une planification donnée peut toucher. Un profil y répond en un seul choix : un ensemble nommé de vos connexions et des outils qu'elles peuvent utiliser. Une exécution sans profil et sans connexions choisies n'en atteint aucune. Ce guide crée un profil, restreint ses outils et l'utilise dans un chat, une planification et un client MCP.

Ce qu'est un profil

La documentation : un profil est "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." (votre propre ensemble nommé de connexions, une boîte mail, un compte d'agenda, un jeton Carbon Forge, anciennement Nuclear Notes, un jeton GitHub et ainsi de suite, en nombre et de type quelconques, avec la liste des outils qu'elles peuvent utiliser et des valeurs par défaut facultatives.) La règle qui le rend utile est écrite au-dessus de la liste, sur la page Profiles elle-même : "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none." (Une exécution, une planification ou une clé API n'atteint que les connexions qu'un profil nomme. Sans profil, elle n'en atteint aucune.)

Étape 1. Créer un compte et connecter ce que vous utilisez

Cliquez sur Get Zaru free ; l'inscription ne demande qu'un nom et une adresse e-mail. Connectez votre e-mail et votre agenda depuis le Vault, comme le site le décrit. Un profil ne peut lister que des connexions que vous détenez déjà : connectez d'abord.

Étape 2. Ouvrir Vault, Profiles

La liste se trouve à /vault/profiles et montre chaque profil avec ses connexions et son nombre d'outils. Cliquez sur New profile. Le même formulaire modifie un profil plus tard.

Étape 3. Le nommer d'après une tâche et choisir ses connexions

Un nom compte de 1 à 64 caractères et est unique parmi vos profils. Nommez-le d'après le travail, pas d'après le compte : l'exemple de la documentation s'appelle "Fundraising". Cochez ensuite les connexions dont la tâche a besoin ; le formulaire les regroupe par type. Une connexion que vous révoquez ou supprimez plus tard reste listée comme removed, et le profil indique "A connection in this profile was removed." (Une connexion de ce profil a été retirée.)

Étape 4. Restreindre les outils

Chaque entrée est un nom d'outil exact, comme mail.reply, ou une famille écrite <family>.*, comme carbon-forge.*. Une liste vide signifie "All tools these connections allow" (tous les outils que ces connexions permettent). Le profil d'exemple de la documentation autorise :

"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]

Le formulaire signale un outil qui attend votre approbation par "Needs your approval" (demande votre approbation). Un profil ne fait que restreindre : une entrée que votre offre n'autorise pas est refusée avec "A profile can only narrow the tools your plan allows; <pattern> is not one of them." (Un profil ne peut que restreindre les outils que votre offre autorise ; <pattern> n'en fait pas partie.)

Étape 5. Savoir ce que le profil ne change pas

Un profil gouverne les outils des familles de ses connexions : mail.*, calendar.*, et pour le reste la famille du fournisseur, comme github.*. Des outils comme fs.*, cmd.run ou web.* ne dépendent d'aucun profil ; seul le contexte de sécurité en décide. Et un outil autorisé passe quand même par le point d'approbation. mail.send, mail.reply, mail.forward, mail.delete et mail.archive attendent votre réponse quoi que dise le profil. Un profil avec mail.reply mais sans mail.send permet donc à une exécution de répondre dans un fil, chaque réponse vous attendant, et refuse aussitôt un nouveau message.

Étape 6. Ajouter les valeurs par défaut

Trois champs facultatifs évitent de retaper : un repository par défaut, l'une de vos liaisons de dépôt git ; un workspace Carbon Forge par défaut, utilisé "when a Carbon Forge call names none" (quand un appel Carbon Forge n'en nomme aucun) ; et des instructions pour les conversations sur ce profil, 4 000 caractères au plus. Zaru reçoit le nom du profil, son workspace et vos instructions.

Étape 7. Le choisir dans une conversation

Ouvrez le panneau de conversation au-dessus du champ de saisie. Sa section Context liste None, puis Profiles, puis vos connexions par type. Choisir un profil efface les connexions choisies, et la ligne au-dessus du champ indique "Profile: <name>". Le profil est enregistré avec la conversation, si bien que les tours suivants et les exécutions qu'ils lancent l'utilisent. Une exécution porte un profil ou des connexions choisies, jamais les deux : "Choose one profile, or choose connections without a profile; not both." (Choisissez un profil, ou des connexions sans profil ; pas les deux.)

Étape 8. L'utiliser pour une planification et une clé API

Le formulaire de planification enregistre un profil ou des connexions choisies, jamais les deux, et le dépôt et le workspace d'un profil remplissent le formulaire. Dans Settings → API Keys, la ligne de chaque clé choisit son profil, None en premier. Une clé sans profil n'atteint aucune de vos connexions.

Étape 9. Le choisir depuis un client MCP

Un client envoie le profil à chaque requête de sa connexion, dans un en-tête qui contient la seule clé réservée @profile :

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

Cet identifiant est celui de l'exemple de la documentation ; utilisez celui de votre propre profil. @profile à côté de toute autre clé reçoit 400.

Étape 10. Lire un refus

Chaque appel gouverné est vérifié par rapport au profil tel qu'il est à ce moment-là. Un outil hors du profil est refusé avec TOOL_NOT_IN_PROFILE : "This tool is not in the profile chosen for this run." (Cet outil n'est pas dans le profil choisi pour cette exécution.) Zaru Web affiche une carte avec un lien vers le profil, pour que vous ajoutiez l'outil ou le laissiez de côté. Une exécution lancée par une autre ne va jamais au-delà des connexions que celle-ci a choisies. Un choix "Always allow" (toujours autoriser) fait lors d'une exécution avec profil ne vaut que pour ce profil, et supprimer le profil le révoque.

Ce que la documentation ne dit pas

Où trouver l'identifiant d'un profil pour l'en-tête MCP. La réponse REST le contient ; la page ne dit pas si Zaru Web l'affiche.
Comment choisir un profil dans les réglages d'un client MCP. La forme de l'en-tête est donnée, pas la configuration d'un client.
Si modifier un profil change une exécution déjà en cours. Les appels sont vérifiés "as it stands at that moment" (tel qu'il est à ce moment-là), mais les connexions deviennent celles de l'exécution à son démarrage.
Ce site ne mentionne pas les profils ; la documentation est la seule source.

Guides associés

Configurer un assistant Zaru qui gère votre e-mail et votre agenda avec approbations, qui connecte la boîte mail et l'agenda qu'un profil restreint ensuite.
FAQ de Zaru

Créez un profil par tâche, et commencez avec le moins d'outils possible.

Get Zaru free