Compatível com OpenAI

Use Hermes Agent com IteraCompute

Conecte um agente de terminal à IteraCompute.

Conecte-se em três etapas

1. Crie uma chave API

Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.

2. Configure o URL base

Configure um provedor personalizado nomeado com chat_completions. Python AIAgent e CLI usam perfis separados.

3. Selecione o modelo

Use o ID do modelo de API exato para o modelo escolhido.Verifique seu contexto e recursos antes de ativar recursos de agente ou visão.

Escolha seu modelo

DeepSeek V4.1 Flash 1017 é o modelo pago de referência. Você pode substituí-lo por um modelo de conversa publicado permitido pela chave. Confira permissões, preços, contexto e ferramentas após a troca. Os exemplos acompanham a seleção; os resultados preservados continuam vinculados ao Qwen.

Prepare um ambiente isolado

Use um checkout isolado do Hermes Agent v0.23.0 e HERMES_HOME. Exporte ITERACOMPUTE_API_KEY no terminal de inicialização.

Bash / macOS / Linux / WSL
git clone --branch v0.23.0 --depth 1 \
  https://github.com/NousResearch/hermes-agent.git hermes-agent-v0.23.0
cd hermes-agent-v0.23.0
test "$(git rev-parse HEAD)" = \
  "2bd378ed1b8d6bf2192cb26e0a55ff3091e6bd19"
export HERMES_HOME="$PWD/.hermes-iteracompute-cli"
export HERMES_RUNTIME_DIR="$HERMES_HOME/tools"
umask 077
mkdir -p "$HERMES_HOME"
source ./activate
hermes --version
hermes pm doctor
Bash · Chave no terminal atual
umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEY

Hermes CLI pode adicionar reasoning_effort=medium a um modelo personalizado desconhecido. Confira a requisição real com os parâmetros do modelo escolhido. reasoning_config={} é uma opção do construtor Python, não uma configuração YAML nem prova de raciocínio desativado na CLI.

Configuração de exemplo

Mantenha as chaves de API em seu ambiente de servidor ou armazenamento de credenciais de ferramentas.Substitua o campo-chave de exemplo pela sua própria chave, quando aplicável.

CLI · $HERMES_HOME/config.yaml
providers:
  iteracompute:
    api: https://api.iteracompute.com/v1
    key_env: ITERACOMPUTE_API_KEY
    transport: chat_completions
    default_model: deepseek/deepseek-v4.1-flash-1017
    context_length: 1048576
    discover_models: false
    extra_body:
      max_tokens: 512
model:
  provider: custom:iteracompute
  default: deepseek/deepseek-v4.1-flash-1017
  context_length: 1048576
  streaming: false
agent:
  max_turns: 3
  api_max_retries: 0
  auto_recovery_cycles: 0
fallback_providers: []
toolsets: [todo]
tools:
  tool_search:
    enabled: off
approvals:
  mode: manual
compression:
  enabled: false
auxiliary:
  title_generation:
    enabled: false
    model_upgrade_enabled: false

Salve apenas no perfil isolado criado acima. Os exemplos de Chat Completions começam com 512 tokens de saída e sem fallback. Metadados de contexto não concedem direitos à conta; OpenClaw usa um orçamento de entrada menor e Qwen um contexto de conta de 128K. O controle de raciocínio varia: Python e OpenClaw adicionam reasoning: false apenas ao Qwen; não copie a opção para outros modelos.

Verifique primeiro a API direta

