콘텐츠로 이동

obs-agent-connector 명령 참조

이 문서에서는 obs-agent-connector가 지원하는 에이전트, 일반 명령, 그리고 명령줄 매개변수를 빠르게 참조할 수 있도록 정리합니다.

지원되는 에이전트

obs-agent-connector agents를 실행하면 현재 커넥터가 지원하는 유형과 운영 체제를 확인할 수 있습니다. 이 목록은 Agent 모니터링 페이지의 유형 목록과 용도가 다릅니다. OpenTelemetry로 수동 연동하는 프레임워크는 새 Agent 모니터링 애플리케이션 생성을 참조하세요.

Agent 식별자 제품 이름 통합 방식 macOS Linux Windows 설명
claude Claude Code obs-agent-connector 내장 ✅ ✅ ✅ Stop / SessionEnd Hook 어댑터 사용
codebuddy CodeBuddy obs-agent-connector 내장 ✅ ✅ ✅ Stop / SessionEnd Hook 및 네이티브 index.json 리플레이를 지원하며, Linux x64는 제품 검증을 완료했습니다.
codex Codex obs-agent-connector 내장 ✅ ✅ ✅ Stop Hook 어댑터를 사용하며 Codex 신뢰 및 구성 처리 기능을 내장합니다.
cursor Cursor obs-agent-connector 내장 ✅ ✅ ✅ ~/.cursor를 감지하고 cursor-agent를 우선 사용하며 사용자 수준 Cursor Hooks를 관리합니다.
dsh DeepSeek Harness dsh-otel-plugin ✅ ✅ ✅ DeepSeek Harness 구성 패키지 사용
hermes Hermes hermes-otel-plugin ✅ ✅ ❌ Hermes 플러그인 사용
mimo mimo opencode-otel-plugin ✅ ✅ ✅ mimo 구성 디렉터리의 OpenCode 호환 플러그인 사용
opencode OpenCode opencode-otel-plugin ✅ ✅ ✅ ~/.config/opencode 아래의 OpenCode 구성 디렉터리 사용
openclaw OpenClaw openclaw-otel-plugin ✅ ✅ ✅ OpenClaw 플러그인 사용
qoder Qoder qoder-otel-plugin ✅ ✅ ✅ 중국 버전 또는 국제 버전 디렉터리를 자동으로 식별하고 그에 맞는 --variant 매개변수를 전달합니다.
workbuddy WorkBuddy workbuddy-otel-plugin ✅ ❌ ✅ 감지된 WorkBuddy 구성 디렉터리를 사용하고 해당 디렉터리에 gtrace.json을 기록합니다.

Agent 설명

Agent 식별자 설명
claude 내장 어댑터를 사용하며 관리형 런타임 구성을 ~/.obs-agent-connector/claude/에 기록합니다.
codebuddy 내장 어댑터를 사용합니다. 커넥터가 ~/.codebuddy/settings.json의 Hook 구성을 관리합니다.
cursor 내장 어댑터를 사용하며, 로컬 Cursor CLI를 감지하고 사용 가능한 경우 cursor-agent를 우선 사용합니다.
dsh PATH에 dsh 실행 파일이 있거나 ~/.dsh 디렉터리가 있으면 발견됩니다. 기본 구성은 web이며, 런타임 구성은 dsh-otel-plugin이 생성합니다.
mimo ~/.config/mimocode 아래의 구성을 사용하며, 플러그인은 해당 디렉터리의 plugins/opencode-otel-plugin에 있습니다. 연동 후 obs-agent-connector status mimo로 플러그인 상태를 확인할 수 있습니다.
qoder 국제 버전 또는 중국 버전 디렉터리를 자동으로 감지하고 해당 variant를 사용합니다.
qoder-cn 이전 버전과 호환되는 에이전트 식별자로, 항상 중국 버전 디렉터리를 사용합니다.
hermes Hermes는 YAML 구성을 사용하며 현재 지원되는 JSON 구성 구조에 포함되지 않으므로 CLI가 런타임 활성화 또는 비활성화 상태를 관리하지 않습니다.
openclaw ~/.openclaw/openclaw.json을 통해 런타임을 활성화하거나 비활성화할 수 있습니다. 플러그인이 자체적으로 비공개 구성 구조를 관리하므로 현재 config <agent>는 지원하지 않습니다.
workbuddy macOS와 Windows를 지원하며, 현재 Linux는 지원하지 않습니다.

