Montar um gráfico de recompensas à mão exige saber qual cartão lê o quê, qual campo é obrigatório e qual combinação não faz nada em silêncio. O Assistente de gráficos faz essa parte junto com você: você descreve o que quer, ele propõe um gráfico, e você decide se ele entra ou não.
✨ O que é
Um painel de chat no editor de gráficos, tanto no gráfico de recompensas dos Níveis quanto nos Comandos personalizados em modo gráfico. Abra-o com o botão ✨ no canto superior direito da tela.
Ele pertence à sua equipe, não a você pessoalmente. Todos da equipe veem a mesma conversa, então um colega pode continuar de onde você parou, e você pode ver o que ele já perguntou em vez de perguntar de novo.
✏️ Ele edita o seu gráfico, nunca o substitui
O assistente envia apenas as mudanças que quer fazer: adicionar este cartão, alterar aquele campo, conectar estes dois, remover aquele. Tudo o que ele não citar fica exatamente como estava.
Isso importa mais do que parece. A primeira versão respondia com um gráfico substituto completo, e, em um gráfico longo, o modelo o reconstruía de memória e deixava ramos de fora sem avisar, resultando em um gráfico menor que ainda parecia perfeitamente válido.
Uma ressalva honesta: um modelo que ignora a instrução e responde com um gráfico inteiro mesmo assim é aceito, porque recusar a resposta seria pior. Essa resposta agora vem identificada como tal, na conversa e de novo na janela de revisão, logo acima do botão Aplicar, para você saber quando está diante de uma reconstrução e não de uma edição. Tudo o que desapareceria é listado em removidos, preto no branco. Com modelos menores, vale ler essa lista em vez de passar os olhos.
Dois efeitos colaterais vêm de brinde: os identificadores dos cartões são atribuídos pelo painel e não pelo modelo, então não há duplicatas, e remover um cartão leva os links dele junto, então nenhum link fica apontando para o nada.
🔒 Ele propõe. Você aplica.
Nada do que ele sugere é aplicado por conta própria. Uma proposta aparece na conversa com os botões Ver as alterações e Descartar, e, até você aplicar pela janela de revisão, o seu gráfico não é tocado.
👀 A janela de revisão
Ver as alterações abre um resumo do que a proposta faria:
- cada cartão adicionado,
- cada campo alterado, com o valor anterior e o novo lado a lado,
- cada cartão e link removido.
Ela é calculada em relação ao gráfico que você tem na tela naquele momento, e não ao que existia quando a resposta chegou: se você editou algo nesse intervalo, o que você lê é o que realmente vai acontecer. Uma proposta que não mudaria nada diz isso, e o Aplicar continua desativado.
Isso não é formalidade. Um gráfico de recompensas é automação ao vivo no seu servidor: ele distribui cargos, envia DMs e concede XP a membros reais. A decisão de executá-lo cabe a uma pessoa.
Se você pode conversar com o assistente, mas não alterar um servidor, ainda vê as propostas: o botão Aplicar simplesmente fica acinzentado. Ler o que foi sugerido é útil mesmo quando agir sobre isso não é com você.
🧪 Uma proposta é verificada antes de ser oferecida a você
Todo gráfico proposto é validado contra a lista real de cartões antes de o botão Aplicar aparecer. Quando algo está errado, os problemas são listados:
- um cartão que não existe,
- uma ação sem um campo obrigatório (uma ação Atribuir cargo sem cargo seria ignorada em silêncio quando o gráfico rodasse),
- um link apontando para um cartão que não está lá,
- um gráfico de comando sem a sua Resposta, que o painel se recusaria a salvar de qualquer jeito.
Agora ele tenta corrigir isso sozinho. Quando uma proposta é recusada, a recusa e as operações exatas que a causaram voltam ao assistente, e ele ganha até mais duas tentativas antes de a resposta ser entregue a você. Você vê cada tentativa aparecer na conversa conforme acontece, então uma correção é algo que você acompanha, e não algo que precisa pedir.
Se ele ainda for recusado depois disso, os problemas são listados com um botão Perguntar de novo. Três tentativas é o teto de propósito: um modelo que não consegue satisfazer o validador duas vezes está preso em algo que uma pergunta formulada de outro jeito resolve mais rápido do que uma quarta tentativa.
É também por isso que uma tentativa que falhou continua visível na conversa em vez de ser arrumada. É isso que o assistente lê para se corrigir na tentativa seguinte.
👀 Vendo-o pensar
Cada resposta traz o raciocínio do assistente, recolhido sob Ver o raciocínio. Vale abri-lo quando uma proposta o surpreende: ele costuma explicar qual condição achou que você queria, e isso é mais rápido do que ler o gráfico cartão por cartão.
As perguntas são identificadas com quem as fez, porque a conversa é compartilhada.
⏳ Um pedido de cada vez
Enquanto o assistente trabalha, o campo de escrita fica desativado para a equipe inteira, em todas as conversas, e todos veem para quem ele está trabalhando. Uma equipe compartilha um modelo e uma conta, então duas perguntas simultâneas custariam o dobro e se atropelariam nas respostas.
💬 Várias conversas
Os gráficos de recompensas e os comandos personalizados já não compartilham uma única conversa. Comece uma nova conversa sempre que mudar de assunto: cada uma mantém o seu próprio histórico, e esse histórico é tudo o que o assistente vê, então uma discussão anterior sem relação não consegue confundi-lo.
Perguntar de novo em qualquer resposta devolve a sua pergunta anterior à caixa, para você ajustar uma palavra em vez de redigitar tudo. A resposta que ela substitui deixa de oferecer Aplicar.
Uma conversa terminada pode ser excluída com o botão 🗑 ao lado dela: ela leva as mensagens junto, e todos da equipe a veem desaparecer. O botão fica oculto quando só resta uma conversa, já que o painel sempre precisa de uma conversa para escrever, e excluir uma em que o assistente está trabalhando é recusado em vez de permitir que isso quebre a execução.
Se um pedido falha, a conversa avisa e o assistente é liberado imediatamente. Quando o endpoint recusa a chamada (um nome de modelo que ele não conhece é o motivo habitual), a explicação dele mesmo é o que aparece na conversa, para você ler o que precisa mudar.
🌍 O que ele pode ver, e o que você deixa que ele veja
O botão ⚙ na janela do chat abre O que o assistente pode ler: dois interruptores, cada um uma fonte de contexto, cada um só seu. Eles acompanham você de um servidor e de uma conversa para a seguinte, e não mudam nada para os seus colegas: cada pessoa da equipe decide por si.
Os outros servidores da sua equipe
Ativado por padrão. Ele pode olhar todos os servidores que a sua equipe possui: quais recursos estão ativados, como estão configurados e os seus gráficos. É isso que faz de "configure isto como no meu outro servidor" uma pergunta que ele de fato consegue responder.
Desative e ele deixa de ser informado sobre eles. O inventário não é montado e depois escondido; ele não é montado.
O que o bot recorda aqui
Desativado por padrão. Se a Memória de IA estiver ativada, o bot anota coisas que aprende sobre o seu servidor nas conversas do Discord. Conceder isso entrega essas anotações ao assistente junto com a sua pergunta, para que ele as leve em conta.
Ele fica desativado até você ativar por um motivo: é um contexto que o assistente nunca teve antes, é reenviado a cada pergunta que você faz, e o que ele contém foi escrito pelos seus membros, e não por você.
Quando ativado, o que ele recebe é limitado de propósito:
- o servidor que você tem aberto no momento, e nenhum outro,
- anotações sobre o próprio servidor, nunca as que o bot registrou sobre um membro individual, que pertencem à conversa daquele membro com o bot e ficam lá,
- um número fixo das anotações mais recentes, cada uma cortada em um tamanho razoável, para que uma memória crescente não aumente em silêncio o custo de cada pergunta.
- somente enquanto a configuração de memória do servidor estiver ativada. Desativá-la faz o bot parar de registrar e faz isto parar também: as anotações já escritas ficam onde estão, e nada é entregue.
Dois limites que não são opcionais
- Ele nunca vê as suas credenciais. Chaves de API, tokens e segredos são mascarados antes de ele ser informado de qualquer coisa, exatamente como em todos os outros lugares do painel.
- Ele só escreve um gráfico, no servidor que você tem aberto no momento. Não consegue alterar a configuração dos recursos e não consegue tocar em outro servidor.
⚙️ Qual modelo ele usa
Por padrão, ele usa o modelo configurado pela plataforma. Uma equipe pode trazer o seu: a sua própria chave de API, o seu próprio modelo ou o seu próprio endpoint. Qualquer endpoint compatível com OpenAI funciona e, nesse caso, nenhuma chave de API é necessária.
O endpoint precisa estar acessível por HTTPS em um endereço público. Um modelo rodando no seu notebook atrás do roteador não está: o painel é um servidor em outro lugar, e deixar que ele chame endereços privados sob demanda é um jeito conhecido de transformar um produto em um scanner da própria rede. A auto-hospedagem funciona quando o endpoint é publicado; uma máquina na sua mesa, não.
Você o define na página de configurações da equipe, em Modelo do assistente. Somente o dono da equipe pode alterá-lo, porque é uma credencial e não uma preferência. A chave é armazenada e nunca mais exibida: deixe o campo em branco ao salvar e a armazenada é mantida.
Listar modelos, ao lado do campo do modelo, pergunta ao endpoint o que ele de fato oferece e apresenta a resposta como sugestões: ele usa a URL e a chave que estão no formulário no momento, então você pode verificar um endpoint antes de salvá-lo. O campo continua sendo de texto livre: publicar uma lista de modelos é opcional, e vários servidores auto-hospedados não o fazem, então, quando nada volta, o motivo é exibido e você digita o nome por conta própria.
💡 Obtendo uma boa resposta
Diga o que deve acontecer e com quem, não quais cartões usar: decidir isso é trabalho dele:
- "Dê o cargo Veteran no nível 25, mas só para os boosters."
- "Quando alguém resolver o Wordle em três tentativas ou menos, conceda 200 XP e dê os parabéns em #general."
- "Igual ao gráfico do meu outro servidor, mas com o anúncio em #levels."
Depois leia o raciocínio, confira os cartões que ele escolheu e aplique.
Peça a ele que altere uma coisa de cada vez. Um pedido curto e específico gera uma lista curta de mudanças, muito mais fácil de conferir na janela de revisão do que uma dúzia de uma vez.