CrewAI AMP API 소개

CrewAI AMP API 소개 (Introduction)

CrewAI AMP API는 배포된 crew를 프로그래밍 방식으로 다룰 수 있게 해주는 인터페이스예요. 이 API로 여러분의 애플리케이션, 워크플로우, 서비스와 crew를 통합할 수 있어요.

출처: 문서

본문

Quick Start (빠른 시작)

API 자격 증명 얻기 — CrewAI AMP 대시보드에서 crew의 상세 페이지로 이동한 뒤, Status 탭에서 Bearer Token을 복사하세요.
필수 입력값 확인하기 — GET /inputs 엔드포인트로 crew가 어떤 파라미터를 기대하는지 확인하세요.
crew 실행 시작하기 — POST /kickoff에 입력값을 담아 호출하면 crew 실행이 시작되고 kickoff_id를 받아요.
진행 상황 모니터링하기 — GET /status/{kickoff_id}로 실행 상태를 확인하고 결과를 가져오세요.

Authentication (인증)

모든 API 요청은 Bearer token 인증이 필요해요. 토큰을 Authorization 헤더에 넣어 보내면 돼요:

curl -H "Authorization: Bearer ***" \
  https://your-crew-url.crewai.com/inputs

Token Types (토큰 종류)

Token Type	Scope	Use Case
Bearer Token	Organization-level access	crew 전체 작업, 서버 간 통합에 적합
User Bearer Token	User-scoped access	제한된 권한, 사용자별 작업에 적합

두 토큰 종류 모두 CrewAI AMP 대시보드의 crew 상세 페이지 Status 탭에서 찾을 수 있어요.

Base URL

배포된 각 crew는 고유한 API 엔드포인트를 가져요:

https://your-crew-name.crewai.com

your-crew-name을 대시보드에서 확인한 실제 crew URL로 바꾸면 돼요.

Typical Workflow (전형적인 워크플로우)

Discovery(발견): GET /inputs를 호출해 crew가 무엇을 필요로 하는지 파악해요.
Execution(실행): POST /kickoff로 입력값을 제출해 처리를 시작해요.
Monitoring(모니터링): 완료될 때까지 GET /status/{kickoff_id}를 폴링해요.
Results(결과): 완료된 응답에서 최종 출력을 추출해요.

Error Handling (에러 처리)

API는 표준 HTTP 상태 코드를 사용해요:

Code	Meaning
200	Success
400	Bad Request - 잘못된 입력 형식
401	Unauthorized - 잘못된 bearer token
404	Not Found - 리소스가 없음
422	Validation Error - 필요한 입력값 누락
500	Server Error - 지원팀에 문의

Interactive Testing (대화형 테스트)

왜 "Send" 버튼이 없을까요? CrewAI AMP 사용자마다 고유한 crew URL을 갖기 때문에, 혼란을 피하려고 대화형 플레이그라운드 대신 reference mode를 사용해요. 이 방식이 요청이 어떻게 생겨야 하는지를 정확히 보여주면서, 동작하지 않는 전송 버튼은 만들지 않아요.

각 엔드포인트 페이지는 다음을 보여줘요:

✅ 모든 파라미터가 포함된 정확한 요청 형식
✅ 성공/에러 케이스의 응답 예시
✅ 여러 언어의 코드 샘플(cURL, Python, JavaScript 등)
✅ 올바른 Bearer token 형식의 인증 예시

실제 API를 테스트하려면:

Copy cURL Examples — cURL 예시를 복사해서 URL과 토큰을 실제 값으로 바꿔보세요.
Use Postman/Insomnia — 예시를 선호하는 API 테스트 도구로 가져와보세요.

예시 워크플로우:

아무 엔드포인트 페이지에서 cURL 예시를 복사해요.
your-actual-crew-name.crewai.com을 실제 crew URL로 바꿔요.
Bearer token을 대시보드에서 발급받은 실제 토큰으로 바꿔요.
터미널이나 API 클라이언트에서 요청을 실행해요.

Need Help? (도움이 필요할 때)

Enterprise Support — API 통합과 문제 해결에 대한 도움을 받아요.
Enterprise Dashboard — crew를 관리하고 실행 로그를 확인해요.

CrewAI AMP API 소개