---
title: Agents
description: Sume 개발자 도구가 에이전트 워크플로에 어떻게 들어맞는지 살펴보세요.
---

Sume 개발자 도구는 하나의 경계를 따릅니다. 공개 API가 원본이고, 래퍼는 얇게
유지합니다.

## 도구 계층

1. Developer API: 워크스페이스 범위의 HTTP 엔드포인트입니다.
2. CLI: Developer API를 셸에서 쓰기 좋게 감싼 래퍼입니다.
3. 호스팅 MCP: Cursor, Claude 등을 위한 `https://mcp.sume.com/mcp`의 원격
   MCP입니다.
4. 로컬 `sume mcp`: 앞으로 나올 CLI 표면입니다(현재 릴리스에서는
   `coming_soon`). 호스팅 MCP나 CLI 명령어를 직접 사용하세요.
5. 대시보드 도구: 서버가 워크스페이스 컨텍스트를 해석하는 앱 통합 도구입니다.

에이전트는 쓰기나 유료 작업의 확인을 요청하기 전에, 계획 단계에서 카탈로그, Job,
미디어 스키마, 사용량 읽기를 활용해야 합니다.
[안전한 자동화](/agents/safe-automation)에서 살펴보세요.

## 어디서 시작하나요

| 목표 | 시작 지점 |
|---|---|
| 백엔드에서 저장해 둔 작성 레시피 호출하기 | [Format API](/formats) · [Format 카탈로그](/formats/catalog) |
| Cursor / Claude 인터랙티브 커넥터 | [MCP 빠른 시작](/mcp/quickstart) |
| CLI를 쓰는 로컬 셸 에이전트 | [빠른 시작](/) · [CLI 개요](/cli) |
| 백엔드 · 서버 연동 | [빠른 시작](/) (API) · [Public API](/public-api) |
| 백엔드에서 임시 작업으로 Agent 실행하기 | [Agent Completions](/agents/completions) |
| 정해진 주기로 에이전트 실행하기 | [Scheduled](/agents/actions) |
| API 키 만들기 | [API Keys 대시보드](https://www.sume.com/dashboard/api-keys) |
| Agents 제품 UI | [Agents](https://www.sume.com/agents) |
| 첫 Avatar 또는 Image Job | [아바타 만들기](/models/avatar) · [Image 1.0](/models/image) |

오늘 호스팅 MCP의 유료 도구는 여전히 대부분 Avatar 중심입니다. 에이전트에서
Image, Video, Music을 생성하려면 Developer API(또는 그 위에 직접 만든 얇은
도구)를 호출하세요. 자세한 내용은 [MCP 개요](/mcp)에 있습니다.

## 워크스페이스 컨텍스트

에이전트 도구는 사용자에게 워크스페이스 id를 묻지 않아야 합니다. 워크스페이스
컨텍스트는 API 키나 인증된 앱 세션에서 옵니다.