API 배포

에이전트리아(Agentria)에서 워크플로(Workflow)를 완성했다면, API 배포를 통해 다양한 작업에 활용할 수 있습니다. API로 배포하면 외부 시스템에서 HTTP 요청으로 이 워크플로를 직접 호출할 수 있습니다.

이 가이드에서는 새 API를 배포하는 방법과, 배포 과정에서 함께 진행하는 배포 버전(Version)·API 키(API Key) 설정 방법을 안내합니다.

API란?

API(Application Programming Interface)는 서로 다른 소프트웨어나 서비스가 표준화된 방식으로 소통할 수 있도록 제공되는 인터페이스입니다. 특정 기능이나 데이터를 외부에 공개해, 다른 프로그램이 이를 호출하고 활용할 수 있게 해줍니다. 예를 들어 OpenAI API로 텍스트 생성 기능을 호출하거나, Google Maps API로 지도 데이터를 불러오는 것도 모두 API를 통한 상호작용입니다.

API는 요청(Request)과 응답(Response) 형식으로 동작하며, 정해진 규칙에 따라 데이터를 주고받습니다. 이런 방식 덕분에 API는 단순한 데이터 통로를 넘어, 시스템 간 재사용성과 확장성을 보장하는 핵심 요소로 쓰입니다.

에이전트리아에서 워크플로를 API로 배포하면, 그 워크플로 자체가 하나의 API가 됩니다. 즉 외부의 백엔드 서버나 다른 서비스가 정해진 요청 형식(엔드포인트·API 키)에 맞춰 호출하면, 워크플로가 실행되고 그 결과를 응답으로 돌려받을 수 있습니다.

API를 활용하면 다음과 같은 이점이 있습니다.

• 재사용성: 한 번 배포한 워크플로를 여러 외부 시스템에서 반복적으로 호출해 재사용할 수 있습니다.

• 확장성: 새로운 서비스가 생겨도 같은 API 형식으로 손쉽게 연동을 추가할 수 있습니다.

• 호환성: 요청·응답 형식이 표준화되어 있어, 어떤 언어·플랫폼에서 개발된 시스템이든 동일한 방식으로 호출할 수 있습니다.

• 독립성: 워크플로를 캔버스에서 직접 실행하지 않고도, 외부 시스템이 필요할 때마다 API로 호출해 결과를 받을 수 있습니다.

사전 준비

배포할 워크플로가 이미 완성되어 있어야 합니다. 배포 버전을 올리는 기준이 궁금하다면 🔗버전 관리하기 가이드를 먼저 참고하면 좋습니다. 버전은 이 가이드의 배포 과정 안에서 바로 생성할 수도 있습니다.

1단계: API 배포 시작하기

배포 버튼 클릭

캔버스 우측 상단의 배포 버튼을 클릭합니다.

배포 메뉴

메뉴에서 + 새 API 배포하기를 선택합니다. 이미 배포한 API가 있다면 기존 API 배포 목록에서 선택해 같은 워크플로를 다른 이름으로 추가 배포할 수도 있습니다. 같은 메뉴에서 마켓 등록이나 MCP 서버 배포도 진행할 수 있습니다.

2단계: API 정보 입력하기

새 API 배포 모달

새 API 배포 창에서 아래 정보를 입력합니다.

3단계: 버전 선택 또는 생성하기

버전 항목에서 배포에 사용할 배포 버전(Version)을 선택합니다.

이미 만들어둔 버전이 있다면 목록에서 선택하고, 없다면 버전 추가를 선택해 같은 창 안에서 바로 새 버전을 만들 수 있습니다. Version 번호와 Change Log를 입력하고 생성 버튼을 클릭하면 됩니다. 버전 번호를 올리는 기준은 🔗버전 관리하기 가이드를 참고하세요.

4단계: API 키 선택 또는 생성하기

API 키 선택 항목에서 이 API 호출에 사용할 API 키를 지정합니다.

