안전한 자동화

키는 만든 사용자의 이름으로 일합니다. 그 사용자가 접근할 수 있는 문서만 다룰 수 있고, 남의 작업은 존재 여부도 알 수 없습니다(404). 팀 문서는 역할로 갈립니다.

키에는 허용한 기능 밖의 도구가 열리지 않습니다. 에이전트마다 키를 따로 만들어 서로의 권한이 섞이지 않게 하세요.

체리를 쓰는 동작은 견적에서 시작합니다.

장면 배치 확정, 공개 범위 변경, 덮어쓰기는 에이전트가 직접 하지 못하고 웹 승인이 필요합니다.

자동화가 사람 없이 끝까지 돌 수 있는 일과, 반드시 사람을 거치는 일을 나눠 설계하세요.

승인이 필요한 호출은 approval_required를 돌려줍니다. 자동화는 이를 실패로 보고 재시도를 반복하지 말고, 링크를 사용자에게 전달한 뒤 승인이 끝나면 같은 입력으로 한 번 다시 부릅니다.

쓰기와 생성에는 idempotencyKey(8자 이상 128자 이하)를 붙입니다. 같은 키와 같은 본문을 다시 보내면 기존 결과를 그대로 받습니다. 같은 키에 다른 본문을 보내면 409(idempotency_key_reused)입니다. 재시도 때 키를 새로 만들면 중복 접수가 생기므로, 키는 작업 하나당 하나를 정해 재시도에도 그대로 씁니다.

예약 실행 기능이 없으므로 예약 한도나 예약 취소 같은 장치도 없습니다. 정해진 시각에 돌리려면 자기 쪽 스케줄러를 쓰고, 이 문서의 한도·견적·승인 규칙을 그 호출에 그대로 적용하세요.