에이전트

코딩 에이전트 설정

에이전트와 옵션을 선택하면 설치 명령, 설정 파일, 에이전트가 실제로 Beam을 사용하는지 확인하는 방법을 확인할 수 있습니다. Reflection의 코딩 에이전트 빠른 시작을 바탕으로 작성했습니다.

OpenCode

에이전트

기본 추론 강도

설정 위치

최대 131,072토큰 출력 허용도구 실행 전 확인

Reflection에서 테스트한 오픈소스 터미널 에이전트(OpenCode 1.18.34)입니다. interleaved.field는 reasoning_content를 다시 전송하도록 설정합니다. 설정에 "model"을 그대로 두세요. 그렇지 않으면 OpenCode가 다른 제공자의 모델로 시작할 수 있습니다.

설치

bash

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

설정

터미널

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"
  }
}

모델 확인

bash

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

실행

bash

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

알려진 문제

400: 필수 매개변수 reasoning_content가 누락되었습니다

세션에서 추론이 포함되지 않은 assistant 단계를 다시 전송했습니다. 새 세션을 시작하세요(/new를 사용하거나 opencode run을 -c 없이 실행). Hermes에서는 model.reasoning_echo가 true인지 확인하세요.

에이전트가 다른 모델을 사용함

에이전트가 시작할 때 표시하는 모델 이름을 확인하세요. Mirror에서는 /model reflection을 실행하고, Pi와 OpenCode에서는 설정에서 기본 provider와 모델을 확인하세요.

404 또는 모델을 찾을 수 없음

base URL은 뒤에 아무것도 붙이지 않고 /openai/v1로 끝나야 하며, 모델 ID는 정확히 Beam-501B-A23B여야 합니다.

응답이 나오기까지 오래 걸림

Beam은 답변하기 전에 추론하며, 작업이 복잡하면 시간이 오래 걸릴 수 있습니다. 502 또는 503 오류가 반복되면 작업을 다시 시도하세요.

소스: developers.reflection.ai/coding-agents-quickstart