MakionDocs ← makion.dev

Motores de IA e início de sessão

Cada projeto corre sobre um motor de IA — o modelo que alimenta o agente. Um administrador escolhe o motor por projeto e autentica-o uma vez. Todo o objetivo do Makion é que você ligue uma subscrição que já tem em vez de pagar por token — consulte What is Makion. Os motores são configurados na tabela AI engines do separador Admin.

Escolher um motor por projeto#

Na tabela Projetos do separador Admin, a coluna Motor define que modelo corre nesse projeto: Claude, Gemini, Codex, Kimi ou Grok. Projetos diferentes podem correr sobre motores diferentes. Um motor tem de estar autenticado (abaixo) antes de poder executar tarefas.

Duas formas de autenticar um motor#

Há duas formas de iniciar sessão num motor. Qual delas se aplica depende do motor.

Método Como funciona Que motores
Início de sessão por subscrição Um fluxo de código de dispositivo dentro da aplicação: ligue uma subscrição que já paga, sem faturação por token. Motores que suportam início de sessão dentro da aplicação. O Claude usa o próprio início de sessão do servidor e não precisa de chave de API nenhuma.
Chave de API Cole uma chave de API do fornecedor e guarde-a. Motores que não têm início de sessão dentro da aplicação — autentique com uma chave em vez disso.

O Claude não precisa de chave de API — usa o próprio início de sessão do servidor. Alguns motores autenticam-se por início de sessão por subscrição, outros só por chave de API. A tabela AI engines diz-lhe qual se aplica a cada um.

A tabela AI engines#

A tabela AI engines no separador Admin tem uma linha por motor:

Coluna O que mostra / faz
Motor O nome do motor.
Subscrição O seu estado de subscrição — Ligado ✓ ou Não ligado, com um botão Ligar (subscrição) — ou a nota "sem início de sessão na aplicação — use uma chave de API" para os motores que não o suportam.
Chave de API Se uma chave está definida ou não definida, um campo de palavra-passe para colar uma, e Guardar / Remover. A linha do Claude assinala: "Claude — usa o próprio início de sessão do servidor, sem chave de API necessária."

Início de sessão por subscrição, passo a passo#

Ao clicar em Ligar (subscrição) abre-se um painel de início de sessão por código de dispositivo. Funciona como iniciar sessão numa aplicação de TV numa conta:

  1. Abra este link em qualquer navegador — o painel mostra um link; abra-o num navegador.
  2. Introduza este código nessa página — o painel mostra um código com um botão Copiar. Cole-o na página que acabou de abrir. (Alguns motores mostram, em vez disso, um fluxo de colar código — cola-se um código de volta no painel e clica-se em Submeter código.)
  3. Autorizar — aprove o pedido nessa página. O painel mostra "A aguardar que autorize…".
  4. Concluído — quando o fornecedor confirma, o painel mostra Ligado ✓ e o estado de Subscrição do motor passa para Ligado ✓.

Use Cancelar ou Fechar para dispensar o painel a qualquer momento.

Adicionar uma chave de API#

Para um motor que se autentica por chave, cole-a no campo de palavra-passe Chave de API na linha desse motor e clique em Guardar — o estado muda para definida. Remover limpa-a. Todas as credenciais dos motores vivem no seu próprio servidor on-prem; nada sai dele.

Para onde ir a seguir#