일반 명령

obs-agent-connector list
obs-agent-connector status <agent>
obs-agent-connector discover
obs-agent-connector discover -u
obs-agent-connector install <agent>
obs-agent-connector config <agent> list
obs-agent-connector config <agent> edit --enabled=false --endpoint=<Endpoint>
obs-agent-connector update <agent>
obs-agent-connector enable <agent>
obs-agent-connector disable <agent>
obs-agent-connector remove <agent>
obs-agent-connector uninstall
obs-agent-connector version
obs-agent-connector version -u

일반 매개변수

공통 설치 매개변수

install <agent>를 실행할 때 사용하는 일반 매개변수는 다음과 같습니다.

매개변수 설명
--endpoint OBS / GTrace 데이터 수신 주소(예: <Endpoint>)
--x-token 데이터 전송에 사용되는 인증 토큰
--agent-id 자동 생성된 agent_id를 재정의합니다.
--agent-name 자동 생성된 agent_name을 재정의합니다.
--static-base 이번 설치에 사용할 기본 주소를 재정의합니다. 외부 오픈소스 플러그인은 <static-base>/agent_plugins에서 가져옵니다.
--yes 확인 단계 건너뛰기
--dry-run 실행 계획과 명령 미리 보기만 출력하고 실제 변경은 수행하지 않습니다.

기본 ID 정보 생성 규칙:

  • --agent-id를 지정하지 않으면 CLI가 agid_<하이픈이 없는 uuidv4>를 자동 생성합니다.
  • --agent-name을 지정하지 않으면 CLI가 <hostname>_<agent>_<YYYYMMDD>를 자동 생성합니다.

외부 플러그인 호출 규칙:

  • 커넥터는 플러그인에 공통 버전, --type gtrace, Endpoint, Token, 태그, 그리고 구성 또는 variant 매개변수만 전달합니다.
  • 플러그인 설치 프로그램은 압축 패키지 다운로드, 체크섬 및 검증, 플러그인 등록, 비공개 런타임 구성을 직접 처리합니다.
  • 커넥터는 --source를 전달하지 않으며 외부 플러그인의 비공개 gtrace.json을 읽거나 쓰지 않습니다.

내장 어댑터 설치 매개변수

다음 매개변수는 내장 claude, codebuddy, codex, cursor 어댑터에 적용됩니다.

매개변수 설명
--trace-path Trace 데이터 전송 경로를 재정의합니다.
--metrics-path Metrics 데이터 전송 경로를 재정의합니다.
--header HTTP 요청 헤더를 추가합니다. 반복 사용할 수 있습니다.
--tag 리소스 속성을 추가합니다. 반복 사용할 수 있습니다.
--capture-content 콘텐츠 수집 모드. 값은 none, preview, full 중에서 선택할 수 있습니다.
--max-chars 수집 콘텐츠의 최대 문자 수
--enable 런타임 구성을 enabled=true로 설정합니다.
--disable 런타임 구성을 enabled=false로 설정합니다.

CodeBuddy의 구성은 기존 ~/.codebuddy/gtrace.json에 병합되어 기록되며, 인식할 수 없는 필드는 삭제되지 않습니다.

discover 매개변수

