Question 1

SKILL.md가 skills API에서 이름과 설명이 비어 있는 상태로 표시되는 이유는 무엇인가요? (UTF-8 BOM 문제)

Accepted Answer

파일이 "UTF-8 with BOM"으로 저장되었습니다 — Windows 메모장이나 PowerShell 5.1의 `Set-Content -Encoding UTF8`에서 흔히 발생하는 경우입니다. 여는 `---` 펜스 앞에 있는 보이지 않는 BOM 문자(U+FEFF) 때문에 frontmatter 파서가 YAML 블록을 감지하지 못했고, 그 결과 전체 파일이 본문으로 처리되어 name/description이 비어 있는 것으로 표시되었습니다.

수정 사항: 이 문제는 `develop` 브랜치에서 해결되었습니다. 공유 frontmatter 헬퍼(`src/octop/infra/utils/frontmatter.py::parse_frontmatter`)가 이제 `---` 펜스를 검색하기 전에 선행 U+FEFF 하나를 제거하며, skills 라우터(`src/octop/api/routers/skills.py`)는 로컬 `_parse_frontmatter` 대신 이 공유 파서를 사용하도록 통합되었습니다.

이전 버전에서의 해결 방법: SKILL.md를 BOM이 *없는* UTF-8로 다시 저장하거나(예: VS Code에서 상태 표시줄 인코딩 메뉴에서 "UTF-8 with BOM" 대신 "UTF-8" 선택), 파싱 전에 `text.lstrip('\ufeff')`를 사용하여 BOM을 프로그래밍 방식으로 제거하세요.

Question 2

Octop LDAP 오류 'enabling LDAP over ldap:// requires StartTLS; otherwise use an ldaps:// URL' 해결 방법

Accepted Answer

이것은 버그가 아니라 Octop(`infra/auth/ldap/config.py`)의 의도적인 보안 제한입니다: 비밀번호가 평문으로 전송되지 않도록 평문 `ldap://`가 차단되어 있으며, 이를 해제할 수 있는 보안 설정 토글은 없습니다. 해결 방법: 1) Windows AD 도메인 컨트롤러에서 LDAPS를 활성화한 상태로 서버 URL을 `ldaps://`(예: `ldaps://192.168.1.1:636`)로 변경하거나, 2) AD 서버에서 StartTLS를 활성화하고 `ldap://192.168.1.1:389`를 그대로 유지하면서 Octop의 LDAP 설정에서 StartTLS 옵션을 켜십시오. 명시적인 'allow insecure plaintext' 우회 수단이 필요한 경우 기능 요청을 제출해 주십시오.

Question 3

에이전트가 ripgrep 없이 파일시스템 검색을 실행할 때 octop 메모리 오버플로우(OOM)를 해결하는 방법은?

Accepted Answer

이것은 octop 1.0.1 (deepagents 0.7.9)의 알려진 버그입니다: ripgrep (`rg`)이 PATH에 없으면, 범위가 지정되지 않은 grep 검색이 순수 Python 검색으로 폴백되고, 이 검색은 `/`부터 순회하면서 제한 없는 `readline()`으로 `/proc/<pid>/pagemap`과 같은 의사 파일(pseudo-file)을 읽어 호스트 메모리를 고갈시킵니다. 수정 사항 및 완화 방법:

1. **octop v1.0.2+로 업그레이드** — PR #2116에서 수정됨: 공식 이미지에 이제 ripgrep이 포함되며(강제 종료 가능한 서브프로세스 경로), `OctopServer.start()`가 deepagents의 `_python_search`를 패치하여 `/proc`, `/sys`, `/dev`를 건너뛰고 줄당/파일당 읽기 크기를 제한합니다.

2. **컨테이너에 ripgrep 설치** — 정적 `rg` 바이너리를 PATH에 추가하여 Python 폴백이 전혀 사용되지 않도록 합니다.

3. **컨테이너 메모리 제한 설정** — 예: `docker run --memory=4g ...`를 사용하여 커널이 전체 호스트가 아닌 컨테이너만 OOM-kill하도록 합니다.

4. **`backend.root_dir` 제한** — 에이전트 셸에 전체 호스트 파일 시스템에 대한 액세스를 허용하는 기본값 `root_dir='/'`을 피하세요.

