Logic

Logic이란?

Logic은 일반 영어 사양을 프로덕션 준비 AI 에이전트로 변환하는 spec-driven 에이전트 플랫폼입니다. 정의된 동작에서 호출 가능한 API로 이어지는 엔드투엔드 워크플로에 중점을 두며, 평가, 버전 관리, 운영 가시성을 포함합니다.

핵심 아이디어는 에이전트 사양으로 작성한 내용이 입력과 출력을 정의한다는 것입니다. Logic은 변경 테스트, 버전 관리, API 노출, 모델 라우팅을 위한 도구를 생성합니다.

주요 기능

사양 기반 에이전트 정의 (입력/출력): 사양으로 동작을 정의해 에이전트 인터페이스와 예상 결과를 도출합니다.
내장 테스트 하네스 및 인라인 예상 출력: 에이전트 정의에 테스트 케이스를 직접 추가하고 저장 시 실행해 회귀를 잡습니다.
자동 회귀 탐지 및 API 기반 CI/CD 통합: 수동 테스트에만 의존하지 않고 자동화 파이프라인에서 평가를 실행합니다.
버전 관리, 차이 비교, 롤백: 사양 변경마다 버전화 및 차이 비교, 롤백과 버전 고정을 통해 API 안정성을 유지합니다.
비기술자 사양 편집을 위한 승인 워크플로: 승인을 통해 비엔지니어가 에이전트 로직을 업데이트하며, 재배포나 별도 프롬프트 관리 없이 진행합니다.
타입화된 REST API 생성 및 자동 문서/UI: 에이전트 사양 저장 시 엄격한 타입 API, 문서, 입력 폼이 포함된 공유 웹 UI를 생성합니다.
PII 마스킹 및 보고: 텍스트에서 개인 데이터를 탐지·마스킹하며 발견된 항목에 대한 상세 보고서를 생성합니다.
정책 평가 및 중재 결정: 제품 목록을 정책에 대해 평가해 승인, 거부 또는 에스컬레이션합니다.
지능형 모델 라우팅 (페일오버 및 캐싱 포함): 작업 복잡도에 따라 OpenAI, Anthropic, Google, Perplexity로 요청 라우팅; 결정론적 워크로드에 자동 페일오버와 실행 캐싱 제공.
디버깅을 위한 실행 로깅: 각 호출의 전체 컨텍스트(입력/출력, 모델 추론, 지연 시간)를 에이전트 버전 전반에 로깅합니다.

Logic 사용 방법

에이전트 사양 작성 또는 선택 (예상 입력/출력 정의 포함).
인라인 테스트 케이스와 예상 출력을 추가한 후 저장 시 테스트 스위트를 실행해 동작 검증.
필요 시 버전 관리, 차이 비교, 승인 워크플로로 사양 반복.
준비되면 저장해 엄격한 타입화 REST API, API 문서, 공유 웹 UI 생성.
실행 로그를 사용해 특정 호출의 발생 사항 검사 및 컨텍스트·지연 시간으로 오류 진단.

사용 사례

계약 조항 검토: “Contract Clause Analyzer” 사양으로 위험 조항 플래그 및 계약 핵심 용어 추출.
시스템 간 레코드 매칭: “Entity Matcher” 사양으로 신뢰도 점수와 함께 레코드 매칭.
송장 및 발주서 추출: “Invoice & PO Data Extractor”로 다중 형식 문서 파싱 및 구조화 라인 아이템 추출.
텍스트 워크플로의 개인 데이터 처리: “PII Redactor”로 개인 데이터 탐지·마스킹 및 탐지 엔티티 보고서 생성.
제품 목록 중재: “Product Listing Moderator”로 목록을 정책 규칙과 비교해 승인, 거부 또는 에스컬레이션 결정.

자주 묻는 질문

Logic은 사양 변경 시 엔지니어 재배포가 필요한가?

사이트에서 설명하듯 버전 관리와 승인 워크플로로 엔지니어가 안정된 API를 유지하며, 승인을 통해 에이전트 로직 업데이트 가능하며 재배포나 별도 프롬프트 관리 불필요.

공급자가 실패하거나 오류 발생 시 어떻게 되나?

Logic은 공급자 오류나 다운 시 자동 페일오버를 포함하며, 작업 복잡도, 지연 시간, 비용에 따라 요청 라우팅.

Logic은 릴리스 전 에이전트 동작을 어떻게 검증하나?

각 에이전트에 내장 테스트 하네스: 저장 시 실행되는 인라인 테스트 케이스와 예상 출력 매칭, 회귀 탐지; API로 CI/CD 통합 가능.

에이전트 사양에서 API와 UI를 모두 생성할 수 있나?

네. Logic은 저장된 사양 기반으로 엄격한 타입화 REST API, 자동 생성 API 문서, 입력 폼 포함 공유 웹 UI 생성.

배포 후 어떤 가시성이 제공되나?

Logic은 API 호출당 전체 실행 컨텍스트 로깅: 입력, 출력, 모델 추론, 지연 시간, 오류 노출, 에이전트 버전 전반 실행 이력.

대안

내장 프롬프트와 평가 기능을 가진 노코드/로우코드 에이전트 빌더: 비개발자가 에이전트를 조립하는 데 도움이 될 수 있지만, 작성된 정의로부터의 spec-driven 버전 관리와 타입화된 API 생성에 덜 의존할 수 있습니다.
프롬프트 평가 도구와 커스텀 테스트 하네스: 별도의 프롬프트 테스트, 로깅, CI 단계를 조합할 수 있지만, 통합 플랫폼을 사용하는 것보다 더 많은 통합 작업이 필요합니다.
오픈소스 오케스트레이션 프레임워크: 라우팅, 로깅, 평가를 직접 구축할 수 있지만, 인프라와 운영 도구의 부담이 팀으로 옮겨갑니다.
커스텀 API/프론트엔드 스택: 타입화된 REST 엔드포인트와 UI를 직접 구축하면 유연성을 얻을 수 있지만, 버전 관리, 테스트 워크플로, 실행 관찰성을 수동으로 구현해야 합니다.