reflectionbeam.org
vi

Agent

Cấu hình agent lập trình

Chọn agent và các tùy chọn để nhận lệnh cài đặt, tệp cấu hình và cách kiểm tra xem agent có thực sự dùng Beam hay không. Dựa trên hướng dẫn bắt đầu nhanh dành cho coding agent của Reflection.

OpenCode
Agent
Mức độ suy luận mặc định
Vị trí lưu cấu hình
Agent dòng lệnh mã nguồn mở, được Reflection kiểm thử với OpenCode 1.18.34. interleaved.field yêu cầu agent gửi lại reasoning_content. Giữ nguyên "model" trong cấu hình, nếu không OpenCode có thể khởi chạy bằng mô hình của nhà cung cấp khác.

  1. Cài đặt

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

  2. Cấu hình

    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. Kiểm tra mô hình

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

  4. Chạy

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

Vấn đề đã biết

400: Thiếu tham số bắt buộc reasoning_content

Phiên đã gửi lại một bước assistant mà không có nội dung suy luận. Hãy bắt đầu phiên mới (/new hoặc chạy opencode run mà không có -c). Với Hermes, hãy kiểm tra xem model.reasoning_echo có giá trị true hay không.

Agent đang dùng một mô hình khác

Kiểm tra tên model mà agent in ra khi khởi động. Trong Mirror, chạy /model reflection; trong Pi và OpenCode, kiểm tra provider và model mặc định trong cấu hình.

404 hoặc không tìm thấy model

URL cơ sở phải kết thúc bằng /openai/v1, không có gì theo sau, và ID model phải chính xác là Beam-501B-A23B.

Tạm dừng lâu trước khi có kết quả

Beam suy luận trước khi trả lời, nên các tác vụ lớn có thể mất một lúc. Nếu liên tục gặp lỗi 502 hoặc 503, hãy thử lại tác vụ.

Nguồn: developers.reflection.ai/coding-agents-quickstart