Question 4

langgraph Postgres checkpointer에서 psycopg ConnectionPool 사용 시 발생하는 "AdminShutdown: terminating connection due to administrator command" 오류를 해결하는 방법

Accepted Answer

이 오류는 psycopg_pool의 `ConnectionPool`이 기본적으로 `check=None`(liveness 프로브 없음)으로 설정되어 있기 때문에 발생합니다. 따라서 `max_lifetime`(기본값 3600초)에 의한 연결 재활용이 동시 `getconn()` 호출과 겹치면, 종료된 연결이 호출자에게 전달되고 `execute()`가 치명적으로 실패합니다. 해결 방법: 명시적인 liveness 체크와 명시적인 max_lifetime을 사용하여 풀을 생성하세요.

```python
from psycopg_pool import ConnectionPool

def _check_conn(conn):
    conn.execute("SELECT 1")

pool = ConnectionPool(
    conninfo=dsn,
    min_size=1,
    max_size=4,
    check=_check_conn,        # 연결을 전달하기 전에 죽은 연결을 탐지하고 폐기
    max_lifetime=3600,        # 명시적으로 설정; PG/서버 측 타임아웃보다 낮게 맞추는 것을 고려
    kwargs={"autocommit": True, "prepare_threshold": 0, "row_factory": dict_row},
    open=True,
)
```

`check` 콜백은 연결이 전달되기 전에 `SELECT 1`을 실행합니다. 죽은 연결은 감지되어 폐기되고 투명하게 재생성됩니다. 추가적인 강화 조치로, `PostgresSaver`/`get_tuple` execute 경로를 `psycopg.errors.AdminShutdown`(또는 `OperationalError`) 발생 시 재시도하도록 감싸서, 단일 죽은 연결이 작업에 치명적이지 않도록 하세요. 이 문제는 동시 cron과 유사한 워크로드 환경에서 langgraph Postgres 체크포인터 설정을 사용하는 psycopg 3.x / psycopg_pool 3.3.x에 영향을 미칩니다.

Question 5

{"matches":...} 메모리 JSON으로 시작하는 Octop 응답으로 인해 WeChat 전송이 실패하는 문제(ret=-2 prepare failed)를 해결하는 방법은?

Accepted Answer

근본 원인: cron 프롬프트가 에이전트에게 memory_save 호출을 요청하면, 모델은 먼저 MEMORY.md 편집을 시도하다가 FilesystemGuard에 의해 차단된 후, 메모리 도구 체인으로 폴백합니다. 내부 조정 JSON(octop_memory/operations/retention.py의 {"matches":[{"atom_id",...}]})이 메인 대화 컨텍스트로 유입되고, 모델이 최종 응답의 시작 부분에서 이를 그대로 앵무새처럼 반복합니다(glm-5.3-flash 및 glm-4.6에서 재현됨, 모델 무관). 부풀려진 콘텐츠(최대 ~220k자)는 WeChat 채널에 의해 ~2000자 세그먼트로 분할되어, 속도 제한 'ret=-2, errmsg=prepare failed'와 메시지 손실을 유발합니다. 검증된 해결 방법(자체 호스팅): 1) 에이전트 설정에서 "memory_recall_inject_enabled": false로 설정하여, 채널에 atom_id와 리콜 메타데이터를 유출하는 자동 <memory-context> 주입을 비활성화합니다. 2) cron/자동화 프롬프트를 다시 작성하여 memory_* 도구를 사용하지 않도록 하고, 대신 일반 워크스페이스 파일에 기록을 남깁니다(예: dinner-log.md 읽기/쓰기). 두 가지 변경을 적용한 후, 동일한 cron 작업이 깔끔한 출력을 생성합니다(400자 미만의 표준 형식, 단일 세그먼트로 전송). 장기적인 수정을 위해서는 reconcile JSON이 메모리 서비스 내부에 머물고, 리콜 주입이 atom_id 없이 일반 요약 형태로 렌더링되며, 채널 계층이 주입된 블록과 비정상적으로 긴 콘텐츠를 필터링/잘라내도록 해야 합니다.

Octop

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트