TL;DR

  • Cadenya는 기존 API 위에 도구·에이전트·목표를 계층화해 에이전트를 안전하게 테스트하고 빠르게 개선하는 에이전트 런타임임
  • MCP 서버, OpenAPI 사양, 기존 엔드포인트를 단일 도구 계층으로 연결해 인프라를 다시 구축하지 않고 모델과 동작을 교체·확장할 수 있음
  • 에이전트 정의, 능력 구성, 목표 실행의 흐름으로 프런티어 모델을 빠르게 도입하고 여러 접근 방식을 비교할 수 있음
  • 점진적 도구 탐색으로 도구 스키마를 필요할 때만 컨텍스트에 포함하고, 실시간 토큰 측정으로 사용량과 비용을 관리함
  • 웹훅과 SSE로 에이전트 이벤트를 애플리케이션에 전달하며, 도구 승인·하위 에이전트·피드백·실행 추적을 지원함

Cadenya 개요

  • Cadenya는 도구, 에이전트, 목표를 계층화해 안전한 테스트와 빠른 개선을 지원하는 에이전트 런타임임
  • 기존에 운영 중인 API 위에 기능을 구축하므로 스택을 다시 만들 필요 없이 에이전트를 구축·테스트·개선할 수 있음
  • 계정 생성과 API 문서 확인을 통해 시작하는 구조임

기존 스택 연결

  • MCP 서버, OpenAPI 사양, 기존 엔드포인트를 에이전트가 사용할 수 있는 단일 도구 계층으로 연결함
  • 모델을 교체하고 동작을 발전시키며 기능을 확장하는 동안 기존 인프라를 유지함
  • 새로운 기능을 추가하면서 복잡성은 늘리지 않는 통합 런타임을 지향함

에이전트 구축과 실험

  • 에이전트 정의, 능력 구성, 목표 실행의 세 단계로 작업함
  • 하나의 에이전트로 시작해 지속적으로 확장하는 방식임
  • 프런티어 모델을 빠르게 도입하고 동작을 테스트하며 접근 방식을 비교함
  • 기본 모델로 Anthropic Claude Sonnet [Latest], 카나리 모델로 OpenAI GPT-5.5를 설정할 수 있음
  • 모델 변형을 추가하고, 모델·할당·도구 세트를 조합해 결과를 비교함
  • 예시 에이전트 구성은 다음과 같음
  • 모델: GPT-5.2
  • 할당 도구: reroute shipment tool, update_eta tool
  • 도구 세트: Dispatch API
  • 하위 에이전트: Customs Broker
  • 메모리 계층: Carrier Playbook, SLA Policies
  • 시스템 프롬프트: 배송이 중단되면 디스패치 API를 통해 경로를 변경하는 Meridian의 배송 예외 처리 에이전트 역할임

토큰 사용량 관리

  • 실시간 토큰 측정으로 비용을 파악하고 낭비를 줄이며 에이전트가 적응하는 과정에서 효율을 개선함
  • 점진적 도구 탐색을 활성화해 에이전트가 요청하기 전까지 도구 스키마를 컨텍스트 윈도에 넣지 않음
  • 에이전트에는 도구 이름만 전달되므로 각 요청의 크기가 줄어듦
  • 도구 검색 설정 항목은 다음과 같음
  • 검색당 최대 도구 수: 1~10, 기본값 5
  • 검색 힌트: delays, reroutes, customs 등 최대 5개
  • 재순위화 임계값: 0.0~10, 공란이면 재순위화를 건너뜀

실시간 서비스 연결

  • 웹훅과 SSE(Server-Sent Events)로 실시간 업데이트를 전달하고 에이전트 이벤트를 애플리케이션에 연결함
  • 웹훅 전달 이벤트에는 다음 항목이 포함됨
  • Assistant message
  • tool_result
  • tool_approval_requested
  • sub_agent_spawned
  • context_window_compacted
  • timed_out
  • 예시 웹훅 URL은 다음과 같음
  • https://app.meridianfreight.com/hooks/agents
  • 각 이벤트의 HTTP 상태는 204, 상태는 Completed로 표시됨

성능 관찰과 피드백

  • 실제 환경에서 에이전트 동작이 어떻게 형성되는지 관찰하고 결과를 모니터링함
  • 목표별 실행 기록에 도구 호출, 웹훅 전달, 토큰 사용량, 결과에 대한 피드백을 남김
  • 피드백 예시는 다음과 같음
  • +1.00 SLA 위반 전에 경로를 변경해 수신자가 알아차리지 못함 — 카나리, GPT-5.2
  • +0.50 통관 보류를 포착하고 ETA를 선제적으로 업데이트함 — 기본값, Claude Sonnet 5
  • +0.50 경로 변경은 좋았지만 수신자에게 두 번 알림을 보냄 — 카나리, GPT-5.2
  • -0.25 경로 변경이 가능했는데 시설에 머무름 — 카나리, GPT-5.2
  • +0.75 냉동 화물 노선을 올바르게 에스컬레이션함 — 기본값, Claude Sonnet 5

자주 묻는 질문

  • Cadenya란 무엇인가? Cadenya는 기존에 운영 중인 API 위에 도구·에이전트·목표를 계층화하는 에이전트 런타임임
  • 사용 중인 API를 다시 작성해야 하는가? 다시 작성할 필요 없이 MCP 서버, OpenAPI 사양, 기존 엔드포인트를 단일 도구 계층으로 연결해 그대로 사용할 수 있음
  • 웹훅을 제공하는가? 에이전트 루프의 모든 이벤트를 지정한 웹훅 엔드포인트로 이벤트 형태로 전달함
  • 프런트엔드 대화 위젯을 제공하는가? Widgets 기능을 통해 모든 프런트엔드에 대화 등의 에이전트 기능을 추가함
  • 추론 기능을 제공하는가? 새 계정마다 사전 구성된 OpenRouter 크레딧 5달러를 제공하며, 이후에는 자체 LLM 제공업체 인증 정보를 입력해야 함
  • 에이전트가 실제로 수행한 작업을 어떻게 확인하는가? 모든 목표에 도구 호출, 웹훅 전달, 토큰 사용량, 결과 피드백의 실행 추적이 유지됨
  • 에이전트가 시스템과 실시간으로 통신할 수 있는가? 웹훅과 SSE가 에이전트 이벤트를 발생 시점에 애플리케이션으로 전달하므로 하위 서비스가 즉시 반응함
  • 도구 호출에 승인이 필요한 경우 어떻게 처리하는가? 승인 게이트가 적용된 도구는 에이전트를 일시 중지하고 tool_approval_requested 이벤트를 전달해 사람이나 시스템이 실행 전에 승인하도록 함
  • 에이전트 협업을 지원하는가? 에이전트가 하위 에이전트를 무한히 생성할 수 있으며, 작업에 맞는 모델 설정으로 하위 에이전트의 토큰 사용량과 결과를 최적화함

시작하기

  • 이미 보유한 API로 에이전트를 실행하는 과정은 몇 단계로 구성되며 첫 단계는 계정 생성임
  • Cadenya에서 에이전트를 생성하고 API 문서를 확인하는 방식으로 구축을 시작함