Agent-Native

요약

Agent-Native는 한 번 정의한 작업을 여러 앱 표면에서 재사용하도록 설계한 에이전트 앱 프레임워크입니다. 공식 README의 핵심 예시는 이메일 답장 작업 하나를 UI, 에이전트, HTTP, MCP, A2A, CLI에서 호출하는 구조입니다.

도구 소개

작업의 입력 스키마와 실행 함수를 중심에 두고, 사용자가 누르는 화면과 에이전트가 선택하는 도구를 같은 작업 정의에 연결합니다. README는 에이전트 런타임에 채팅·도구·스킬·메모리·작업·관측성·핸드오프를 함께 제공한다고 설명합니다. 데이터베이스는 Drizzle이 지원하는 SQL 데이터베이스, 호스트는 Nitro 호환 환경을 사용할 수 있도록 구성되어 있습니다.

이 방식의 장점은 UI용 로직과 에이전트용 도구 로직이 서로 다른 결과를 만들 가능성을 줄이는 데 있습니다. 반대로 하나의 작업이 여러 표면에 노출되는 만큼, 입력 검증·권한·멱등성·감사 기록을 작업 정의 주변에서 명확히 해야 합니다.

사용 포인트

사람이 클릭하는 화면과 에이전트 도구가 같은 업무 규칙을 사용해야 할 때
채팅 외에도 API·MCP·A2A·CLI를 통해 동일한 작업을 노출할 때
팀·공유·설정·관측성 같은 반복 UI를 새 앱마다 만들고 싶지 않을 때
채팅 앱, 분석 도구, 콘텐츠 도구처럼 작동하는 에이전트 앱의 출발점이 필요할 때

공식 사이트에는 Clips, Plans, Design, Content, Analytics, Chat 템플릿이 제공됩니다. 템플릿은 단순한 대화창이 아니라 영상·계획·디자인·콘텐츠·분석 등 특정 업무 표면을 가진 앱의 예제로 구성되어 있어, 프레임워크의 의도를 화면으로 확인하기 좋습니다.

설치와 시작

공식 README는 다음 명령으로 새 앱을 시작하는 흐름을 안내합니다.

npx @agent-native/core@latest create my-app
cd my-app
pnpm install
pnpm dev

처음부터 모든 표면을 연결하기보다, 하나의 작업을 정의하고 UI와 에이전트 호출에서 같은 입력·출력·권한 검사를 거치는지 확인하는 편이 좋습니다. 이후 HTTP나 MCP를 추가할 때도 외부에서 직접 실행해도 안전한지 다시 검증해야 합니다.

적용 판단

Agent-Native는 에이전트 기능을 기존 앱의 부가 채팅으로 붙이기보다, 업무 작업을 여러 인터페이스에서 실행하는 공통 계약으로 다루고 싶을 때 잘 맞습니다. 특히 같은 업무를 사람·자동화·외부 통합이 함께 수행하는 제품을 빠르게 실험할 때 구조가 분명합니다.

다만 프레임워크가 권한 설계를 대신해 주지는 않습니다. 이메일 발송·데이터 변경·외부 공개처럼 되돌리기 어려운 작업은 표면이 무엇이든 승인 단계를 두고, 작업 실행 전후의 입력·사용자·도구·결과를 기록해야 합니다. 저장소 README는 MIT 라이선스를 명시하지만, 실제 배포 전에는 의존성별 라이선스와 호스팅 비용도 확인해야 합니다.

요약

도구 소개

사용 포인트

설치와 시작

적용 판단

참고