kunchenguid/axi

AXI – Agent eXperience Interface

정의 – AXI는 인간이 아닌 AI 에이전트를 위해 구축된 설계 프레임워크이자 구체적인 명령줄 도구 세트입니다. 토큰 효율적인 출력, 최소 스키마, 명시적 빈 상태 등 10가지 '에이전트 인체공학적' 원칙을 정의하고, 이러한 규칙을 따르는 AXI 래핑 CLI(GitHub, Chrome DevTools, AWS, Docker, Notion 등)의 카탈로그를 제공합니다.

중요성 – 대규모 언어 모델 에이전트는 외부 서비스를 호출할 때 엄격한 토큰 예산을 가지고 있습니다. 기존 CLI 및 도구 프로토콜(예: MCP)은 장황하고 대화형 프롬프트가 필요하며 불필요한 JSON 필드에 토큰을 낭비합니다. AXI의 원칙은 데이터를 작고 결정적으로 유지하며 LLM이 파싱하기 쉽게 하여 비용과 지연 시간을 줄이고 신뢰성을 향상시킵니다.

주요 구성 요소

• 10가지 설계 원칙 – 토큰 효율적인 TOON 형식, 작은 기본 스키마, 명시적 빈 결과, 구조화된 오류, 환경 컨텍스트, 콘텐츠 우선 기본값 등.
• AXI 카탈로그 – 기성 AXI 도구의 선별된 목록. 공식 예시는 다음과 같습니다:
  • gh-axi – GitHub CLI의 토큰 효율적인 래퍼.
  • chrome-devtools-axi – Chrome DevTools MCP를 통한 브라우저 자동화.
  • lavish-axi, quota-axi 및 Android, npm, SQLite, Slack, AWS, Docker 등을 위한 많은 커뮤니티 기여 AXI.
• 벤치마크 – README에는 AXI 래핑 도구가 표준 CLI 또는 MCP 기반 접근 방식보다 높은 성공률, 낮은 비용, 적은 턴 수, 빠른 실행 시간을 달성하는 실증 결과(Claude Sonnet 4.6)가 나와 있습니다.

일반적인 워크플로우

1. AXI 도구를 설치합니다(예: npm install -g gh-axi).
2. LLM 기반 스크립트 또는 프롬프트에서 다른 셸 명령처럼 도구를 호출합니다.
3. 도구는 선택적 집계 및 다음 단계 제안과 함께 TOON(간결하고 토큰 절약 형식)을 반환합니다.
4. 에이전트는 출력을 파싱하고 다음 작업을 결정하거나 데이터를 사용자에게 제시할 수 있습니다.

시작하기

# 두 개의 주요 AXI 설치
npm install -g gh-axi
npm install -g chrome-devtools-axi

# LLM 프롬프트에서의 사용 예
`gh-axi issue list --repo owner/repo --state open`을 사용하여 열린 이슈를 가져옵니다.
`chrome-devtools-axi navigate https://example.com`을 사용하여 헤드리스 브라우저를 구동합니다.

모델이 존재를 알 수 있도록 에이전트의 지식 베이스(예: CLAUDE.md 또는 AGENTS.md)에 도구를 추가합니다.

사용 대상

• SaaS API, 클라우드 서비스 또는 로컬 도구와 상호 작용하는 자율 에이전트를 구축하는 개발자.
• 토큰 소비를 줄이고 도구 호출의 신뢰성을 향상시키려는 프롬프트 엔지니어.
• LLM이 실제 작업을 수행할 수 있는 표준화되고 오버헤드가 낮은 방법에 관심이 있는 모든 사람.

더 알아보기

• 프로젝트 웹사이트: https://axi.md
• 토론 및 지원을 위한 Discord 커뮤니티.
• 저장소의 principles.yaml 및 catalog.yaml 파일은 전체 사양과 증가하는 AXI 목록을 자세히 설명합니다.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.