reflectionbeam.org
it

Agenti

Configurazioni per agenti di coding

Scegli l’agente e le opzioni per ottenere il comando di installazione, i file di configurazione e una verifica che l’agente usi davvero Beam. Basato sulla guida rapida di Reflection per gli agenti di coding.

OpenCode
Agente
Livello di ragionamento predefinito
Percorso di configurazione
Agente terminale open source, testato da Reflection con OpenCode 1.18.34. interleaved.field indica di inviare reasoning_content nelle risposte successive. Mantieni "model" nella configurazione, altrimenti OpenCode potrebbe avviarsi con il modello di un altro provider.

  1. Installa

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

  2. Configura

    Terminale
    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. Verifica il modello

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

  4. Esegui

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

Problemi noti

400: parametro obbligatorio reasoning_content mancante

La sessione ha restituito un passaggio assistant senza il relativo ragionamento. Avvia una nuova sessione (/new oppure opencode run senza -c). In Hermes, verifica che model.reasoning_echo sia true.

L’agente usa un modello diverso

Controlla il nome del modello stampato dall’agente all’avvio. In Mirror, esegui /model reflection; in Pi e OpenCode, controlla il provider e il modello predefiniti nella configurazione.

404 o modello non trovato

L’URL di base deve terminare con /openai/v1, senza altro dopo, e l’ID del modello deve essere esattamente Beam-501B-A23B.

Lunghe pause prima della risposta

Beam ragiona prima di rispondere e le attività complesse possono richiedere un po’ di tempo. Se ricevi ripetutamente errori 502 o 503, riprova l’attività.

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