watsonx Assistant API 개요

watsonx Assistant REST API 및 해당 SDK를 사용하여 서비스와 상호작용하는 애플리케이션을 개발할 수 있습니다.

클라이언트 애플리케이션

런타임에 어시스턴트와 통신하는 가상 어시스턴트 또는 기타 클라이언트 애플리케이션을 구축하려면 v2 API를 사용하세요. 프로덕션 사용을 위해 배치할 수 있는 고객 상대 클라이언트, 어시스턴트와 다른 서비스 간의 통신을 중개하는 애플리케이션 또는 테스트 애플리케이션을 개발할 수 있습니다.

어시스턴트와 통신하기 위해 v2 런타임 API를 사용하면 애플리케이션이 다음과 같은 기능을 활용할 수 있습니다.

  • 자동 상태 관리. v2 런타임 API는 사용자와의 각 세션을 관리하여 어시스턴트가 완전한 대화를 위해 필요한 모든 컨텍스트 데이터를 저장하고 유지합니다.

  • 어시스턴트를 쉽게 배치할 수 있습니다. 사용자 정의 클라이언트를 지원하는 것 외에도, Slack 및 Facebook Messenger와 같은 유명한 메시징 채널에 어시스턴트를 쉽게 배치할 수 있다.

  • 버전화 콘텐츠의 스냅샷을 저장하고 어시스턴트를 해당 특정 버전에 연결할 수 있습니다. 그런 다음 프로덕션 어시스턴트에 영향을 주지 않고 개발 버전을 계속 업데이트할 수 있습니다.

  • 검색 기능. v2 런타임 API를 사용하여 검색 통합에서 응답을 수신할 수 있습니다. 어시스턴트가 응답할 수 없는 조회가 제출되면 검색 통합이 구성된 데이터 소스에서 최상의 응답을 찾을 수 있습니다.

자세한 정보는 watsonx Assistant v2 API 참조를 참조하십시오.

watsonx Assistant v1 API는 대화창에서 사용하는 작업 영역으로 사용자 입력을 직접 보내는 /message 메서드를 지원합니다. v1 런타임 API는 주로 호환성을 위해 지원됩니다. v1 /message 메소드를 사용하는 경우 자체적인 상태 관리를 구현해야 하며 어시스턴트의 버전화 기능 또는 기타 기능을 이용할 수 없습니다.

작성 애플리케이션

v1 API는 기존 Watson Assistant 사용자 인터페이스를 사용하여 그래픽으로 스킬을 구축하는 대신 애플리케이션이 대화 스킬을 만들거나 수정할 수 있는 메서드를 제공합니다. 작성 애플리케이션은 API를 사용하여 스킬, 인텐트, 엔티티, 대화 노드 및 대화 스킬을 구성하는 기타 아티팩트를 작성하고 수정합니다. 자세한 내용은 v1 API 참조를 참조 하세요.

v1 작성 방법은 스킬이 아닌 작업 영역을 만들고 수정합니다. 작업공간은 대화 스킬 내의 대화 및 훈련 데이터(예: 인텐트 및 엔티티)에 대한 컨테이너입니다. API를 사용하여 새 워크스페이스를 만들면 클래식 Watson Assistant 사용자 인터페이스에 새 대화 스킬로 표시됩니다.

사용 가능한 API 메소드의 목록은 API 메소드 요약을 참조하십시오.