유료 플랜 기능

다음 기능은 플러스 플랜 이상의 사용자만 이용할 수 있습니다. Plus

• 전화 통합
• 개인용 엔드포인트
• 검색
• watsonx Assistant v2 API
• 로그 웹훅

v2 Logs API 는 Plus 플랜의 무료 평가판에서 사용 가능합니다.

다음 기능은 엔터프라이즈 플랜의 사용자만 사용할 수 있습니다. Enterprise

• 활동 추적
• 다중 환경
• 응답 모드에 대한 시스템 기본값 대체
• 세그먼트에 이벤트 전송

현재 사용 중인 서비스 인스턴스의 플랜 유형이 페이지 헤더에 표시됩니다. 한 플랜 유형에서 다른 플랜 유형으로 업그레이드할 수 있습니다. 자세한 정보는 업그레이드를 참조하십시오.

사용자 기반 플랜 설명

한 달 동안 작성된 API 호출 수로 사용량을 측정하는 API 기반 계획과 달리, Plus 및 Enterprise 플랜은 월별 활성 사용자 수를 기준으로 사용량을 측정합니다.

월간 활성 사용자(MAU)는 해당 달에 어시스턴트 또는 사용자 지정 애플리케이션과 최소 한 번 이상 상호 작용한 고유 사용자를 말합니다.

고유 사용자는 어시스턴트와 상호작용하는 사용자와 연관된 사용자 ID로 인식됩니다. 웹 대화 및 기타 기본 제공 통합에서는 이 특성을 자동으로 설정합니다.

IBM Cloud 및 IBM Cloud Pak for Data모두에 대해 사용자가 직접 MAU를 계산할 수 있습니다. MAU를 계산하려면 logs 엔드포인트를 사용하여 대화를 내보내십시오. 특정 월에 대해 결과에서 찾은 고유 사용자 ID수를 계산하십시오. 한 달에 50개가 넘는 메시지 (API 호출) 가 있는 사용자 ID는 50개의 메시지마다 두 번 이상 계수됩니다. 각 사용자 ID가 어시스턴트와 대화하는 고객을 나타내는 공통 유스 케이스에서 사용자당 평균 메시지 수는 일반적으로 50개미만이므로 사용자 ID를 두 번 이상 계수하는 것은 일반적이지 않습니다.

REST API를 사용하여 사용자 ID 지정

watsonx Assistant API를 사용하여 사용자 정의 클라이언트를 사용하는 경우 클라이언트가 message 메소드에 전송하는 메시지 페이로드에서 user_id 특성을 설정해야 합니다. 다음 예제와 같이 user_id 특성은 요청 본문의 루트에 지정됩니다.

{
  "input": {
    "message_type": "text",
    "text": "I want to cancel my order"
  },
  "user_id": "my_user_id"
}

일부 이전 SDK 버전에서는 user_id 특성이 최상위 레벨 메소드 매개변수로 지원되지 않습니다. 대신, 중첩된 context.global.system 오브젝트 내에서 user_id을(를) 지정할 수 있습니다.

user_id 특성에 대한 자세한 정보는 API 참조 문서를 참조하십시오.

• v2 Stateless /message
• v2 상태 정보 /message

사용자 ID가 지정되지 않은 경우

사용자 정의 클라이언트 애플리케이션을 사용 중이고 user_id 값을 설정하지 않은 경우 서비스는 자동으로 다음 값 중 하나로 설정합니다.

• session_id(v2 API 전용): 사용자와 어시스턴트 사이의 단일 대화를 식별하는 v2 API에 정의된 특성입니다. 세션 ID는 기본 제공 통합에서 생성된 /message API 호출에서 제공됩니다. 사용자가 대화 창을 닫거나 비활성 시간 한계에 도달하면 세션이 종료됩니다.

  Stateless v2 message API를 사용하는 경우에는 진행 중인 대화의 각 메시지에 session_id를 지정해야 합니다(위치는 context.global.session_id).