API 키(API Key)는 외부에서 API를 호출할 때 요청을 인증하는 문자열 기반의 인증 정보입니다. 이전에 만들어둔 키가 있다면 이름과 만료일(무기한인 경우 "만료일: 무기한")이 함께 목록에 표시되며, 그중 하나를 선택해 재사용할 수 있습니다. 새로 발급하려면 + 새로운 API 키 생성을 선택한 뒤, 키 이름과 (선택적으로) 만료일을 입력하고 진행합니다.

API 키 값은 발급 직후 배포 완료 화면에서 한 번만 전체 값이 표시되며, "키를 복사하여 안전하게 보관하세요."라는 안내와 함께 복사 버튼이 함께 제공됩니다. 이후에는 API 키 선택 목록에 이름과 만료일만 표시되고 값은 다시 확인할 수 없으므로, 화면을 닫기 전에 반드시 복사해 안전한 곳에 보관해야 합니다.

5단계: 배포 완료 및 정보 확인

버전과 API 키까지 선택했다면 배포를 완료합니다. 기존 API 키를 재사용하는 경우 바로 배포 버튼을 클릭하면 되고, + 새로운 API 키 생성을 선택한 경우에는 다음 버튼으로 키 이름·만료일 입력 화면으로 이동한 뒤 배포 버튼을 클릭합니다.

새 API 키를 발급한 경우, 배포가 끝나면 API 배포 완료! 화면에서 방금 생성된 API 키 값을 확인하고 복사할 수 있습니다. 이 화면을 닫으면 값을 다시 볼 수 없으니 복사 후 완료 버튼으로 복사한 뒤 안전한 곳에 보관하세요.

배포 후 API 정보를 다시 확인하거나 수정하려면, 캔버스 우측 상단의 배포 버튼을 다시 클릭합니다. 기존 API 배포 목록에서 기존 API 배포 카드의 두 버튼을 사용할 수 있습니다.

API 설정 편집에서 확인한 엔드포인트로 실제 호출을 테스트해보고 싶다면 🔗Ability API 엔드포인트 사용하기 또는 🔗Agent API 엔드포인트 사용하기 가이드를 참고하세요.

다음 단계

API 배포가 완료되었습니다.

이제 발급받은 엔드포인트와 API 키로 외부 시스템에서 이 워크플로를 직접 호출할 수 있습니다.

• 🔗버전 관리하기 — 배포 버전을 올리는 기준과 롤백 방법을 확인하세요.

• 🔗Ability API 엔드포인트 사용하기 — 배포된 어빌리티 API를 외부에서 호출하는 방법을 안내합니다.

• 🔗Agent API 엔드포인트 사용하기 — 배포된 에이전트 API를 외부에서 호출하는 방법을 안내합니다.

자주 묻는 질문

API로 배포하면 무엇을 할 수 있나요?

완성한 워크플로를 API로 배포하면, 외부 시스템이나 서비스가 HTTP 요청으로 이 워크플로를 직접 호출해 결과를 받을 수 있습니다. 배포된 API는 엔드포인트 이름과 API 키로 호출합니다.

버전을 미리 만들어두지 않아도 배포할 수 있나요?

네, 가능합니다. API 배포 창의 버전 항목에서 버전 추가를 선택하면, 별도 화면으로 이동하지 않고 그 자리에서 새 버전을 만들어 바로 배포에 사용할 수 있습니다.

API 키를 여러 API에서 함께 써도 되나요?

네, 가능합니다. API 키 선택 목록에는 이전에 발급한 키가 만료일과 함께 표시되며, 그중 하나를 선택해 다른 API 배포에도 재사용할 수 있습니다. 용도별로 구분하고 싶다면 배포마다 + 새로운 API 키 생성으로 새 키를 발급하면 됩니다.

API 키를 분실하면 어떻게 하나요?

API 키는 발급 직후 화면에서만 전체 값을 확인할 수 있고, 창을 닫으면 다시 볼 수 없습니다. 분실했다면 배포 버튼 → 기존 API 배포 목록의 API 설정 편집에서 새 API 키로 교체할 수 있습니다.