DzBot Logo
DzBotBots • IA • Automações
FuncionalidadesComo funcionaLojaBlogNovidadesChatStatus
EntrarCriar conta

Buscar

Buscar páginas do site

Navegação

Funcionalidades
Como funciona
Loja
Blog
Novidades
Chat
Status
Começar agoraEntrar na minha conta
Navegar na documentação
  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Guias, referência da API e diagnóstico — escritos para serem lidos antes de integrar, não depois do primeiro erro.

  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Guias, referência da API e diagnóstico — escritos para serem lidos antes de integrar, não depois do primeiro erro.

IA SEGURA

Provider local ou externo, sem expor a chave

O plugin AI Chat continua usando Ollama local por padrão. Você pode apontar para um serviço com chave própria direto na tela, sem mexer em arquivo e sem reiniciar a plataforma.

Na tela (por bot)

Configurações → “Provider de IA”. Escolha o serviço, o endpoint e o modelo, cole a sua chave e clique em “Testar conexão” antes de salvar: o botão mostra o motivo real de uma falha (status HTTP e o que o serviço respondeu), em vez de um “ok” genérico.

  • •Ollama local — sem chave, sem custo
  • •OpenAI, Groq, OpenRouter, DeepSeek, Together, LM Studio, vLLM, llama.cpp, LiteLLM
  • •Anthropic
  • •Google Gemini
  • •Serviço próprio (custom)
  • — A chave é write-only: entra e nunca volta. A tela só mostra os últimos 4 caracteres.
  • — Trocar o endpoint com o campo da chave em branco mantém a chave que já estava salva.
  • — A configuração só entra em vigor quando o bot reinicia — o provider é resolvido na hora que o plugin é construído.
  • — Só o dono do bot vê esta seção. A plataforma confere a propriedade em leitura e escrita.
  • — Se a configuração estiver inválida, o bot sobe normalmente e só a resposta de IA fica desligada.

No servidor (global)

Vale para todos os bots e é o que o plugin usa quando um bot não tem configuração própria. `external` continua disponível para quem já usava: URL exata + Bearer.

AI_PROVIDER=external
AI_ENDPOINT=https://seu-endpoint/v1/generate
AI_API_KEY=chave-write-only
AI_MODEL=modelo
AI_TIMEOUT_MS=15000
AI_RATE_LIMIT_PER_MINUTE=12
AI_ALLOWED_ACTIONS=follow,come,stop,collect,equip

Regras de segurança

  • ✓ A chave nunca usa NEXT_PUBLIC_ e nunca volta ao navegador — nem pela resposta que confirma o salvamento.
  • ✓ Ela fica em arquivo com permissão restrita (0600), não no banco.
  • ✓ Respostas passam por schema e limites de tamanho.
  • ✓ attack e mine ficam bloqueados por padrão.
  • ✓ Delay, onlyWhisper e rate limit por jogador são aplicados.

Para Ollama local

AI_PROVIDER=ollama
OLLAMA_URL=http://127.0.0.1:11434
AI_MODEL=llama3.2:1b

Se a IA não responder

O chat engole erro de propósito (uma falha de IA não pode derrubar o bot), então silêncio no chat é o comportamento normal quando algo falha. Use “Testar conexão”: ele mostra status e o detalhe que o serviço devolveu. Se o teste passar e o chat não responder, confira se a ação pedida está na allowlist.

← Voltar ao guia de rede
Nesta página
  1. Na tela (por bot)
  2. No servidor (global)
  3. Regras de segurança
  4. Para Ollama local
  5. Se a IA não responder

Nesta página

  1. Na tela (por bot)
  2. No servidor (global)
  3. Regras de segurança
  4. Para Ollama local
  5. Se a IA não responder

Projeto independente

Ajude o DZ Bot a continuar evoluindo

Seu apoio mantém servidores e APIs ativos e ajuda a criar novas funções.

Apoiar o DZ Bot→
DZBotDZBot

Plataforma para criar, configurar e acompanhar bots, automações e integrações em um painel web.

Produto

  • Funcionalidades
  • Plataforma
  • Como funciona
  • Planos

Recursos

  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Comunidade

  • Blog
  • Novidades
  • Sobre a DzBot
  • Avaliações
  • Dúvidas
  • Reportar problema

Suporte

  • [email protected]
  • Contato
  • Comunidade no Discord
  • Status do sistema

Informações legais

  • Privacidade
  • Termos de uso
© 2026 DZBot · Todos os direitos reservados.
NovidadesVersão e tecnologiasVoltar ao topo ↑