Skip to content
This repository was archived by the owner on Jul 25, 2026. It is now read-only.
This repository was archived by the owner on Jul 25, 2026. It is now read-only.

feat: Raw data readers를 LangGraph 에이전트 도구로 노출 #52

Open

Description

@jongphago

배경

readers/로 DB·GCS에 적재된 GitHub Raw data를 1홉 단위로 조회할 수 있게 되었습니다 (#51).
코딩 에이전트가 이 데이터를 쓰려면, readers를 LangGraph가 호출할 수 있는 도구로 감싸야 합니다. 조회 SQL·로직은 readers에 두고, LangGraph 쪽은 도구 정의·입출력·설명만 담당합니다.

목적

에이전트가 자연어 질의로 이슈 → PR → 커밋 → 변경 파일 → 헝크 → 심볼 등을, GitHub API 없이 도구 호출만으로 단계별 탐색할 수 있게 한다.

범위

  • readers 1홉 조회를 LangGraph/LangChain 도구 1개씩 매핑 (다홉 통합 도구 없음)
  • 도구 입력·JSON 출력·docstring(언제 쓸지, 다음 단계 힌트)
  • NotFound·빈 목록을 에이전트가 해석 가능한 응답으로 변환
  • LangGraph 의존성은 optional group; 예시 그래프·스모크 1종
  • 단위 테스트 및 readers vs tools 역할 문서 보강

수용 기준

  • #49 엔티티×기능 표의 조회 능력이 도구로 대응됨
  • 에이전트가 도구를 여러 번 조합해 탐색 경로를 완성할 수 있음
  • 기본 CI pytest는 유지됨

범위 외

  • readers 1홉 API 변경, GitHub API fallback, 한 번에 끝까지 조회하는 mega-tool, agent_chat 도구

브랜치 정책

dev에서 분기, PR은 dev 대상.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions