Zé Bot.
Como usar Z.AI
Use os modelos GLM do Z.AI no Zé Bot com uma chave de API.
O que é
O Z.AI é um provedor de IA que pode ser escolhido ao configurar um agente do Zé Bot. Ele oferece modelos GLM para conversa, raciocínio e código e é acessado por um endpoint OpenAI compatível: https://api.z.ai/api/paas/v4.
Antes de começar
- Ter uma conta no Z.AI.
- Criar uma chave de API no painel do Z.AI.
- Ter conexão com a internet; o Zé Bot não intermedeia a cobrança do provedor.
Como conectar
- Abra um agente existente ou crie um novo.
- No seletor de provedor e modelo, escolha Z.AI.
- Confira o Endpoint. O padrão é
https://api.z.ai/api/paas/v4. - Cole a Chave de API no campo do agente. A chave fica no cofre seguro do sistema e não aparece no histórico.
- Escolha o Modelo. O padrão é
glm-5.3. - Envie uma tarefa curta para validar a conexão, como “Liste três ideias para organizar minha semana”.
Como escolher o modelo
O Zé Bot tenta consultar o catálogo https://api.z.ai/api/paas/v4/models com a chave do agente. Quando o provedor responde, o campo de modelo mostra os IDs disponíveis e também aceita um ID digitado. Quando o catálogo não responde, a lista de reserva traz glm-5.3, glm-5.3-flash e glm-5.2.
Os IDs de modelo são do provedor e podem mudar sem aviso. Se um modelo não existir mais, escolha outro no catálogo ou consulte a documentação oficial do Z.AI.
Como criar um agente com Z.AI
- Em Agentes, crie um agente ou abra um existente.
- Em Provedor, escolha Z.AI.
- Informe ou confirme o endpoint e a chave de API.
- Escolha o modelo e, se o provedor oferecer, o nível de raciocínio.
- Envie uma tarefa curta e confira a resposta antes de usar o agente em trabalho real.
Limites
- O Z.AI cobra por uso e separa as chaves do plano de codificação das chaves da API padrão.
- O catálogo de modelos depende da conta e da região; alguns modelos podem não estar disponíveis para a sua chave.
- O runtime HTTP envia a conversa como Chat Completions e não encaminha ferramentas MCP. Para agentes que precisam usar ferramentas e arquivos do workspace, prefira Codex, Claude, OpenCode ou outro provedor ACP.
- O Zé Bot não controla cotas, limites de taxa nem preços do provedor. Consulte o painel do Z.AI.
Problemas comuns
A chave é recusada com 401 ou 403
Confira se a chave foi copiada inteira, se pertence à conta certa e se tem permissão para o modelo escolhido. Chaves de plano de codificação podem não valer para a API padrão.
O catálogo de modelos não aparece
O Zé Bot mantém a lista de reserva e aceita o ID digitado. Se o provedor responder 404 ou 405 em /models, a conexão ainda pode funcionar; teste com uma tarefa curta.
A resposta demora ou retorna 429
O provedor aplicou limite de taxa ou a conta está sem cota. Aguarde, reduza a frequência ou ajuste o plano no painel do provedor.
O modelo não é encontrado
O ID pode ter sido descontinuado ou o modelo pode não estar liberado para a conta. Atualize o modelo no agente e consulte a documentação oficial.
Privacidade e segurança
A chave de API fica no cofre seguro do sistema operacional e não é enviada ao renderer. Ao executar uma tarefa, as instruções do agente e o prompt do turno são enviados ao endpoint do Z.AI; o provedor processa esses dados conforme a política dele. Memórias, arquivos e ferramentas locais continuam no seu computador.