라마인덱스 쿼리엔진은 검색·합성을, 오픈클로 이천이십육 게이트웨이는 도구를 화이트리스트·베어러·이그레스로 묶습니다. 원격 맥 랙을 감사 가능하게 만드는 아티클 겸 하우투입니다.
워크플로·퓨즈·파이던틱 게이트웨이·세션 스폰과 함께 보세요.
리스크. 표 밖 도구명·검색 데드라인 공백·실패 은닉이면 빈근거 답이 납니다.
의존성과 디렉터리 레이아웃
.venv·indexes/·scratch/·tokens/를 나누고 라마인덱스·벡터 클라이언트를 핀합니다. 런치디에 파이썬·임시 경로를 박아 세션마다 동일하게 뜨게 하고 루프백 포트를 한 장 메모에 적습니다.
게이트웨이 토큰과 이그레스 제한
단기 베어러 파일은 권한 육백, 리슨은 칠칠칠칠만, 노트북은 터널·워커는 맥 내부 호출로 고정합니다. 외부 호출은 게이트가 허용한 호스트만 나가게 프로필을 좁히세요. 팀 대시보드에서 만료를 추적합니다.
책임 한 장
| 층 | 소유 | 대표 신호 |
|---|---|---|
| 인덱스 | 라마인덱스 | 청크 배치 임베딩 캐시 |
| 게이트웨이 | 오픈클로 | 베어러 라우트 화이트리스트 |
| 퓨즈 | 검색 래퍼 | 비동기 데드라인 |
| 서킷 | 연속 실패 창 | 쿨다운 스킵 |
| 봉투 | 합성기 컨텍스트 | 단계 힌트만 |
QueryEngine 연동 코드 단계
검색기 비동기 래퍼에 상한을 걸고 연속 실패 시 서킷으로 벡터 재시도를 막습니다. 펑션 도구 유알엘은 게이트 프리픽스만 쓰고 예외는 짧은 필드 묶음으로 합성기에 넘깁니다.
export LLAMA_INDEX_RETRIEVAL_TIMEOUT_S=12
export LLAMA_INDEX_RETRIEVAL_BREAKER_THRESHOLD=4
export LLAMA_INDEX_RETRIEVAL_COOLDOWN_S=25
export OPENCLAW_GATEWAY_URL="http://127.0.0.1:8742"
export OPENCLAW_BEARER_FILE="$HOME/tokens/gw.bearer"- 핀된 라마인덱스로 인덱스 빌드 진입점을 하나로 모읍니다.
- 오픈클로 설치 후 닥터로 라우트를 확인하고 베어러 경로를 워커에 주입합니다.
- 검색기에 데드라인·서킷·상관 식별자 로그를 붙입니다.
- 화이트리스트 도구만 등록하고 미등록 이름은 진입 전 차단합니다.
- 합성 프롬프트에 실패 봉투 필드를 조건부 주입합니다.
- 정상·지연·오류 스모크로 봉투에 비밀이 없는지 확인합니다.
로그와 doctor 점검
제이슨엘 한 줄에 시각·상관·라우트·지연·검색 단계를 넣고 청크는 마스킹합니다. 릴리스마다 닥터를 제이슨으로 돌리고 동일 베어러로 헬스를 호출합니다. 부하 소크 때만 메모리 샘플을 찍으세요.
표준값. 검색 십이초·서킷 네 회·쿨다운 이십오초는 출발점이고 한 시간 부하 소크 뒤 좀비 태스크가 없어야 합니다.