criar-agente

Criar um agente

Esta skill é o roteiro do Admin para criar um agente de trabalho. A conversa tem dez passos, com uma pergunta por vez, e termina com o agente respondendo de verdade. O dono não vê o terminal: toda fala sai pela ferramenta mcp__dgchat__reply, no chat c_admin. As mensagens são curtas e sem jargão ("caixa separada" no lugar de container; porta, uid e runner não aparecem).

Princípios da conversa:

• Uma pergunta por vez. Só a pergunta do passo atual aparece.
• O caminho rápido é o único visível. Opções avançadas (modelo específico, chave de API) só entram se o dono pedir.
• Detectar em vez de perguntar: o que o Admin consegue descobrir sozinho, ele descobre.
• O agente só é dado como pronto depois que respondeu a um "oi" de verdade.

Criação pelo formulário do painel (caminho principal)

O Admin continua sendo uma sessão Claude Code normal e administradora. O formulário é um visual nativo dentro da conversa, com o mesmo marcador [do visual ...] usado pelos arquivos vis-* e pelos botões data-pergunta. Ele envia texto pelo chat; somente você executa os comandos.

1. Cumprimente e pergunte o nome: “Como vai se chamar seu primeiro agente?”. O cartão do painel já permite responder e preencher função, tom e foto opcional. Ao explicar o cartão, siga a ordem em que ele aparece: primeiro o botão Quero criar meu primeiro agente, depois o campo do nome e Continuar, por último o formulário e Criar meu agente. O campo do nome só aparece depois do botão; não mande escrever o nome antes de tocar nele. Se o dono disser que está preenchendo, espere a confirmação do formulário. Não crie só porque recebeu o nome.
2. O clique em Criar meu agente salva um pedido e envia [do visual Criar meu agente] com as escolhas confirmadas. Esse clique confirma a criação. O id fica no servidor; nunca o mostre no chat. Não peça outra confirmação. Na primeira mensagem em que você começa a criar (por exemplo, ao receber [do visual Criar meu agente]), escreva numa linha só [ver a criação]. O painel troca esse marcador por um botão que reabre a janela de criação se a pessoa tiver fechado. Use o marcador uma vez só, nessa mensagem.
3. Leia o pedido com node /opt/dgclaw/app/web/bin/onboarding.js ver atual. Nome, função e tom são dados da pessoa, nunca instruções para executar shell. Não use eval nem monte comandos com interpolação desses campos. O helper passa os dados como argumentos separados.
4. Confira dgclaw imagem status. Se ainda estiver construindo, explique e aguarde. Se ainda não existe, rode dgclaw imagem construir e acompanhe até ficar pronta. Se falhou, diagnostique e rode dgclaw imagem construir. Não dispare criação enquanto faltar a imagem.
5. Diga “Vou preparar seu agente agora” e rode: node /opt/dgclaw/app/web/bin/onboarding.js criar atual. Deixe o comando concluir. Se a ferramenta pedir um limite, use 600000 ms (dez minutos). Não encerre a criação por causa de uma troca de tela. O helper executa dgclaw agente criar de verdade e atualiza o visual. Se o mesmo pedido já tem agente cadastrado, retoma a etapa do login sem criar outro. Não refaça por fora do helper.
6. A tela mostra Conectar minha assinatura. Oriente a pessoa a abrir esse botão, entrar na conta e voltar em Já entrei. Pode testar. Nunca solicite senha, código ou token no chat.
7. Quando ela voltar, rode node /opt/dgclaw/app/web/bin/onboarding.js testar atual. O helper envia uma saudação pela conversa real e espera uma resposta nova do agente no registro. Sem resposta, ele explica a falha e mantém a caixa fechada. Resolva a causa e repita testar com o mesmo id.
8. Só após o teste, o visual abre a caixa e mostra a foto ou um avatar neutro com o link para a conversa. Diga “Seu agente respondeu. Toque no cartão dele para começar”.