Finyuus

Finyuus의 언어는 범용 스크립팅이 아니라 AI 오케스트레이션을 위해 작성된 작은 도메인 특화 언어다. 문장은 에이전트 호출, 네이티브 및 HTTP 도구, 가드, 승인, 조건문, 루프, 병렬 분기, 자식 파이프라인을 아우른다. 워크플로가 평범한 텍스트이므로 차이를 비교하고, 풀 리퀘스트에서 리뷰하고, 조각을 프로젝트를 넘어 재사용할 수 있다. 바로 이것이 존재 이유다. 읽고 비교할 수 있는 AI 동작이며, 상자로 가득한 캔버스가 아니다. 상자는 없다. 그저 텍스트다.

모든 실행은 Temporal이 뒷받침한다. 이것이 긴 대기와 장애를 견딜 수 있게 하는 이유다. 워커가 실행 도중 죽으면, 워크플로는 처음부터 다시 시작하지 않고 기록된 상태에서 이어진다. 재시도, 취소, 자식 워크플로 오케스트레이션도 같은 계층에서 온다. 그냥 작동한다. 여러 시간짜리 에이전트 작업이 충돌로 사라지는 것을 본 적이 있는 사람에게, 이 기능은 판단을 바꾼다.

가드는 allowed, confidence, reason 같은 필드를 반환하는 LLM 기반 정책 점검이다. 파이프라인은 실행을 통과 또는 차단 분기로 보내고, 단순한 예/아니오가 아니라 신뢰도 임계값으로 판단할 수 있다. 이렇게 하면 모델이 금융 자문 질문에 곧바로 답하는 것을 막거나, 게시 정책에 어긋나는 출력을 사용자에게 닿기 전에 차단한다. 단순한 발상. 실무에서는 큰 차이다.

승인 문장은 검토자가 대시보드나 API에서 해결할 때까지 워크플로를 멈춘다. 담당자, 타임아웃, 타임아웃 시 동작을 설정하면, 파이프라인은 승인과 거부 경로로 분기한다. 제안이 아니라 실제 정지다. "나중에 확인하지"와 위험한 출력을 실제로 멈추고 사람을 기다린 뒤 계속하는 시스템의 차이가 여기에 있다.

에이전트, 가드, 도구, 스키마, 파이프라인은 불변의 버전 고정을 가진 저장 가능한 객체다. pipeline:company_research@v2 라고 쓰면 정확히 그 버전을 얻는다. 누군가 마지막으로 편집한 것이 아니다. 고정한다. 넘어간다. 자식 파이프라인은 직접 호출하거나 에이전트 도구로 감쌀 수 있어, 한 곳의 변경이 그것에 의존하는 모든 워크플로로 조용히 번지지 않는다.

모든 파이프라인은 Bearer 토큰 인증, Redis 기반 속도 제한, 멱등 키, 입력 검증을 갖춘 HTTP 엔드포인트로 게시할 수 있다. 서버 전송 이벤트가 실행 업데이트를 호출자에게 스트리밍하고, 승인은 자체 이벤트를 만든다. 프로세스 한도는 기본적으로 전체 분당 300회 요청, 엔드포인트당 120회이며, 모두 환경 변수로 설정할 수 있다. 합리적인 기본값. 덮어쓰기도 쉽다.

추적, 토큰 사용량, 모델 비용은 Langfuse에 모이고, 애플리케이션 데이터와 파이프라인 테이블은 ClickHouse에 있다. 실행 이력, 가드 결과, 승인 결정은 대시보드에서 볼 수 있다. 목적은 대시보드를 늘리는 것 자체가 아니다. 조각난 AI 시스템에는 보통 "이 실행에서 실제로 무슨 일이 있었나"에 답할 한 곳이 없다는 점이다.

파일과 큰 산출물은 설정 가능한 객체 저장소로 가고, 기본값은 로컬 MinIO이며 몇 개의 환경 변수로 AWS S3로 바꿀 수 있다. DSL은 파일 읽기·쓰기와 ClickHouse 기반 테이블을 일급 문장으로 다루므로, 구조화된 데이터 작업이 별도 서비스가 아니라 워크플로 안에 있다. 돌볼 추가 서비스가 없다.