매개변수 설명
-u 설치된 플러그인을 업데이트하고, 발견되었지만 아직 설치되지 않은 플러그인을 설치합니다.
--endpoint 이번 실행에서 사용하는 저장된 Endpoint를 재정의합니다.
--x-token 이번 실행에서 사용하는 저장된 Token을 재정의합니다.
--yes 확인 단계 건너뛰기
--dry-run 발견, 설치, 업데이트 계획만 출력합니다.

update 매개변수

매개변수 설명
--static-base 플러그인 다운로드 기본 주소를 재정의합니다.
--yes 확인 단계 건너뛰기
--dry-run 업데이트 계획만 출력합니다.

사용 설명:

  • update는 한 번에 하나의 에이전트만 허용합니다.
  • update claude, update codebuddy, update codex, update cursor는 내장 Hook을 다시 조정합니다.
  • 외부 플러그인을 업데이트할 때 현재 런타임 구성이 유지됩니다.

enable 및 disable 매개변수

매개변수 설명
--dry-run 구성 변경 사항만 출력하고 구성 파일에는 기록하지 않습니다.

현재 JSON 구성을 통해 런타임을 활성화하거나 비활성화할 수 있는 에이전트:

  • claude
  • codebuddy
  • codex
  • cursor
  • dsh
  • opencode
  • openclaw
  • qoder
  • workbuddy

remove 매개변수

매개변수 설명
--yes 확인 단계 건너뛰기
--dry-run 제거 계획만 출력합니다.
--purge-config 런타임 구성도 함께 삭제합니다. CodeBuddy의 경우 데이터 전송 상태도 삭제합니다.

version 매개변수

매개변수 설명
-u 커넥터를 최신 버전으로 업데이트합니다.
--offline 원격 버전을 확인하지 않고 로컬 버전만 표시합니다.

설치 스크립트 매개변수

install.sh

매개변수 설명
--version 지정된 버전의 커넥터를 설치합니다. 기본값은 latest입니다.
--install-dir 커넥터 바이너리 파일의 설치 디렉터리
--config-dir 커넥터 구성 디렉터리
--download-base-url 커넥터 설치 패키지 및 메타데이터의 다운로드 기본 주소
--endpoint OBS / GTrace 데이터 수신 주소
--x-token 인증 토큰
--plugin-source 플러그인 소스. 현재 oss 또는 github를 지원합니다.
--plugin-base-url 외부 플러그인 다운로드 기본 주소
--binary-only 커넥터 바이너리 파일만 업데이트하고 config.json에는 기록하지 않습니다.

install.ps1

매개변수 설명
-Version 지정된 버전의 커넥터를 설치합니다. 기본값은 latest입니다.
-InstallDir 커넥터 바이너리 파일의 설치 디렉터리
-ConfigDir 커넥터 구성 디렉터리
-DownloadBaseUrl 커넥터 설치 패키지 및 메타데이터의 다운로드 기본 주소
-Endpoint OBS / GTrace 데이터 수신 주소
-XToken 인증 토큰
-PluginSource 플러그인 소스. 현재 oss 또는 github를 지원합니다.
-PluginBaseUrl 외부 플러그인 다운로드 기본 주소
-BinaryOnly 커넥터 바이너리 파일만 업데이트하고 config.json에는 기록하지 않습니다.
-NoPathUpdate 사용자의 PATH 환경 변수를 업데이트하지 않습니다.

사용 예시

내장 CodeBuddy 어댑터 설치:

obs-agent-connector install codebuddy --yes

지정된 Endpoint와 Token을 사용하여 외부 플러그인 설치:

obs-agent-connector install dsh \
  --endpoint <Endpoint> \
  --x-token <X-Token> \
  --yes

모든 에이전트를 발견하고 설치된 플러그인 동기화:

obs-agent-connector discover -u --yes

플러그인을 제거하되 구성은 유지:

obs-agent-connector remove codex --yes

커넥터 업데이트:

obs-agent-connector version -u

문서 평가

이 페이지가 도움이 되었나요?