백엔드 서비스의 통합과 관찰을 실시간으로 하나로 묶는 방법
큐, 크론, HTTP, 상태 관리, 에이전트, 샌드박스까지 각기 다른 통합 방식을 요구하던 백엔드 구성 요소를 하나의 실시간 시스템으로 묶어줍니다. iii는 이 모든 것을 '워커', '트리거', '함수'라는 세 가지 기본 요소로 단순화하여, 개발자가 비즈니스 로직에 집중할 수 있게 합니다. 새로운 기능을 추가할 때마다 별도의 설정이나 통합 과정을 거치지 않고, 실행 중인 시스템에 즉시 반영되는 경험을 제공합니다.
세 가지 기본 요소로 만드는 실시간 시스템
iii는 모든 서비스를 워커, 트리거, 함수라는 세 가지 개념으로 정의합니다. 워커는 iii 엔진에 등록되어 트리거와 함수를 제공하는 프로세스이며, TypeScript API 서비스든 Python 데이터 파이프라인이든 몇 줄의 코드로 워커로 변환할 수 있습니다. 트리거는 함수 실행을 유발하는 모든 것으로, 직접 호출, HTTP 엔드포인트, 크론 스케줄, 큐 구독, 상태 변경 등이 포함됩니다. 함수는 content::classify와 같은 안정적인 식별자를 가진 작업 단위로, 입력을 받아 작업을 수행하고 선택적으로 출력을 반환합니다. 이 구조 덕분에 시스템은 실행 중에도 새로운 워커를 추가하고, 다른 워커들이 이를 즉시 발견하여 호출할 수 있습니다.
에이전트와 개발자가 공유하는 인터페이스
iii는 개발자와 AI 에이전트가 동일한 인터페이스를 사용하도록 설계되었습니다. 에이전트가 시스템에 없는 기능을 필요로 할 때, 에이전트는 워커를 추가하고, 해당 워커의 함수를 발견하며, 함수를 호출하고, 발생한 이벤트를 추적할 수 있습니다. 이는 개발자가 사용하는 것과 동일한 과정입니다. 플랫폼 팀은 워커를 게시하고, 애플리케이션 팀은 함수를 등록하고 트리거를 선언하며, 에이전트는 동일한 카탈로그와 함수 호출을 사용합니다. 확장, 구성, 관찰이 모두 동일한 메커니즘을 통해 이루어지므로 시스템의 복잡성이 크게 줄어듭니다.
설치와 워커 추가 과정
iii는 curl -fsSL https://install.iii.dev/iii/main/install.sh | sh 명령으로 설치할 수 있습니다. 워커는 worker-compose.yaml 파일에 선언하거나, 실행 중인 Compose 데몬을 통해 iii trigger -n dev compose::add worker=queue와 같은 명령으로 추가할 수 있습니다. Node.js, Python, Rust, Go 언어를 위한 SDK가 제공되어 각 언어 환경에서 쉽게 통합할 수 있습니다. iii-console은 워커, 함수, 트리거, 큐, 추적, 로그, 실시간 상태를 검사하는 개발자 및 운영 콘솔로, 시스템의 상태를 실시간으로 파악하는 데 사용됩니다.
라이선스 구성과 확인 사항
iii 저장소는 디렉터리별로 라이선스가 다릅니다. 엔진 런타임(engine/)은 Elastic License 2.0(ELv2)을 적용받으며, SDK, CLI, 콘솔, 문서, 웹사이트는 Apache License 2.0을 적용받습니다. 또한, iii는 실시간 시스템 표면으로 모든 서비스를 통합하는 것을 목표로 하므로, 기존 시스템과의 호환성 및 데이터 일관성 요구 사항을 사전에 검토하는 것이 좋습니다. 에이전트 스킬은 npx skills add iii-hq/iii/skills로 설치할 수 있으며, 개별 워커 스킬도 함께 설치할 수 있습니다.