Agents
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
Sume 개발자 도구는 하나의 경계를 따릅니다. 공개 API가 원본이고, 래퍼는 얇게 유지합니다.
도구 계층
- Developer API: 워크스페이스 범위의 HTTP 엔드포인트입니다.
- CLI: Developer API를 셸에서 쓰기 좋게 감싼 래퍼입니다.
- 호스팅 MCP: Cursor, Claude 등을 위한
https://mcp.sume.com/mcp의 원격 MCP입니다. - 로컬
sume mcp: 앞으로 나올 CLI 표면입니다(현재 릴리스에서는coming_soon). 호스팅 MCP나 CLI 명령어를 직접 사용하세요. - 대시보드 도구: 서버가 워크스페이스 컨텍스트를 해석하는 앱 통합 도구입니다.
에이전트는 쓰기나 유료 작업의 확인을 요청하기 전에, 계획 단계에서 카탈로그, Job, 미디어 스키마, 사용량 읽기를 활용해야 합니다. 안전한 자동화에서 살펴보세요.
어디서 시작하나요
| 목표 | 시작 지점 |
|---|---|
| 백엔드에서 저장해 둔 작성 레시피 호출하기 | Format API · Format 카탈로그 |
| Cursor / Claude 인터랙티브 커넥터 | MCP 빠른 시작 |
| CLI를 쓰는 로컬 셸 에이전트 | 빠른 시작 · CLI 개요 |
| 백엔드 · 서버 연동 | 빠른 시작 (API) · Public API |
| 백엔드에서 임시 작업으로 Agent 실행하기 | Agent Completions |
| 정해진 주기로 에이전트 실행하기 | Scheduled |
| API 키 만들기 | API Keys 대시보드 |
| Agents 제품 UI | Agents |
| 첫 Avatar 또는 Image Job | 아바타 만들기 · Image 1.0 |
오늘 호스팅 MCP의 유료 도구는 여전히 대부분 Avatar 중심입니다. 에이전트에서 Image, Video, Music을 생성하려면 Developer API(또는 그 위에 직접 만든 얇은 도구)를 호출하세요. 자세한 내용은 MCP 개요에 있습니다.
워크스페이스 컨텍스트
에이전트 도구는 사용자에게 워크스페이스 id를 묻지 않아야 합니다. 워크스페이스 컨텍스트는 API 키나 인증된 앱 세션에서 옵니다.