reflectionbeam.org
pt

Agentes

Configurações para agentes de programação

Escolha seu agente e as opções para obter o comando de instalação, os arquivos de configuração e uma verificação de que o agente realmente está usando Beam. Baseado no guia de início rápido da Reflection para agentes de programação.

OpenCode
Agente
Nível de raciocínio padrão
Local da configuração
Agente de terminal de código aberto, testado pela Reflection com OpenCode 1.18.34. interleaved.field instrui o agente a enviar reasoning_content de volta. Mantenha "model" na configuração, ou o OpenCode pode iniciar usando o modelo de outro provedor.

  1. Instalar

    bash
    curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai

  2. Configurar

    Terminal
    export REFLECTION_API_KEY="<your API key>"

# Check the key: the list should include Beam-501B-A23B
curl https://api.reflection.ai/openai/v1/models -H "Authorization: Bearer $REFLECTION_API_KEY"
    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "reflection": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Reflection",
      "options": {
        "baseURL": "https://api.reflection.ai/openai/v1",
        "apiKey": "{env:REFLECTION_API_KEY}"
      },
      "models": {
        "Beam-501B-A23B": {
          "name": "Beam-501B-A23B",
          "modalities": {
            "input": [
              "text"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 262144,
            "output": 131072
          },
          "reasoning": true,
          "interleaved": {
            "field": "reasoning_content"
          },
          "variants": {
            "xhigh": {
              "reasoningEffort": "xhigh"
            },
            "max": {
              "reasoningEffort": "max"
            }
          }
        }
      }
    }
  },
  "model": "reflection/Beam-501B-A23B",
  "permission": {
    "bash": "ask",
    "edit": "ask"
  }
}

  3. Verificar o modelo

    bash
    opencode models reflection
# prints: reflection/Beam-501B-A23B

  4. Executar

    bash
    cd your-project
opencode
# one-shot: opencode run --variant high "<prompt>" </dev/null

Problemas conhecidos

400: Parâmetro obrigatório reasoning_content ausente

A sessão enviou de volta uma etapa assistant sem o raciocínio. Inicie uma nova sessão (/new ou execute opencode run sem -c). No Hermes, verifique se model.reasoning_echo é true.

O agente usa um modelo diferente

Confira o nome do modelo que o agente exibe ao iniciar. No Mirror, execute /model reflection; no Pi e no OpenCode, confira o provedor e o modelo padrão na configuração.

404 ou modelo não encontrado

A URL base deve terminar em /openai/v1, sem nada depois, e o ID do modelo deve ser exatamente Beam-501B-A23B.

Longas pausas antes da resposta

Beam raciocina antes de responder, e tarefas grandes podem levar um tempo. Se ocorrerem repetidamente erros 502 ou 503, tente novamente.

Fonte: developers.reflection.ai/coding-agents-quickstart