Flue
에이전트를 함수로 쓰는 타입스크립트 하네스 프레임워크
npm install @flue/runtime에이전트 자체를 함수로 정의합니다. 함수 안에서 쓸 모델과 샌드박스, 스킬, 도구를 선언하면 그 에이전트가 일할 하네스가 그대로 구성됩니다. 초기 에이전트는 모델 API 를 직접 부르는 방식이라 간단한 대화와 정해진 절차 밖으로는 못 나갔습니다. 코딩 에이전트들이 그 틀을 깼고 이제는 단계를 정해 주는 대신 목표를 주고 맡깁니다. 이 프레임워크는 그 구조를 아무 모델에나 열어 줍니다. 세션과 도구, 스킬, 지시, 파일 접근, 안전한 샌드박스가 하나의 하네스로 묶입니다. 지역에서 명령줄로 돌리거나 원하는 호스팅 런타임에 올립니다.
판단
이럴 때 씁니다
- 에이전트가 실제로 코드를 돌려야 할 때
- 스킬과 도구를 코드로 조합하고 싶을 때
- 지역과 원격 샌드박스를 바꿔 쓸 때
이럴 땐 쓰지 마세요
- 타입스크립트가 아니면 쓸 수 없습니다
- 간단한 대화형 응답에는 과합니다
- 판이 2.x 로 올라 이전 예제와 다릅니다
차별점
- 에이전트를 함수 하나로 정의합니다.
- 모델과 샌드박스, 스킬, 도구를 선언으로 조합합니다.
- 안전한 샌드박스가 프레임워크에 들어 있습니다.
- 지역 실행과 호스팅 배포를 같은 코드로 씁니다.
워크플로
- 01런타임 패키지를 설치합니다.
- 02에이전트를 함수로 정의합니다.
- 03모델과 샌드박스, 스킬, 도구를 선언합니다.
- 04지역에서 명령줄로 돌려 봅니다.
- 05원하는 호스팅 런타임에 올립니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install @flue/runtime | 런타임을 설치합니다. |
'use agent' | 파일 맨 위에 붙여 그 함수를 에이전트로 만듭니다. |
함정
설치 전에 확인하세요
- 에이전트 파일에 지시문을 붙여야 합니다. 없으면 평범한 함수로 남습니다.
- 샌드박스를 가상과 지역, 원격 중에 고릅니다. 무엇을 골랐는지에 따라 실행 환경이 완전히 다릅니다.
- 판이 2.x 대입니다. 이전 판 예제는 그대로 안 돕니다.
- 스킬 문서를 그대로 가져다 붙이는 방식이라 문서 품질이 결과에 직결됩니다.
비교
에이전트 SDK 는 호출 방식을 감싸는 데 그치고 실행 환경은 직접 만들어야 하는 경우가 많습니다. 이쪽은 샌드박스와 스킬, 세션까지 하나의 하네스로 묶습니다. 대신 타입스크립트에 묶입니다.
최근 변경
판이 2.x 대로 올라와 있고 2.0.3 은 그 계열의 최신 패치입니다. 저장소가 릴리스 본문에 변경 요약을 따로 적지 않아 내용은 커밋으로 확인해야 합니다.