Agentes
Crie agentes extras no seu assistente (1 no Flex e no Starter, 2 no Pro), cada um com memória, arquivos, modelo e, se quiser, um bot próprio no Telegram.
O que são os agentes
Seu assistente tem um agente principal, que atende os seus canais. Um agente extra (ou subagente) é um segundo agente dentro do mesmo assistente, com personalidade, memória e arquivos separados. Serve para separar assuntos: um para investimentos, outro para a vida pessoal, por exemplo.
Os planos Flex e Starter incluem 1 agente + 1 subagente, e o Pro inclui 1 agente + 2 subagentes. Os agentes usam os mesmos créditos e as mesmas chaves do assistente. Se você mudar para um plano com menos agentes, os que já existem continuam funcionando; só não dá para criar novos.
Se o próprio assistente criar agentes pela conversa e passar do que o plano inclui, nada é desativado: os agentes continuam funcionando, e você recebe um aviso no painel e por e-mail com as opções de mudar de plano ou remover os extras na aba Agentes.
Chaves e segredos são compartilhados entre os agentes. Todos usam as mesmas chaves de provedores, chaves de serviço e créditos do assistente. Um agente que executa comandos consegue ler as credenciais dos outros, inclusive o token do bot do Telegram de cada agente. Separar em agentes organiza o atendimento, mas não esconde um segredo de um agente para outro.
Tudo é feito em Meu Assistente > aba Agentes. Não é preciso pedir ao agente pela conversa, e o painel confere cada mudança antes de aplicar.
A aba Agentes
No topo ficam os cards, um por agente, com nome, modelo e canal. Cada card tem três botões:
- Arquivos (pasta): mostra os arquivos desse agente na área de baixo.
- Modelo (chip): leva a Chaves e Segredos, onde o modelo de IA é escolhido.
- Configurar (controles): abre o painel lateral do agente. No agente principal, esse botão leva à aba Comportamento.
Passe o mouse sobre um botão para ver o nome dele. Enquanto houver vaga no plano, um card tracejado Criar agente aparece ao lado dos outros.
Criar um agente
- Clique em Novo agente (ou no card Criar agente).
- Identidade: escolha um ponto de partida (Assistente pessoal, Investimentos, Trabalho ou Estudos), que só preenche a função, ou escreva a sua. Dê um nome e escolha um emoji. O resumo ao lado mostra como o agente vai ficar.
- Canal: para ele ter um bot próprio no Telegram, siga os três passos do guia do @BotFather na tela e cole o token. O token vai direto para um arquivo protegido no assistente: não aparece na conversa nem volta para o navegador. Dá para criar sem canal e ligar um bot depois.
- Grupos do Telegram (opcional): marque grupos em que o bot do Telegram do assistente passa a responder como esse agente, sem precisar de outro bot. Aparecem os grupos liberados em Canais, Telegram. Nesses grupos (inclusive nos tópicos) quem responde é o agente novo, e o principal deixa de responder lá. Dá para mudar depois em Configurações do agente.
- Confirme. O painel mostra cada etapa (pasta e identidade, registro, bot do Telegram e o reinício do atendimento). A criação leva cerca de um minuto.
Se algo der errado (token inválido, por exemplo), o painel desfaz tudo e o seu agente principal continua como estava.
Se o assistente já tiver a pasta de um agente antigo, ela aparece em Workspaces encontrados, com a opção de registrar de novo sem perder os arquivos.
Quem fala com cada agente
Um agente com bot próprio tem regras de canal só dele, em Configurações → Bot próprio no Telegram. Sem escolher nada, ele segue as regras do assistente em Canais.
- Conversas diretas: igual ao principal, só as pessoas que você listar (pelo ID numérico do Telegram) ou ninguém.
- Grupos: igual ao principal, só os grupos que você listar (cada um com a opção de responder só quando mencionado) ou nenhum.
- Chamado por: nomes que contam como menção a esse agente nos grupos (por exemplo, "Zeus"), além do @ do bot.
Um agente pode ser mais restrito que o principal, mas não mais aberto: se o assistente só conversa com uma lista de pessoas, o agente não pode liberar para qualquer pessoa.
Modelo de cada agente
Todo agente novo nasce usando o mesmo modelo do assistente e acompanha quando ele muda. Para dar um modelo próprio a um agente, vá em Chaves e Segredos > Modelo de cada agente (o botão Modelo do card leva direto até lá) e escolha entre os modelos liberados para o seu assistente.
Nos planos Starter e Pro, o agente escolhe entre o provedor principal e o de proteção do assistente. Um agente com modelo próprio usa a mesma proteção (o modelo reserva) do assistente. Se o modelo dele deixar de estar liberado (por exemplo, depois de trocar de provedor), ele volta a seguir o assistente e você recebe um aviso, em vez de o agente parar de responder.
Configurar
O botão Configurar abre um painel lateral em quatro abas:
- Perfil: emoji, nome e descrição. O identificador aparece travado, porque é o nome da pasta do agente.
- Canais: o bot próprio do agente (conectar, trocar o token ou desconectar), quem fala com ele, os grupos em que o bot do assistente responde como o agente e os nomes que chamam o agente nos grupos.
- Comportamento: o modelo (alterado em Chaves e Segredos), o nível de raciocínio, o modo rápido, as habilidades que o agente pode usar, a busca na memória e o heartbeat, com intervalo e horário.
- Avançado: remover o agente ou apagar os dados dele.
Campo sem valor herda o padrão do assistente. As alterações das abas ficam pendentes até você clicar em Salvar, na barra do rodapé, que mostra quantas há. O token do bot é a exceção: é aplicado na hora.
Conectar ou trocar o bot
Na aba Canais, Conectar bot liga um bot do Telegram a um agente que ainda não tem um: crie o bot no @BotFather com /newbot e cole o token. Trocar token serve quando o token vazou ou foi revogado: mande /revoke no @BotFather, escolha o bot e cole o token novo. O painel espera o Telegram aceitar o token e mostra o resultado, o que pode levar cerca de 1 minuto. Se o token novo falhar, o anterior continua valendo. Depois de salvo, o token não aparece de novo no painel. Com o bot conectado, o painel mostra o @ dele, com link para abrir a conversa no Telegram.
Arquivos
A área Arquivos fica abaixo dos cards e mostra a pasta (workspace) de um agente por vez. Troque de agente pelo seletor no topo ou pelo botão Arquivos do card. Clique numa pasta para entrar e use o caminho no topo para voltar.
- Enviar: pelo botão ou arrastando arquivos para a lista, até 100 MB por arquivo. O progresso aparece por arquivo. Se já existir um arquivo com o mesmo nome, o painel pergunta antes de substituir.
- Nova pasta e novo arquivo Markdown.
- Renomear e baixar um arquivo, uma pasta ou o workspace inteiro (Baixar tudo, em
.tar.gz, até 2 GB). - Marque vários itens para apagar de uma vez.
Os arquivos da QuickClaw (PLATFORM.md e afins) ficam escondidos: são as regras que o agente lê e a plataforma mantém atualizadas. O agente principal também tem a sua área de Arquivos.
Editar Markdown
Arquivos .md (como SOUL.md, USER.md ou as notas em memory/) abrem num editor com três modos: Editar, Dividido (texto e prévia lado a lado) e Prévia. Salve com o botão ou com Ctrl+S. Arquivos .txt, .json, .yaml, .csv e .py abrem em texto simples. Se o agente mudar o arquivo enquanto você edita, o painel avisa em vez de sobrescrever.
Apagar arquivos
Apagar um arquivo ou uma pasta na área Arquivos é definitivo: não há lixeira nem cópia. O painel pede confirmação e oferece baixar antes. Pastas com mais de 20 mil itens não são apagadas pelo painel: apague por partes ou peça ao agente.
Desconectar, remover ou apagar
- Desconectar bot (aba Canais): o bot próprio do agente para de responder; o token e os grupos desse bot saem do assistente. Memória, arquivos e os grupos do bot do assistente ficam. Para ligar de novo, use Conectar bot com um token e libere os grupos desse bot outra vez.
- Remover (aba Avançado): o agente sai do assistente, mas os arquivos ficam guardados e aparecem em Workspaces encontrados.
- Apagar dados (aba Avançado): apaga conversas, memória e arquivos do agente. Você confirma digitando o identificador dele.
Apagar dados não pode ser desfeito por você. Antes, o painel guarda uma cópia por 30 dias, que só o suporte consegue restaurar. O agente principal nunca pode ser desativado, removido nem apagado.
Proteger token
Agentes criados pela conversa, antes desta aba existir, podem ter o token do bot salvo em texto na configuração. Nesse caso a aba Canais do painel Configurar fica marcada e mostra o botão Proteger token, que move o token para um arquivo protegido. O bot do agente continua no ar. Trocar o token também resolve, porque o novo já vai para o arquivo protegido.