• conversation_id v1 전용 ): v1 정의된 속성으로, 컨텍스트 객체에 저장되어 있는 /message API 호출의 컨텍스트 객체에 저장되어 있는 속성입니다. 이 특성은 한 사용자와의 단일 대화 교환과 연관된 다중 /message API 호출을 식별하는 데 사용될 수 있습니다. 그러나 명시적으로 ID를 보유하고 동일한 대화의 일부로 수행된 각 요청과 함께 다시 전달하는 경우에만 동일한 ID가 사용됩니다. 그렇지 않으면 새 /message API 호출마다 새 ID가 생성됩니다.

동일한 사용자가 동일한 청구 기간 동안 세 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 번에 걸쳐 여러 user_id로 사용자 상호작용을 식별하는 경우에는 한 번의 사용으로 계산됩니다. session_id 로 사용자 상호작용을 식별할 경우, 상호작용마다 별도의 세션이 생성되기 때문에 세 번의 사용으로 간주됩니다.

고유한 user_id 또는 session_id를 캡처하도록 사용자 정의 애플리케이션을 설계하고 정보를 watsonx Assistant으로 전달하십시오. 고객 라이프사이클 동안 변경되지 않는 non-human-identifiable ID를 선택하십시오. 예를 들면, 사용자의 이메일 주소를 사용자 ID로 사용하지 마십시오. 사실, user_id 의 구문은 RFC 7230 에 정의된 헤더 필드의 요구 사항을 충족해야 합니다.

기본 제공 통합은 다음 방법으로 사용자 ID를 도출합니다.

• Facebook 통합의 경우에는 Facebook이 페이로드에 제공하는 발신인 ID로 user_id 특성이 설정됩니다.
• Slack 통합의 경우에는 user_id 특성이 T09LVDR7Y와 같은 팀 ID와, W4F8K9JNF와 같은 사용자의 구성원 ID의 연결입니다. 예: T09LVDR7YW4F8K9JNF.
• 웹 대화의 경우에는 사용자가 user_id 특성을 설정할 수 있습니다.

청구는 서비스 인스턴스당 월별 활성 사용자별로 관리됩니다. 단일 사용자가 동일한 플랜에 속하는 서로 다른 서비스 인스턴스에 의해 호스팅되는 어시스턴트와 상호작용하는 경우, 각 상호작용은 별도의 사용으로 처리됩니다. 각 서비스 인스턴스와의 사용자 상호작용에 대한 요금이 별도로 청구됩니다.

익명 사용자 처리

사용자 정의 애플리케이션 또는 어시스턴트가 익명의 사용자와 상호작용하는 경우에는 각 익명 사용자를 나타내기 위해 무작위 범용 고유 ID를 생성할 수 있습니다. UUID에 대한 자세한 정보는 RFC 4122를 참조하십시오.

• 웹 대화의 경우에는 세션이 시작될 때 사용자의 ID를 전달하지 않으면 웹 대화가 사용자를 대신하여 이를 작성합니다. 웹 대화는 생성된 익명 ID를 포함하는 퍼스트파티 쿠키를 작성합니다. 이 쿠키는 45일간 활성 상태로 유지됩니다. 해당 월 내에 동일한 사용자가 나중에 다시 사이트로 돌아와 어시스턴트와 다시 대화하는 경우 웹 대화 통합은 이 사용자를 인식합니다. 그리고 동일한 익명의 사용자가 한 달에 여러 번 어시스턴트와 상호작용하는 경우 비용은 한 번만 청구됩니다.

익명의 사용자가 로그인한 후 나중에 알려진 ID를 사용하여 요청을 제출한 사용자와 동일한 사용자로 식별되면 두 번 청구됩니다. 고유한 사용자 ID의 각 메시지는 독립적인 활성 사용자로 청구됩니다. 이 상황을 방지하기 위해 대화를 시작하기 전에 사용자에게 로그인하도록 프롬프트할 수 있습니다. 또는 익명 사용자 ID를 사용하여 사용자를 일관되게 표시할 수 있습니다.

데이터 센터

IBM Cloud에는 클라우드 서비스에 성능 이점을 제공하는 글로벌 데이터 센터의 네트워크가 있습니다. 자세한 내용은 IBM Cloud 글로벌 데이터 센터를 참조하십시오.

다음 데이터 센터 위치에서 호스팅되는 watsonx Assistant 서비스 인스턴스를 작성할 수 있습니다.