화이트 라벨 엔드포인트는 리셀러가 자기 이름으로 파는 API에 추가하는 엔드포인트입니다. 새로운 기능이 아닙니다. 그 API에 이미 있는 작업 몇 개를 순서대로 엮어, 리셀러가 고른 주소 하나와 이름 하나 뒤에 놓은 것입니다. 고객은 다른 것을 호출할 때와 똑같이 이를 호출하고, 고객의 어시스턴트는 도구 목록에서 이를 이루는 작업들 옆에 놓인 것을 봅니다.
리셀러가 이것을 원하는 이유
리셀러가 파는 제품은 대개 작업 하나가 아니기 때문입니다. “목록을 워밍업해 드립니다”는 검색을 하고, 결과마다 반응을 달고, 그 글을 쓴 사람들에게 초대를 보내는 일입니다. 고객의 어시스턴트가 매번 정확하게, 그리고 순서대로 해내야 하는 호출 네 번입니다. 엔드포인트 하나는 같은 일을 한 번만 이름 붙이고 리셀러 자신의 말로 설명한 것입니다.
무엇으로 만들 수 있고 무엇으로는 만들 수 없는가
리셀러 자신의 요금제에 들어 있는 작업만 쓸 수 있습니다. 자체 엔드포인트는 이미 구매한 API를 가로지르는 지름길이지 그 API를 우회하는 길이 아닙니다. 요금제 밖의 것을 지목하는 단계는 엔드포인트를 쓸 때 거부되며, 실행할 때 거부되는 것이 아닙니다.
조건과 반복은 허용되지만 표현식 언어는 허용되지 않습니다. 값은 평범한 JSON이거나 지금까지의 실행에서 읽어 온 경로이고, 조건은 비교입니다. 아무것도 평가되지 않습니다. 고객이 작성하고 저장한 엔드포인트가 제공자의 서버에서 실제 계정을 상대로 실행되기 때문입니다.
호출 한 번이 쓸 수 있는 것
반복이 있으면 엔드포인트는 아무도 의도하지 않은 만큼의 일을 요청할 수 있습니다. 그래서 실행 한 번에는 상한이 있습니다. 작업 수, 반복 횟수, 그리고 시간입니다. 상한에 닿는 것은 오류가 아니라 응답이며, 응답에는 이미 무엇이 이루어졌는지가 적힙니다. 이미 보낸 메시지는 되돌릴 수 없기 때문입니다.
모든 단계는 새 요청으로서 인가되므로, 첫 단계가 만들어 낸 ID는 두 번째 단계가 쓰기 전에 다시 스스로를 증명해야 합니다. 조합한 엔드포인트는 그 안의 작업들이 지닌 검사를 건너뛰는 방법이 아니며, 그 작업들과 같은 속도 조절 예산을 씁니다.
나머지 절반: 우리 것을 빼기
리셀러는 제공하고 싶지 않은 작업을 숨길 수도 있습니다. 숨기면 그 작업은 도구 목록, 매니페스트, 레퍼런스에서 빠집니다. 다만 경로는 여전히 응답하므로, 이미 그것을 호출하고 있는 고객은 한 문장으로 이뤄진 변경 때문에 깨지지 않습니다. 영역 전체를 없애고 싶은 리셀러는 대신 그 영역의 제공을 중단합니다.
자주 묻는 질문
AI 에이전트가 대신 이런 엔드포인트를 써 줄 수 있나요?
보통은 그렇게 합니다. 엔드포인트가 무엇을 해야 하는지, 당신의 작업 중 어느 것을 쓸지 설명하면 어시스턴트가 단계를 쓰고 저장합니다. 당신의 요금제에 없는 작업에 손을 뻗으면 그 작업의 이름과 함께 거부되므로, 잘못된 추측은 저장되지 않고 바로잡힙니다.
자체 엔드포인트는 운영 비용이 더 드나요?
그 안에 든 작업의 비용만큼 듭니다. 동작 네 가지를 수행하는 호출 하나는 같은 동작을 따로 수행하는 호출 네 번과 같은 속도 조절 예산을 씁니다. 각 단계가 저마다 하나의 요청으로 인가되고 속도 조절을 받기 때문입니다.