Funzioni del piano a pagamento

Le seguenti funzioni sono disponibili solo per gli utenti di un piano Plus o superiore. Plus

• Integrazione telefonica
• Endpoint privati
• Ricerca
• APIwatsonx Assistant v2
• Webhook di log

L' APIv2 Logs è disponibile con una prova gratuita del piano Plus.

Le seguenti funzioni sono disponibili solo per gli utenti dei piani Enterprise. Enterprise

• Traccia delle attività
• Più ambienti
• Sovrascrivi valori predefiniti di sistema per modalità di risposta
• Invio di eventi al segmento

Il tipo di piano dell'istanza del servizio che stai al momento utilizzando viene visualizzato nell'intestazione della pagina. Puoi eseguire l'upgrade da un tipo di piano a un altro. Per ulteriori informazioni, vedi Esecuzione dell'upgrade.

Spiegazione dei piani basati sull'utente

A differenza dei piani basati sulle API, che misurano l'utilizzo in base al numero di chiamate API effettuate durante un mese, i piani Plus ed Enterprise misurano l'utilizzo in base al numero di utenti attivi mensili.

Un utente attivo mensile (MAU) è un utente unico che ha avuto almeno un'interazione con il vostro assistente o applicazione personalizzata nel corso del mese di fatturazione.

Un utente univoco viene riconosciuto dall'ID utente associato alla persona che interagisce con il tuo assistente. La chat web e altre integrazioni integrate impostano automaticamente questa proprietà.

Puoi calcolare le MAU da solo, sia per IBM Cloud che per IBM Cloud Pak for Data. Per calcolare le MAU, utilizza l'endpoint logs per esportare le conversazioni. Per un mese particolare, contare il numero di ID utente univoci trovati nei risultati. Gli ID utente con più di 50 messaggi (chiamate API) in un mese vengono contati più di una volta ogni 50 messaggi. In un caso di utilizzo comune, in cui ogni ID utente rappresenta un cliente che conversano con un assistente, il numero medio di messaggi per utente è in genere molto inferiore a 50 messaggi, quindi è insolito contare un ID utente più di una volta.

Specifica dell'ID utente con l'API REST

Se stai usando un client personalizzato con l'API watsonx Assistant, devi impostare la proprietà user_id nel payload del messaggio che il tuo client invia al metodo message. La proprietà user_id è specificata nella root del corpo della richiesta, come in questo esempio:

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

In alcune versioni precedenti di SDK, la proprietà user_id non è supportata come parametro del metodo di livello superiore. Come alternativa, è possibile specificare user_id all'interno dell'oggetto context.global.system nidificato.

Per ulteriori informazioni sulla proprietà user_id, consultare la documentazione di riferimento dell'API:

• v2 senza stato /message
• v2 con stato /message

Se l'ID utente non è specificato

Se si sta utilizzando un'applicazione client personalizzata e non si imposta un valore user_id, il servizio lo imposta automaticamente su uno dei seguenti valori:

• session_id (solo API v2 ): Una proprietà definita nell'API v2 che identifica una singola conversazione tra un utente e l'assistente. Un ID di sessione viene fornito nelle chiamate API /message generate dalle integrazioni integrate. La sessione termina quando un utente chiude la finestra di chat o dopo che viene raggiunto il limite di tempo di inattività.

  Se utilizzi l'API message v2 senza stato, devi specificare il session_id con ogni messaggio in una conversazione in corso (in context.global.session_id).

• conversation_id (solo API v1 ): Una proprietà definita nell'API v1 che viene memorizzata nell'oggetto contesto di una chiamata API /message. Questa proprietà può essere utilizzata per identificare più chiamate API /message associate a un singolo scambio di conversazioni con un utente. Tuttavia, lo stesso ID viene utilizzato solo se lo conservi esplicitamente e lo passi con ogni richiesta effettuata come parte della stessa conversazione. Altrimenti, viene generato un nuovo ID per ogni nuova chiamata all'API /message.

Se la stessa persona chatta con il vostro assistente in tre occasioni diverse nello stesso periodo di fatturazione, il modo in cui rappresentate l'utente nella chiamata API influisce sulla fatturazione delle interazioni. Se identifichi l'interazione utente con user_id, conta come un utilizzo. Se si identifica l'interazione dell'utente con un session_id, allora conta come tre utilizzi perché viene creata una sessione separata per ogni interazione.

Progetta le applicazioni personalizzate per acquisire uno user_id o un session_id univoco e passare le informazioni a watsonx Assistant. Scegli un ID non identificabile dalle persone che rimanga invariato durante tutto il ciclo di vita del cliente. Ad esempio, non utilizzare l'indirizzo email di un utente come ID utente. In effetti, la sintassi di user_id deve soddisfare i requisiti per i campi di intestazione definiti nella RFC 7230.

Le integrazioni integrate derivano l'ID utente nei seguenti modi:

• Per le integrazioni Facebook, la proprietà user_id è impostata sull'ID mittente che Facebook fornisce nel suo payload.
• Per le integrazioni Slack, la proprietà user_id Slack è una concatenazione di ID team, ad esempio T09LVDR7Y, e di ID membro dell'utente, ad esempio W4F8K9JNF. Ad esempio, T09LVDR7YW4F8K9JNF.
• Per la chat web, puoi impostare il valore della proprietà user_id.

La fatturazione viene gestita per utente attivo mensilmente per istanza del servizio. Se un singolo utente interagisce con gli assistenti ospitati da diverse istanze del servizio che appartengono allo stesso piano, ogni interazione viene gestita come un utilizzo separato. Ti viene addebitata separatamente l'interazione dell'utente con ogni istanza del servizio.

Gestione degli utenti anonimi

Se il tuo assistente o la tua applicazione personalizzata interagisce con utenti anonimi, puoi generare un ID univoco universalmente casuale per rappresentare ogni utente anonimo. Per ulteriori informazioni sugli UUID, vedere RFC 4122.

• Per la chat web, se non passi un identificativo per l'utente quando inizia la sessione, la chat web ne crea uno per te. Crea un cookie del produttore con un ID anonimo generato. Il cookie rimane attivo per 45 giorni. Se lo stesso utente ritorna sul tuo sito successivamente nel mese e conversa di nuovo con il tuo assistente, l'integrazione chat web lo riconosce. E quando lo stesso utente anonimo interagisce con il tuo assistente più volte in un singolo mese, avrai un unico addebito.

Se un utente anonimo esegue l'accesso e successivamente viene identificato come la stessa persona che ha inoltrato una richiesta con un ID sconosciuto, l'addebito verrà effettuato due volte. Ogni messaggio con un ID utente univoco viene addebitato come un utente attivo indipendente. Per evitare questa situazione, è possibile richiedere agli utenti di accedere prima di avviare una chat. Oppure, è possibile utilizzare l'ID utente anonimo per rappresentare l'utente in modo congruente.

Data center

IBM Cloud ha una rete di data center globali che fornisce benefici prestazionali sui propri servizi cloud. Per ulteriori dettagli, vedi IBM Cloud data center globali.

Puoi creare delle istanze del servizio watsonx Assistant che vengono ospitate nelle seguenti ubicazioni data center: