에이전트 API

API 섹션은 Endue 밖의 무언가가 이 에이전트를 부를 수 있는 키를 발급합니다. 대화·채널에 이은 세 번째 진입로이고, 이쪽은 프로그램용입니다.

언제 쓰는가

부르는 쪽이 코드일 때입니다. 매일 요약을 남기는 스크립트, 분류를 맡기는 백엔드, CI 에서 도는 잡 같은 것들이죠. 부르는 쪽이 사람이라면 채널이 낫습니다 — 실과 질문과 승인을 함께 주니까요.

여기서 만든 키는 이 에이전트로 제한됩니다. 다른 에이전트를 부르는 데 쓸 수 없습니다. 계정 전체 키는 설정 → 계정에서 따로 발급하는데, 가능하면 좁은 쪽을 쓰세요.

키를 Authorization: Bearer sk_…(또는 X-API-Key)로 보내고, 시킬 일을 담아 요청합니다.

POST /api/public/v1/agents/{agent_id}/invoke
Authorization: Bearer sk_...
Content-Type: application/json

{ "input": "어제 들어온 문의 요약해줘" }

응답에는 에이전트의 답과 함께 세션 id 가 담깁니다. 다음 호출에 그 id 를 돌려보내면 새로 시작하는 대신 같은 맥락 — 기록이 있는 같은 대화 — 에서 이어갑니다.

{ "input": "이제 제품 영역별로 묶어줘", "session_id": "..." }

"stream": true 를 주면 실행이 끝나기를 기다리지 않고 생성되는 대로 답을 받습니다.

API 호출자는 대화 앞에 앉아 있지 않으므로 지켜보는 사람이 없는 실행으로 취급됩니다.

판단이 필요 없을 만큼 요청을 정확히 쓰고, 발송이 아니라 초안을 기대하세요.