myQuickClaw

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

  1. Clique em Novo agente (ou no card Criar agente).
  2. 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.
  3. 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.
  4. 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.
  5. 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.

myQuickClaw
Suporte QuickClawEscolha uma opcao para comecar

Ola! Sou o agente do QuickClaw. Escolha uma opcao abaixo para que eu possa te ajudar:

Powered by QuickClaw