기술 기반 · 구성요소 ② · 부품(Utilities)

pip로 끼우는
검증된 공통 부품

standarda-core는 LLM 연동·구글 API·문서 판독처럼 어느 AX 프로젝트에나 필요한 기능을 검증된 부품으로 묶어둔 패키지입니다. pip 한 번으로 장착하고, 한 곳에 부품을 개선하면 모든 프로젝트가 즉시 그 개선을 물려받습니다.

🧩 검증된 공통 부품 📌 버전 태그 고정 설치 ♻️ 한 번 개선 → 전체 반영
v0.18현재 배포 버전 (지속 확장)
LLM 5종Claude·OpenAI·Gemini·OpenRouter·임베딩
구글 APIGmail·Sheets·Drive·Docs 클라이언트
문서 판독PDF·Excel Vision + 텍스트 추출
비유 · 자동차 부품

엔진·바퀴를 매번 새로 깎지 않습니다

자동차 회사가 검증된 엔진·변속기·전장 부품을 여러 차종에 공용으로 쓰듯, 브리도 LLM 호출·구글 API·문서 판독 같은 핵심 부품을 한 번 잘 만들어 모든 프로젝트에서 재사용합니다. 부품을 한 곳에서 개선하면, 그 부품을 쓰는 모든 차(프로젝트)가 함께 좋아집니다.

  • 검증된 부품을 재사용 → 같은 버그를 두 번 만들지 않음
  • 버전을 태그로 고정 → 프로젝트마다 안전하게 관리
  • 새 LLM·새 기능이 나와도 부품만 교체하면 전체 적용
자동차 부품 일러스트 — standarda-core
standarda-core = 프로젝트에 끼우는 검증된 공통 부품
The Parts

안에 들어있는 부품들

AX 에이전트가 반복적으로 필요로 하는 기능을, 검증된 형태로 모아두었습니다.

🤖

LLM 통합

Claude·OpenAI·Gemini·OpenRouter를 환경변수 전환으로 오가고, OpenAI 임베딩까지 지원. 코드 변경 없이 모델을 바꿉니다.

💸

캐싱 · 비용 추적

프롬프트 캐시 제어와 토큰 사용량 누적·비용 추정으로, LLM 호출 비용을 줄이고 투명하게 관리합니다.

🔁

에이전트 툴 루프

LangGraph 기반 툴 실행 루프 — 에이전트가 도구를 순차 호출하는 표준 흐름을 부품으로 제공.

📮

구글 API 클라이언트

Gmail·Sheets·Drive·Docs 클라이언트와 표준 인증. 고객의 구글 워크스페이스에 안전하게 연결.

📄

문서 판독

PDF·Excel을 Vision으로 분석하거나 텍스트로 추출. 서류에서 필요한 값을 구조화해 뽑아냅니다.

🧾

응답 파싱

LLM 응답을 안정적인 JSON으로 파싱하는 유틸 — 자동화 파이프라인이 깨지지 않게 지탱합니다.

원칙 ①

단일 진실 소스

같은 기능은 한 곳에만 존재. 여기서 고치면 모든 프로젝트에 반영됩니다.

원칙 ②

표준 인증

구글·LLM 인증을 표준화된 방식으로 — 프로젝트마다 인증을 재발명하지 않습니다.

원칙 ③

Vision-First

레이아웃이 복잡한 서류는 OCR 대신 Vision으로 이해해 정확도를 높입니다.

How It Works

부품을 끼우고, 함께 개선한다

버전을 태그로 고정해 설치하고, 부품이 좋아지면 태그만 올려 전체에 반영합니다.

STEP 1

버전 고정 설치

프로젝트는 특정 버전 태그(예: @v0.18.0)로 부품을 설치 — 의도치 않은 변경 전파를 막습니다.

STEP 2

부품 개선

새 기능·버그 수정은 core에 한 번만. 리뷰(PR)를 거쳐 새 버전 태그로 배포됩니다.

STEP 3

전체 반영

각 프로젝트가 태그를 올리면, 개선된 부품이 모든 케이스에 안전하게 퍼집니다.

Python 패키지 (pip) git 태그 고정 설치 Claude (Anthropic) OpenAI · Gemini · OpenRouter LangChain · LangGraph Gmail · Sheets · Drive · Docs API Vision 문서 판독 토큰 비용 추적
Explore More

기술 기반 둘러보기