스케줄 만들기
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
스케줄은 Agents 대시보드에서 만듭니다. Developer API에는 생성·수정 엔드포인트가 없으므로 이 플로가 유일한 작성 방법입니다.
1. Scheduled 열기
https://www.sume.com/agents/scheduled으로 이동해 헤더의 Create 컨트롤을
사용하세요.
2. 지시문 작성하고 모델 고르기
지시문은 Agent가 매 실행마다 수행하는 내용입니다. 프롬프트라고 생각하세요. 실행 사이에 계속 유지되며, 호출자가 보내는 데이터는 따로 도착합니다 (고급: API로 스케줄 실행하기 참고).
지시문이 비어 있으면 실행할 수 없습니다. 실행 요청이 400으로 실패합니다.
3. 주기 설정하기
주기가 기본값이라 따로 고를 것은 없습니다. 얼마나 자주 실행할지만 정하세요. Scheduled는 5필드 cron 표현식과 IANA 타임존을 받습니다. 시간별, 일별, 주별 프리셋은 표현식을 대신 써 주고, 커스텀은 원본 표현식을 받습니다.
Advanced에서 트리거를 API call로 바꿀 수 있습니다. 그러면
trigger_type: "api"가 저장되고 주기가 완전히 사라집니다. 스케줄은 서비스가
Sume를 호출할 때만 실행됩니다. 시계가 아니라 외부 시스템이 작업 시점을 정할 때
선택하세요.
trigger_type은 한 번 만들면 고정됩니다. API 전용 스케줄은 주기를 가질 수 없고,
cron 스케줄은 API 전용으로 내려갈 수 없습니다. 다만 cron 스케줄은 API 트리거도
함께 켜서 둘 다 받을 수 있습니다.
4. 지출 상한 설정하기
생성 지출 상한은 한 번의 실행이 생성에 쓸 수 있는 금액을 제한합니다. 설정하지 않으면 실행당 $1.00이 기본값입니다.
호출자는 generation_spend_cap_usd로 특정 실행의 상한을 낮출 수 있지만,
스케줄의 상한보다 높일 수는 없습니다.
5. 출력 스키마 바인딩하기 (선택)
기본적으로 실행의 output은 sume/action-run-output/v1에 투영됩니다.
{ text, images[], videos[], audio[], files[] } 형태입니다. Output schema
섹션에서 직접 만든 형태를 대신 바인딩할 수 있습니다. JSON Schema를 붙여 넣고,
이름을 정하고, primary_output_key를 지정하세요.
커스텀 스키마는 엄격한 부분집합을 따라야 합니다(OpenAI Structured Outputs가 강제하는 것과 같은 규칙입니다).
- 루트는 객체입니다.
- 모든 객체에
"additionalProperties": false를 설정합니다. - 모든 속성이
required에 나타나야 합니다. 선택 속성은"type": ["string", "null"]같은 nullable 유니온으로 표현합니다. - 중첩은 최대 10단계, 속성은 5000개, enum 값은 1000개까지입니다.
$ref는#/$defs/<name>또는 등록된SumeMediaFile#만 가리킬 수 있습니다.
부분집합을 벗어난 스키마는 저장할 때 거부되며 위반한 규칙이 함께 표시됩니다. Load image example을 누르면 동작하는 이미지 스키마가 채워집니다.
이름을 sume/action-image-v1로 하고 primary output key를 image로
설정하세요. 그러면 실행이 output.image.url을 내구성 있는 media.sume.com
URL로 반환합니다. 두 필드를 비우면 기본 스키마로 돌아갑니다.
스키마 이름에는 A-Z a-z 0-9 . _ / -를 최대 64자까지 쓸 수 있습니다. Sume는
구조화 모델을 호출할 때 A-Z a-z 0-9 _ - 밖의 문자를 바꿔 씁니다. 그 프로바이더가
더 좁은 집합만 받기 때문입니다. 저장되고 영수증에 보고되는 것은 입력한
이름입니다. sume/action-image-v1은 output_schema.name에서도
sume/action-image-v1 그대로입니다.
strict: false도 받아서 영수증에 그대로 표시하지만, 부분집합 제약을 느슨하게
만들지는 않습니다. Sume는 기계적으로 충족할 수 있는 스키마만 채웁니다.
6. 활성화하기
스케줄을 Active로 설정하세요. Inactive인 동안 API 실행은
409 action_inactive로 거부됩니다.
7. 실행 엔드포인트 복사하기
API 트리거를 켜면 트리거 카드에 실행 엔드포인트, 필요한 스코프, 그리고 그대로 복사해 쓸 수 있는 요청이 표시됩니다.
엔드포인트 호스트는 복사한 대시보드를 따릅니다. *.dev.sume.com 호스트에서
제공된 대시보드는 https://api.dev.sume.com을, 그 외에는
https://api.sume.com을 내놓습니다. 복사한 명령어를 프로덕션 코드에 붙여 넣기
전에 호스트를 확인하세요.
8. 실행 기록 확인하기
각 실행은 트리거 출처와 함께 나열됩니다. API로 시작한 실행에는 API,
스케줄 실행에는 Cron 라벨이 붙습니다.