Skip to main content
Versão atual do Zatten-OS: 4.4.0 As quatro skills (zatten-ops, zatten-comercial, zatten-agencia e zatten-grill) saem juntas e têm sempre a mesma versão. O assistente compara este número com a versão da skill instalada (campo metadata.version do SKILL.md). Se a instalada for menor, ele avisa a pessoa e mostra o comando de atualização.

Como atualizar

Vindo de uma versão anterior, os nomes mudaram e a atualização não acontece sozinha com npx skills: remova as antigas (npx skills remove zatten zatten-os) e instale de novo (Instalar a skill e o MCP). No Claude Code, claude plugin update zatten-os@zatten-os basta; se ainda tiver o plugin zatten@zatten, desinstale.
No Claude Code, ligue a atualização automática do marketplace zatten-os em /plugin → Marketplaces. Ela vem desligada para marketplaces de terceiros.

O que mudou

4.4.0

  • O gestor responde as variáveis do prompt: instructions.variables_meta diz, por variável, a pergunta (hint) e se o gestor a responde (gestor_editable). Ele responde na aba Informações do agente e publica na hora (O gestor responde as variáveis).
  • Duplicar um projeto esvazia as variáveis do prompt, salvo com keep_variable_values: true no create_project (no painel, Levar os valores das variáveis). O agente não liga com variável usada no prompt vazia.
  • O seletor de versões do builder mostra quem salvou e o que mudou em cada versão (Versões e publicação).

4.3.1

  • Ações de apps integrados (Google Agenda, Gmail…) aceitam on_error, a mensagem para a IA quando a chamada falha, como a tool HTTP. A falha não encerra mais o atendimento: o modelo recebe o erro e segue a mensagem (Integrações como ferramentas do agente).
  • Criar, duplicar ou aplicar um template avisa nas notes quando um app usado pelo agente não está conectado no projeto. A conexão nunca viaja.

4.3.0

  • Variáveis do prompt: o que muda de um cliente para outro (nome, cidade, horário) fica em instructions.variables, e o prompt usa {{chave}}. Para adaptar um agente a outro cliente, troque as variáveis, não o prompt (Variáveis do prompt).
  • Memória entre conversas pelo MCP: a tool builtin historico_conversas liga a memória (Memória entre conversas).

4.2.0

  • O template passa a carregar mais do projeto: o horário em que o agente atende (meta.active_schedule), os modelos de mensagem da API não oficial (zapster_templates), o filtro de departamento das mensagens rápidas (department_names) e a opção de entrar e sair do departamento sozinho (allow_self_service_toggle) (referência do template).
  • Chave de IA vazia não apaga mais: "" mantém a chave atual, como campo ausente. O que grava por cima é um texto de exemplo no lugar da chave (como uma escrita funciona).
  • Regra nova: perguntar antes de mudar o horário do agente.

4.1.0

  • Membros pelo MCP: create_member cria o login (com a senha que a pessoa escolher) e update_member_access muda papel, senha, projetos e departamentos, com quem recebe leads em cada um (ferramentas).
  • list_members passa a mostrar os departamentos de cada membro e se ele recebe os leads de cada um.
  • Regra nova: membros com “sim”, e a senha nunca é repetida. Admin e remover membro continuam só no painel.

4.0.0

  • A skill de operação passa a se chamar zatten-ops, e chegam três irmãs: zatten-comercial (diagnóstico do cliente, demo, proposta e viabilidade), zatten-agencia (diagnóstico da agência, SDR da agência, rotina e relatório mensal) e zatten-grill (rodadas de perguntas para decisões grandes).
  • O setup na primeira vez: conhecer a agência, organizar as pastas e as organizações, uma primeira vitória e a assinatura.
  • As pastas espelham as organizações do painel, com operacao/ e comercial/ em cada cliente, versionadas com Git (Organizar sua agência).
  • Ferramentas novas no MCP: create_organization, rename_organization, move_project e get_metrics.
  • Dicas na primeira vez que um conceito aparece e, no máximo, uma chamada comercial por sessão.
  • A aba Vender nesta doc.

3.0.0

  • A skill passa a se chamar zatten-os (Zatten-OS).
  • O loop de trabalho: buscar nesta doc em toda tarefa nova, separar o que o assistente confere sozinho do que é decisão da pessoa, conferir cada entrega.
  • As ferramentas novas do MCP: create_project, test_agent, find_contacts, list_members, get_white_label e send_feedback, e o bloco project do get_template (ferramentas).
  • Construir o agente iterando: mudar, testar e ajustar sem publicar.
  • Regras novas: criar projeto com “sim”, “sim” antes de entrar em modo de teste, intent e feedback sem dado do cliente final, chave do LangSmith só no .env.

2.0.0

  • A skill passa a ser curta e estável: regras, fluxo de trabalho e o mapa desta documentação. O conhecimento de produto mora aqui na doc.
  • Diretório da agência (AGENTS.md, AGENCIA.md, clientes/), memória por cliente e snapshots sem credenciais.
  • Plano e “sim” antes de toda escrita, diagnóstico na primeira vez com um cliente e relatório em formato fixo.

1.x

  • Manual técnico do MCP de template. Substituída pela 2.0.0.

Para saber mais