개요

이게 뭐죠?

고객 지원 AI 에이전트 플랫폼은 대화 기반 에이전트를 구축하기 위한 API와 웹사이트에 배치할 수 있는 포함 가능한 위젯을 제공합니다. 일반적인 아키텍처는 비밀을 포함하는 서버 코드를 브라우저 코드와 분리하여 단기 위젯 토큰을 발급합니다.

The Companin Widget is more than just a chat interface—it's a complete conversational AI platform that seamlessly integrates into your website. Built with modern web technologies (Next.js, React, TypeScript), it provides enterprise-grade reliability while maintaining simplicity for developers.

Unlike traditional chat widgets that require complex backend setup, Companin handles all the infrastructure for you. Authentication, message storage, conversation management, and AI processing are all managed through our secure API, allowing you to focus on creating great user experiences.

핵심 개념

이러한 핵심 개념을 이해하면 Companin 위젯을 최대한 활용하는 데 도움이 됩니다:

• 에이전트: 구성된 대화형 에이전트.
• 세션: 에이전트와 상호작용하는 방문자를 위한 임시 컨텍스트.
• 위젯 토큰: 브라우저에서 위젯을 인증하기 위한 단기 JWT.
• 인증: JWT 또는 API 키 쌍 헤더(X-API-Key + X-API-Secret).

작동 방식(고급)

1. 서버는 클라이언트 비밀을 보유하고 /api/v1/auth/widget-token을 통해 단기 위젯 토큰으로 교환합니다.
2. 브라우저는 토큰을 수신하고 위젯을 초기화합니다. 위젯은 API 엔드포인트를 호출하기 위해 토큰을 사용합니다.
3. 서버 측 엔드포인트는 JWT 또는 API 키 헤더 쌍을 수락하고 조직 수준의 속도 제한을 적용합니다.

다음 단계

위젯을 포함하기 위해 Quickstart를 따르고, 세부 정보를 위해 API 참조를 참조하세요.