forgeops
Ajuda

FAQ · Como usar a ForgeOps AI

Guia directo: ligar o seu PC/app, quando usar cada bot, créditos e segurança. Sem expor código-fonte nas páginas públicas.

Integração

Como os utilizadores ligam o sistema ao PC

  1. Criar conta em /registo (obrigatório).
  2. Copiar a API key em /conta (mostrada uma vez; pode rodar depois).
  3. Chamar a API a partir do PC, script ou backend — nunca no browser do cliente final com a key embutida.

Exemplo no PC (terminal)

export FORGEOPS_KEY='np_sua_chave'
export FORGEOPS_URL='https://forgeops-ai.com'

curl -sS -H "Authorization: Bearer $FORGEOPS_KEY" \
  "$FORGEOPS_URL/v1/me" | jq .

curl -sS -H "Authorization: Bearer $FORGEOPS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello from my PC"}' \
  "$FORGEOPS_URL/v1/pops/chat" | jq .

curl -sS -H "Authorization: Bearer $FORGEOPS_KEY" \
  "$FORGEOPS_URL/v1/nexus/tasks?limit=5" | jq .

curl -sS -H "Authorization: Bearer $FORGEOPS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"status"}' \
  "$FORGEOPS_URL/v1/jarvis/session" | jq .

Variáveis no seu projecto

# .env (server / PC — do not commit keys)
FORGEOPS_API_KEY=np_...
FORGEOPS_BASE_URL=https://forgeops-ai.com

O OpenAPI está em /openapi.json. Para uso rápido no telemóvel/PC sem código: chat web em /app (login).

Guia dos bots

Quando usar cada um

Pops

Pops

Para: perguntas, texto, ideias, suporte multi-idioma.

Onde: /app → Pops · API POST /v1/pops/chat

Crédito: 1 mensagem Pops

Voz UI: mais clara / aguda

Jarvis

Jarvis

Para: orquestrar pedidos, sessões, missões de engenharia.

Onde: /app → Jarvis · API /v1/jarvis/session e /mission

Crédito: 1 sessão / missão

Voz UI: mais grave

Nexus

Nexus

Para: memória, foco e filas de tarefas.

Onde: API GET /v1/nexus/tasks · Ops admin para projectos

Crédito: 1 consulta

Nota: motor de memória/tarefas, não chat livre

Fluxos recomendados

Caminhos típicos

Utilizador final / equipa

  1. Registo → guarda API key
  2. Abre /app e testa Pops/Jarvis
  3. Compra créditos em /conta se o trial acabar

Developer no PC

  1. Guarda key no .env do backend
  2. Integra OpenAPI nos endpoints da sua app
  3. Nunca embute a key em HTML/JS público

Operador / admin

  1. Login em Acesso restrito
  2. Ops Compose: escolhe projecto, missão, voz
  3. Escrita só com confirmação explícita

Segurança

  1. Keys só no servidor
  2. Rodar key se vazar
  3. Páginas públicas não mostram código-fonte
FAQ

Perguntas frequentes

Como ligo o ForgeOps ao meu PC?

Conta + API key + curl/SDK no seu ambiente. Veja a secção Ligar o PC.

Qual a diferença entre Pops e Jarvis?

Pops = conversa LLM. Jarvis = orquestra e decide (sessões/missões). Use Pops para texto; Jarvis para “faz / analisa / planeia”.

O Nexus fala comigo?

Nexus não é um chat livre: devolve memória/tarefas. Consulte via API ou veja o estado no Ops (admin).

Posso usar sem criar conta?

Não para chat e serviços metered. Páginas públicas (preços, docs, FAQ, privacidade) são abertas.

Como funciona multi-idioma?

Escolha o idioma no topo (PT/EN/ES/FR/DE/IT). O chat responde no idioma do pedido / preferência da conta.

Onde vejo créditos e facturas?

Em /conta: saldos, ledger e compra de planos. Preços públicos em /precos.

Os meus secrets ficam seguros?

API keys são hasheadas; palavras-passe com hash; HTTPS; cookies HttpOnly. Não publicamos código-fonte nas páginas abertas.

Groq é obrigatório?

Não. A plataforma prefere motores locais; cloud (incl. Groq) é fallback de último recurso na configuração do operador.

Quanto custa o ForgeOps AI?

Trial grátis com créditos iniciais. Starter €29 (500 msgs Pops, 100 Nexus, 200 Jarvis). Pro €79 (5000 / 1000 / 2000). Detalhe em /precos; compra em /conta via Stripe.

Quando recebo créditos após pagar?

Após o Payment Link Stripe, o webhook checkout.session.completed credita a conta. Volte a /conta?checkout=success — o ledger mostra o top-up.

ForgeOps AI é o mesmo que forgeops.io ou ForgedOps construção?

Não. forgeops-ai.com é o gateway SaaS Jarvis · Nexus · Pops (créditos + API + Ops). Não é o tooling OpenClaw nem software de construção civil.

ForgeOps AI — Chat · Memória · Automações · API metered. Preços Privacidade Termos Cookies FAQ Soluções ForgeOps Acesso restrito © ForgeOps AI