Get Started

배포 및 운영이란?

배포 및 운영이란?

배포 및 운영이란?

배포 및 운영이란?

캔버스에서 어빌리티(Ability)나 에이전트(Agent)를 완성했다고 해서 곧바로 외부 시스템과 연동되는 것은 아닙니다. 백엔드 서버나 다른 서비스에서 이 워크플로를 실제로 호출하려면, 워크플로를 외부에서 접근 가능한 형태로 별도 발행하는 절차가 필요합니다. 에이전트리아(Agentria)는 이 절차를 배포 및 운영(Deploy & Operations)이라는 개념으로 제공합니다.

배포 및 운영은 API·MCP 서버 두 갈래로 구성되며, 완성한 어빌리티·에이전트를 외부에서 호출 가능한 형태로 배포하고, 실제 호출까지 확인하는 과정을 다룹니다.

배포 및 운영: 완성한 워크플로를 외부에서 호출 가능하게 만들기

프로젝트 사이드바의 배포 및 운영 메뉴 아래에는 API·MCP 서버 두 하위 메뉴가 모여 있습니다.

두 방식 모두 "캔버스에서 완성한 워크플로를 외부에서 호출 가능하게 만든다"는 목적은 같지만, 호출하는 쪽이 사용하는 프로토콜이 다릅니다. 일반적인 백엔드 서버나 서비스가 REST 방식으로 직접 호출하게 하려면 API로, ChatGPT나 Claude 같은 MCP 클라이언트가 도구(Tool)로 호출하게 하려면 MCP 서버로 노출합니다.

API 호출 로그처럼 배포 이후의 운영 관련 기능은 별도 메뉴가 아니라 API·MCP 서버 각 하위 페이지에서 함께 다룹니다.

API: REST API로 배포하고 호출하기

어빌리티·에이전트를 API로 배포하려면 먼저 배포 버전(Version)을 만들어야 합니다. 이후 캔버스 우측 상단의 Publish 버튼에서 API Release를 선택하면, 이름·토큰 설정을 거쳐 API 엔드포인트와 API 키가 발급됩니다.

발급된 엔드포인트는 외부 서비스에서 X-API-KEY 헤더로 인증해 호출합니다. 어빌리티는 Ability API 엔드포인트로, 에이전트는 Agent API 엔드포인트로 각각 호출하며, 두 엔드포인트 모두 비동기 실행·SSE 스트리밍·상태 및 결과 조회·요청 취소 방식을 지원합니다. 에이전트는 대화 이력을 유지하는 채팅방(Chat Room) 단위로 동작한다는 점이 어빌리티와 다릅니다.

API가 처음이라면 포스트맨(Postman) 같은 클라이언트 툴로 먼저 호출을 테스트해볼 수 있습니다. 호출 정보는 에이전트리아 API 탭의 로그에서 확인할 수 있습니다.

MCP 서버: MCP 클라이언트에게 노출하기

MCP 서버는 완성한 어빌리티·에이전트를 MCP(Model Context Protocol) 클라이언트가 도구로 호출할 수 있게 노출하는 기능입니다. MCP 노드가 에이전트리아의 워크플로 안에서 외부 MCP 서버에 접속하는 클라이언트 방향 기능이라면, 이쪽은 반대로 에이전트리아의 어빌리티·에이전트 자체를 MCP 서버로 만들어 외부 MCP 클라이언트가 호출하게 하는 기능입니다.

MCP 서버 가이드는 아직 작성 중입니다.

더 알아보기

배포 및 운영을 실제로 진행해보고 싶다면 아래 가이드를 참고하시기 바랍니다.



자주 묻는 질문

배포 및 운영이란 무엇인가요?

에이전트리아의 배포 및 운영(Deploy & Operations)은 캔버스에서 완성한 어빌리티·에이전트를 외부 시스템에서 호출할 수 있는 형태로 발행하는 절차입니다. REST 방식으로 직접 호출하게 만드는 API와, MCP 클라이언트가 도구로 호출하게 만드는 MCP 서버 두 가지 방식을 제공합니다.

배포 및 운영은 언제 사용해야 하나요?

캔버스에서 완성한 어빌리티나 에이전트를 백엔드 서버, 다른 서비스, 또는 ChatGPT·Claude 같은 MCP 클라이언트에서 직접 호출하고 싶을 때 사용합니다. 일반적인 REST 연동이 필요하면 API를, MCP 클라이언트의 도구로 사용하고 싶다면 MCP 서버를 선택합니다.

API 배포 가이드와 API 엔드포인트 가이드는 어떻게 다른가요?

API 배포 가이드는 어빌리티·에이전트를 API로 발행해 엔드포인트와 API 키를 발급받는 절차를 다루고, API 엔드포인트 가이드는 그렇게 발급받은 엔드포인트를 외부 서비스에서 실제로 호출하는 방법을 다룹니다. 즉 배포가 먼저이고, 엔드포인트 호출은 배포 이후의 사용 단계입니다.

MCP 서버 가이드는 MCP 노드 튜토리얼과 어떻게 다른가요?

MCP 노드 튜토리얼은 에이전트리아의 워크플로가 외부 MCP 서버에 접속해 도구를 호출하는 클라이언트 방향 가이드입니다. 반대로 MCP 서버 가이드는 에이전트리아의 어빌리티·에이전트 자체를 MCP 서버로 노출해, 외부 MCP 클라이언트가 이를 도구로 호출하게 만드는 가이드입니다. 호출 방향이 서로 반대입니다.