LangChain 에이전트의 반복되는 버그를 막기 위해 공유 메모리 도구를 만들었습니다
I kept rediscovering the same bugs across my LC agents, so I built shared memory for this
핵심 요약
LangChain 에이전트 개발 시 반복되는 버그를 방지하고자, 실패 사례를 공유하고 배포 전 자동으로 검사하는 'NaN Mesh'를 개발했습니다.
- 공유 메모리 도구 — 에이전트 간 실패 사례를 공유하여 동일한 버그 재발을 방지함.
- CI 통합 기능 — GitHub Action을 통해 배포 전 패키지 설정과 잠재적 오류를 자동으로 검사함.
- 오픈 API 제공 — 에이전트 실행 보고서와 실패 모드를 외부에서 조회할 수 있는 API를 지원함.
- 개발자 피드백 모집 — 실제 리포지토리에 적용해 볼 LangChain 개발자들의 테스트 참여를 기다림.
에이전트 배포 시 공유 운영 메모리를 기반으로 검증하는 GitHub Action을 만들었습니다.
올해 LangChain 에이전트를 3개 출시했습니다. 그런데 두 번이나 제 에이전트가 token_refresh_loop 버그가 발생하는 환경에서 Auth0 사용을 권장하더군요. 두 번 다 처음부터 다시 문제를 발견해야 했습니다.
이 문제를 해결하기 위해 NaN Mesh를 만들었습니다. 한 에이전트의 실패가 다른 모든 에이전트의 사전 비행 점검(pre-flight check)이 되도록 한 것이죠. 방금 nanmesh-check를 출시했습니다:
- uses: NaNMesh/nanmesh-check@v0
with:
task-type: 'oauth'
submit-execution-report: 'true'
agent-key: ${{ secrets.NANMESH_AGENT_KEY }}
package.json, requirements.txt, mcp-config.json을 읽고 네트워크에 "이 스택의 도구들에 치명적인 오류가 있는가?"라고 묻습니다. 문제가 있다면 CI가 차단됩니다. 깔끔하게 실행되면 보고서를 다시 게시합니다.
API는 열려 있습니다(읽기 권한 필요 없음):
https://api.nanmesh.ai/entities/stripe?format=agent&task_type=subscription_billing
confidence_decomposition, failure_modes, 최근 execution_reports를 반환합니다.
- Python SDK:
pip install nanmesh-memory==0.4.0 - MCP:
npx nanmesh-mcp@4.2.0
!!! 실제 리포지토리에 이 도구를 적용해 보고 제가 놓친 부분을 알려주실 LangChain 개발자 3분을 찾습니다. DM이나 댓글 남겨주세요 — 연동을 도와드리겠습니다.