Python · Verificação direta de texto
python3 - <<'PY'
import json
import os
import urllib.error
import urllib.request
payload = {
    'model': 'deepseek/deepseek-v4.1-flash-1017',
    'messages': [{'role': 'user', 'content': 'Reply with exactly: ITERACOMPUTE_API_OK'}],
    'max_tokens': 512,
    **{},
}
request = urllib.request.Request(
    'https://api.iteracompute.com/v1/chat/completions',
    data=json.dumps(payload).encode('utf-8'),
    headers={'Authorization': 'Bearer ' + os.environ['ITERACOMPUTE_API_KEY'],
             'Content-Type': 'application/json'}, method='POST',
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as exc:
    raise SystemExit(f'HTTP {exc.code}; inspect redacted details privately') from None
except (urllib.error.URLError, TimeoutError):
    raise SystemExit('Network or timeout failure; no automatic retry') from None
choice = result['choices'][0]
if ((choice.get('message', {}).get('content') or '').strip() != 'ITERACOMPUTE_API_OK'
        or choice.get('finish_reason') != 'stop'):
    raise SystemExit('FAIL: expected final marker and stop reason not returned')
print('Direct API text passed; test the agent separately')
PY

Ao executar, envia uma requisição real. Confirme o marcador visível exato e finish_reason=stop; HTTP 200 sem texto é incompleto. Modelos pagos consomem saldo API. Não repita automaticamente uma operação de resultado desconhecido.

Verifique a rota de texto do agente

Bash · Verificação de texto
hermes chat --oneshot --ignore-rules --toolsets todo --max-turns 2 \
  --format stream-json \
  -q 'Do not call tools. Reply with exactly: HERMES_ITERACOMPUTE_OK' \
  > hermes-text.private.jsonl 2> hermes-text.private.stderr

Execute primeiro a verificação direta da API abaixo. Exija um marcador final não vazio, o provider/model esperado e a saída correta do agente. Validar configuração ou executar uma sondagem não comprova um fluxo de agente ou ferramentas.

Verifique um ciclo de ferramenta

O perfil CLI acima é uma referência documental. Para Python, crie outro HERMES_HOME no checkout ativado, salve ali config.yaml e o script como iteracompute_agent_smoke.py. Não combine os perfis.

Bash · Perfil Python separado
export HERMES_HOME="$PWD/.hermes-iteracompute-python"
mkdir -p "$HERMES_HOME"
Perfil Python · config.yaml
model:
  provider: custom
  default: deepseek/deepseek-v4.1-flash-1017
  base_url: https://api.iteracompute.com/v1
  streaming: false
providers:
  custom:
    request_timeout_seconds: 240
    stale_timeout_seconds: 240
tools:
  tool_search:
    enabled: off
agent:
  api_max_retries: 0
  auto_recovery_cycles: 0
fallback_providers: []
compression:
  enabled: false
auxiliary:
  title_generation:
    enabled: false
    model_upgrade_enabled: false
iteracompute_agent_smoke.py
import os
from run_agent import AIAgent

agent = AIAgent(
    provider="custom",
    api_mode="chat_completions",
    base_url="https://api.iteracompute.com/v1",
    api_key=os.environ["ITERACOMPUTE_API_KEY"],
    model="deepseek/deepseek-v4.1-flash-1017",
    enabled_toolsets=["todo"],
    max_iterations=3,
    max_tokens=512,
    run_budget_seconds=600,
    reasoning_config={},
    request_overrides={"extra_body": {}},
    skip_context_files=True,
    skip_memory=True,
    skip_background_review=True,
    load_soul_identity=False,
    save_trajectories=False,
    quiet_mode=True,
    fallback_model={},
)
try:
    result = agent.run_conversation(
        "Call todo_list exactly once to write one item with id smoke-1, "
        "content API smoke test, and status completed. Then read the tool result "
        "and reply with exactly HERMES_ITERACOMPUTE_TOOL_OK. Do not use other tools."
    )
    if not (result.get("completed") is True and
            (result.get("final_response") or "").strip() == "HERMES_ITERACOMPUTE_TOOL_OK"):
        raise SystemExit("FAIL: inspect redacted details privately")
    print("Final marker passed; verify actual todo_list events separately")
finally:
    agent.close()
Bash · Executar agente Python
python iteracompute_agent_smoke.py

Critério de sucesso: inspecione a chamada real a todo_list, o item smoke-1 concluído, o resultado retornado e a resposta final HERMES_ITERACOMPUTE_TOOL_OK. O script verifica apenas o marcador final; examine os eventos de ferramentas separadamente. Três iterações e zero tentativas configuradas não limitam estritamente requisições HTTP nem gastos.

Versão e verificação

Versão testada
Hermes Agent v0.23.0
Resultado
Chamadas de ferramentas Python sem streaming aprovadas.

Credenciais, ferramentas e dados

A API do modelo é remota; não exige GPU local nem porta pública de Gateway. O agente precisa de CPU, memória e permissões locais. Mantenha as chaves no ambiente do processo e os logs originais privados; habilite apenas as ferramentas necessárias. Serviços externos têm configuração e custos próprios.

Teste a conexão

cURL · Conclusões de bate-papo
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4.1-flash-1017","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Verifique se choices[0].message.content contém texto visível;O HTTP 200 por si só é insuficiente.O raciocínio pode consumir o orçamento de produção.Para Qwen grátis, use o exemplo da primeira chamada gratuita à API para desativar o pensamento e envie um prompt dentro de sua ferramenta.

Capacidades do modelo selecionado

As capacidades descrevem a API da IteraCompute. A disponibilidade também depende da ferramenta e de suas configurações; os controles de raciocínio variam por modelo.

  • Conclusões de bate-papoSuportado
  • Chamada de ferramentaSuportado
  • RaciocínioSuportado
  • Entrada de imagemSuportado
  • TransmissãoSuportado

Solução de problemas

401 / 403 / 404

Confira a chave do processo, a permissão do modelo e o saldo pago. Inclua /v1 uma única vez na URL base. Envie o Model ID original à API; o prefixo iteracompute/ serve apenas ao roteamento do OpenClaw.

400 / Resposta vazia / 429

Confira os parâmetros de raciocínio do modelo, o orçamento de saída e os limites da conta. Respeite Retry-After. Não misture formatos de raciocínio, não deduza sucesso de HTTP 200 nem alterne automaticamente para outro modelo pago.

Ferramenta ausente / Perfil incorreto

Hermes: desative tool_search no teste de todo e separe os perfis Python e CLI. OpenClaw: substitua deny-all por somente leitura no teste de ferramentas; não use --isolated nem --auth-env-only com esta configuração.

Referência de configuração do Hermes Agent →

Comece a criar com Hermes Agent.

Conecte sua chave, escolha um modelo e envie sua primeira solicitação.