Agno

에이전트를 서비스로 띄우고 운영하는 런타임

pip install agno

에이전트를 만드는 SDK, 서비스로 띄우는 AgentOS 런타임, 운영용 웹 UI 를 한 묶음으로 제공합니다. 데이터와 기억, JWT 기반 접근 제어를 직접 소유한 채로 운영하도록 설계했고, 시뮬레이션과 사용 데이터를 다시 학습 루프로 돌립니다. 2026-09 에 3.x 로 올라갔습니다.

판단

이럴 때 씁니다

  • 에이전트를 만드는 데 그치지 않고 서비스로 띄워 운영해야 할 때
  • 데이터와 기억을 외부 서비스에 맡기지 않고 직접 소유해야 할 때
  • 여러 에이전트를 한 플랫폼에서 관리하고 권한을 나눠야 할 때
  • 사용 데이터로 에이전트를 개선하는 루프를 만들고 싶을 때

이럴 땐 쓰지 마세요

  • 에이전트 하나를 스크립트로 돌리면 되는 규모일 때
  • 프런트엔드 UI 가 목적이면 CopilotKit 쪽이 맞습니다
  • 운영 인프라를 직접 감당할 수 없을 때

차별점

  • SDK·런타임·운영 UI 를 한 묶음으로 제공합니다.
  • 데이터와 기억, 보안 태세를 직접 소유하도록 설계했습니다.
  • JWT 기반 역할 접근 제어가 들어 있습니다.
  • 시뮬레이션과 사용 데이터를 학습 루프로 되돌립니다.

워크플로

  1. 01pip install agno 로 SDK 를 넣습니다.
  2. 02에이전트와 도구, 기억 저장소를 정의합니다.
  3. 03AgentOS 런타임으로 서비스로 띄웁니다.
  4. 04AgentOS UI 에서 실행 상태와 사용 데이터를 봅니다.
  5. 05JWT 기반 역할 접근 제어로 권한을 나눕니다.

주요 명령

명령설명
pip install agnoSDK 를 설치합니다.

함정

설치 전에 확인하세요

  • 2026-09 에 3.x 로 올라갔습니다. 2.x 예제를 그대로 쓰면 어긋납니다.
  • MCPConfig(stateless=True) 는 서버 발신 알림과 SSE 재개를 포기하는 대가가 있어 기본이 꺼져 있습니다.
  • 프레임워크가 아니라 런타임과 UI 까지 포함하므로 도입 범위가 큽니다.
  • 공식 시작 안내가 코딩 에이전트에게 프롬프트를 넘기는 방식이라 절차가 문서와 다를 수 있습니다.

비교

smolagents 나 openai-agents-python 이 에이전트 루프를 만드는 라이브러리라면, Agno 는 그 위에 운영 계층까지 얹은 플랫폼입니다. 팀이 여러 에이전트를 굴리며 권한과 관측이 필요해지는 시점에서 차이가 벌어집니다.

최근 변경

2026-09-04 v3.0.6 에서 MCPConfig(stateless=True) 로 세션 추적 없이 /mcp 를 제공하는 방식이 들어갔습니다. 어느 복제본이든 요청을 받을 수 있어 다중 인스턴스 배포에 세션 어피니티가 필요 없지만, 서버 발신 알림과 SSE 재개를 포기하므로 기본은 꺼져 있습니다.

공식 변경 내역