ZaruDê a cada execução do Zaru só as conexões de que ela precisa
Também em: English, Español, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todos os guias em português
Aviso: o Zaru é desenvolvido pela 100monkeys AI, Inc., então leia este guia como o relato de quem o fabrica. Ele foi redigido por um dos nossos agentes de IA a partir da página Profiles da documentação do Zaru, lida em 29 de outubro de 2026, e dos textos deste site, e revisado pela empresa; esta versão em português é uma tradução do guia original em inglês. Cada regra e mensagem citada abaixo é daquela página, em inglês com a tradução ao lado. Onde ela não diz como algo funciona, dizemos isso em vez de descrever.
Quando o Zaru já tem sua caixa de e-mail, sua agenda e um token do GitHub, a pergunta é a quais deles uma conversa, execução ou agendamento pode chegar. Um perfil responde com uma escolha só: um conjunto nomeado das suas conexões e das ferramentas que elas podem usar. Uma execução sem perfil e sem conexões escolhidas não chega a nenhuma. Este guia monta um perfil, restringe suas ferramentas e o usa num chat, num agendamento e num cliente MCP.
O que é um perfil
A documentação: um perfil é "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." (seu próprio conjunto nomeado de conexões, como uma caixa de e-mail, uma conta de agenda, um token do Carbon Forge, antes Nuclear Notes, ou um token do GitHub, em qualquer número e de qualquer tipo, com uma lista das ferramentas que podem usar e padrões opcionais). A regra que o torna útil está impressa acima da lista na própria página Profiles: "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none." (Uma execução, um agendamento ou uma chave de API só chega às conexões que um perfil nomeia. Sem perfil, não chega a nenhuma).
Passo 1. Crie uma conta e conecte o que você usa
Clique em Get Zaru free; para se cadastrar bastam nome e e-mail. Conecte seu e-mail e sua agenda pelo Vault, como o site descreve. Um perfil só pode listar conexões que você já tem, então conecte primeiro.
Passo 2. Abra Vault, Profiles
A lista fica em /vault/profiles e mostra cada perfil com suas conexões e sua contagem de ferramentas. Clique em New profile. O mesmo formulário edita um perfil depois.
Passo 3. Dê o nome de um trabalho e escolha as conexões
Um nome tem de 1 a 64 caracteres e é único entre seus perfis. Dê o nome do trabalho, não da conta: o exemplo da própria documentação se chama "Fundraising". Depois marque as conexões de que o trabalho precisa; o formulário as agrupa por tipo. Uma conexão que você revogar ou apagar depois continua listada como removed, e o perfil diz "A connection in this profile was removed." (Uma conexão deste perfil foi removida).
Passo 4. Restrinja as ferramentas
Cada entrada é um nome exato de ferramenta, como mail.reply, ou uma família escrita <family>.*, como carbon-forge.*. Uma lista vazia significa "All tools these connections allow" (todas as ferramentas que estas conexões permitem). O perfil de exemplo da documentação permite:
"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]O formulário marca com "Needs your approval" (precisa da sua aprovação) a ferramenta que espera o seu sim. Um perfil só restringe: uma entrada que seu plano não permite é recusada com "A profile can only narrow the tools your plan allows; <pattern> is not one of them." (Um perfil só pode restringir as ferramentas que seu plano permite; <pattern> não é uma delas).
Passo 5. Saiba o que o perfil não muda
Um perfil governa as ferramentas das famílias das suas conexões: mail.*, calendar.* e a família do provedor para o resto, como github.*. Ferramentas como fs.*, cmd.run ou web.* não são governadas pelo perfil; só o contexto de segurança decide sobre elas. E uma ferramenta permitida ainda passa pelo portão de aprovação. mail.send, mail.reply, mail.forward, mail.delete e mail.archive esperam a sua resposta, diga o perfil o que disser. Assim, um perfil com mail.reply e sem mail.send deixa uma execução responder numa conversa, cada resposta esperando por você, e recusa de imediato uma mensagem nova.
Passo 6. Defina os padrões
Três campos opcionais poupam digitação: um repository padrão, um dos seus vínculos com repositórios git; um workspace padrão do Carbon Forge, usado "when a Carbon Forge call names none" (quando uma chamada ao Carbon Forge não nomeia nenhum); e instructions para as conversas neste perfil, com no máximo 4.000 caracteres. O Zaru recebe o nome do perfil, seu workspace e suas instruções.
Passo 7. Escolha-o numa conversa
Abra o painel da conversa acima do campo do chat. Sua seção Context lista None, depois Profiles, depois suas conexões por tipo. Escolher um perfil limpa as conexões escolhidas, e a linha acima do campo diz "Profile: <name>". O perfil fica salvo com a conversa, então os turnos seguintes e as execuções que eles iniciam o usam. Uma execução leva um perfil ou conexões escolhidas, nunca os dois: "Choose one profile, or choose connections without a profile; not both." (Escolha um perfil, ou escolha conexões sem perfil; não os dois).
Passo 8. Use-o num agendamento e numa chave de API
O formulário de agendamento salva um perfil ou conexões escolhidas, nunca os dois, e o repositório e o workspace do perfil preenchem o formulário. Em Settings → API Keys, a linha de cada chave escolhe o perfil, com None primeiro. Uma chave sem perfil não chega a nenhuma das suas conexões.
Passo 9. Escolha-o num cliente MCP
Um cliente envia o perfil em cada requisição da sua conexão, num cabeçalho que leva só a chave reservada @profile:
x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}Esse id é o do exemplo da documentação; use o id do seu próprio perfil. @profile ao lado de qualquer outra chave recebe 400.
Passo 10. Leia uma recusa
Cada chamada governada é conferida contra o perfil como ele está naquele momento. Uma ferramenta fora dele é recusada com TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this run." (Esta ferramenta não está no perfil escolhido para esta execução). O Zaru Web mostra um cartão com link para o perfil, para você acrescentar a ferramenta ou deixá-la de fora. Uma execução iniciada por outra nunca vai além das conexões que a outra escolheu. Uma escolha "Always allow" (sempre permitir) feita numa execução com perfil vale só para aquele perfil, e apagar o perfil a revoga.
O que a documentação não diz
- Onde achar o id de um perfil para o cabeçalho MCP. A resposta REST o traz; a página não diz se o Zaru Web o mostra.
- Como escolher um perfil nas configurações de um cliente MCP específico. A forma do cabeçalho é dada, não a configuração de um cliente.
- Se editar um perfil muda uma execução já em andamento. As chamadas são conferidas "as it stands at that moment" (como ele está naquele momento), mas as conexões passam a ser da execução no início.
- Este site não menciona perfis; a documentação é a única fonte.
Guias relacionados
- Configure um assistente Zaru que cuida do seu e-mail e da sua agenda com aprovações, que conecta a caixa de e-mail e a agenda que um perfil depois restringe.
- Perguntas frequentes do Zaru
Crie um perfil por trabalho e comece com o mínimo de ferramentas.