탐색
get_api_document현재 작업에 필요한 정확한 API 계약을 불러옵니다.
제품의 핵심 작업을 API로 공개하고 해당 문서를 채팅에 연결하면 AgentChat이 이를 에이전트 기능으로 전환합니다. 기능마다 맞춤형 도구를 통합할 필요가 없습니다.
POST/storiesPOST/imagesGET/documents/searchget_api_document()
http_request()
sleep()
view_image()
핵심 아이디어
기존 에이전트는 모든 작업마다 맞춤형 도구 정의가 필요합니다. AgentChat은 API 문서와 범용 HTTP 실행기를 사용하므로, 기능은 에이전트 코드가 아니라 API 범위에 따라 확장됩니다.
get_api_document현재 작업에 필요한 정확한 API 계약을 불러옵니다.
http_request문서화된 모든 HTTP 엔드포인트를 호출하고 구조화된 결과를 받습니다.
sleep비동기 작업 생성과 상태 폴링 사이에 일시 중지합니다.
view_image크리에이티브 또는 미디어 API에서 반환된 이미지 URL을 확인합니다.
통합 모델
API는 제품이 이미 수행하고 있는 작업을 제어하는 래퍼입니다. 에이전트가 API를 호출하면 SaaS는 동일한 데이터베이스를 읽고 결과를 자연스럽게 표시합니다.
제품 데이터베이스와 비즈니스 작업을 처리하는 API를 등록하세요. 등록된 API는 에이전트가 사용할 수 있는 기능이 됩니다.
해당 채팅에 필요한 문서만 연결하고, 모델을 선택한 다음 현재 사용자 또는 테넌트에 사용할 헤더를 추가하세요.
에이전트는 여러분의 API를 통해 작동합니다. 애플리케이션은 자체 데이터베이스를 읽고 새로 생성되거나 업데이트된 데이터를 평소처럼 표시합니다.
실제 제품 패턴
채팅을 만들 때 검색 API 문서를 하나 첨부하세요. 에이전트는 관련 문단을 검색하고, 이를 바탕으로 추론한 뒤, 애플리케이션의 비공개 지식을 활용해 답변할 수 있습니다.
GET /documents/search?q=...
→ {
"results": [
{ "text": "...", "source": "..." }
]
} 스토리 작성 API와 이미지 생성 API를 제공하세요. 에이전트는 챕터를 작성하고, 프롬프트를 바탕으로 일러스트를 생성하며, 두 결과물을 모두 API를 통해 저장합니다. 스토리 앱은 자체 데이터베이스에서 이를 표시합니다.
테넌트 인식 보안
각 채팅에 호스트별 헤더를 구성하세요. API는 현재 사용자 또는 테넌트의 자격 증명을 받고, 자체 권한 부여 규칙을 적용한 다음 해당 사용자가 액세스할 수 있는 데이터만 반환합니다.
X-Tenant-ID: tenant_a테넌트 A의 데이터만 검색하고 수정할 수 있습니다.
X-Tenant-ID: tenant_b테넌트 B 권한으로 동일한 API 계약을 사용합니다.
개발자 API
API 문서를 등록한 다음 이를 참조하는 채팅 세션을 생성하세요. 제품은 동일한 API를 통해 실행을 시작하고 영속 메시지를 폴링할 수 있습니다.
개발자 대시보드 열기 →AgentChat