Strumenti e competenze
Gestisci gli strumenti di runtime e associa istruzioni riutilizzabili a un Assistente.
Apri un Assistente e seleziona Tools & Skills. Questa sezione controlla le funzionalità di runtime e le istruzioni riutilizzabili.
Strumenti integrati
| Tool | Default | Comportamento attuale |
|---|---|---|
| Search knowledge | On | Cerca nella Knowledge collegata e restituisce risposte con citazioni. |
| Session memory | On | Utilizza le informazioni della sessione di conversazione corrente. |
| Fetch URL | Off | Legge un URL quando il runtime seleziona lo strumento. |
| Interactive tables | Off | Mostra i dati come una tabella semplice, una griglia dei record CRM o una tabella delle attività con filtri di stato. |
La funzionalità Search knowledge è sempre disponibile. Puoi abilitare o disabilitare gli altri strumenti integrati.
Interactive tables organizza i fatti che l'Assistente ha trovato in questa risposta. Il runtime seleziona la tabella in base alla tua richiesta e ai dati disponibili.
- Una tabella semplice confronta i fatti e può includere domande di follow-up per le righe.
- Una griglia dei record CRM mostra le aziende, le categorie, l'ultima interazione, lo stato della relazione e i link ai siti web. Seleziona le righe, ordina, ridimensiona o fissa le colonne.
- Una tabella delle attività mostra le date, lo stato e i proprietari. Seleziona All, To do, In Progress o Completed per filtrare le relative righe.
I conteggi dei filtri derivano dai dati visualizzati. I dati mancanti rimangono vuoti. Le impostazioni della tabella influiscono sulla visualizzazione corrente e non modificano i record del CRM.
Usa New property o Add calculation nella griglia CRM per preparare una richiesta di proprietà. Rivedi il suo prompt, quindi seleziona Go calculate. Questo invia una normale richiesta di chat. L'harness corrente, le fonti connesse e le autorizzazioni continuano ad applicarsi. L'interfaccia utente non simula i valori generati.
Le stesse tabelle vengono visualizzate in Preview, nel Widget pubblicato e nella trascrizione dell'Inbox. Pubblica l'Assistente dopo aver abilitato questo strumento. L'Inbox supporta la visualizzazione, la selezione, il filtraggio e il layout delle colonne. Non invia richieste di proprietà.
L'Assistente può aggiungere una domanda di follow-up a una riga. Il Visitor seleziona la riga per porre quella domanda. La trascrizione dell'Inbox mostra queste righe, ma un Member non può selezionarle.
Abilita la modalità di studio
Study Mode è disattivato per impostazione predefinita. Attivalo per consentire ai Visitatori di esercitarsi con la Knowledge dell'Assistente tramite esercizi interattivi.
- Apri Tools & Skills e abilita Study Mode.
- Abilita almeno un formato di domanda.
- Aggiungi Custom instructions per impostare lo stile di insegnamento.
- Prova un esercizio in Preview.
- Pubblica l'Assistente per aggiornare il Widget.
Il chat composer mostra un pulsante Study exercises. Seleziona un formato, aggiungi un argomento, quindi invia la richiesta.
Quando è abilitato, Study Mode compare anche in Flows. Il pulsante Settings apre questa sezione. Disattiva la Modalità di studio in Tools & Skills. Il Flow non ha un interruttore separato. Le richieste dal menu Study exercises vanno direttamente a questo Flow. In Thinking viene visualizzata l'icona di un tocco accademico.
Gli esercizi richiedono materiale pertinente nella Knowledge dell'Assistente. Se non viene trovato alcun materiale, l'Assistente ti chiede un argomento supportato o del materiale di studio.
| Format | Come risponde il Visitor |
|---|---|
| Multiple choice | Seleziona una sola opzione. Non è disponibile alcuna risposta a testo libero. |
| Drag the words | Trascina o seleziona una parola per completare uno spazio vuoto per ogni domanda. |
| True / False | Seleziona una delle due opzioni. |
| Flashcards | Digita la parola mancante o una breve espressione. |
Choose for me seleziona un formato abilitato. Ogni esercizio contiene al massimo cinque domande distinte basate sulle Knowledge recuperate.
Seleziona Check per salvare una risposta. Ciele mostra se la risposta è corretta, qual è la risposta corretta e una spiegazione. Non puoi modificare una risposta già inviata. Le flashcard accettano le varianti ortografiche definite al momento della creazione dell'esercizio.
La Inbox mostra le domande, le risposte inviate, le risposte corrette e il punteggio. Gli esercizi non completati mostrano quante domande sono ancora senza risposta. Gli esercizi vengono eseguiti all'interno della chat. Non richiedono un lettore H5P esterno.
Configura un'integrazione API
Un Assistente può utilizzare una sola integrazione API registrata. L'integrazione contiene un base URL, una credenziale protetta e degli endpoint descritti.
Per ogni endpoint, definisci il metodo, il percorso, lo scopo, i parametri e la forma della risposta. Il runtime convalida ogni path richiesto confrontandolo con questo catalogo.
L'agent può esaminare i dettagli dell'endpoint prima di inviare una richiesta. Le risposte di grandi dimensioni rimangono disponibili tramite letture a finestra.
Control the endpoint catalogue
Add only the endpoints that the Assistant must use. The runtime cannot call an unregistered path through this integration.
Impedisci una scrittura duplicata
Puoi inviare nuovamente una richiesta dopo un timeout o un errore. Se l'endpoint scrive dati, la seconda richiesta può creare un secondo record.
Per evitare questo problema, assegna all'endpoint una idempotency key. Nel modulo dell'endpoint, indica dove la tua API legge la chiave:
header:Idempotency-Keyinvia la chiave in un header della richiesta.body:request_idinvia la chiave nel corpo JSON.
Usa il nome che la tua API legge. Ciele non tenta di indovinare questo nome. API diverse leggono nomi diversi.
Ciele genera una chiave per ogni chiamata. Un nuovo tentativo della stessa chiamata invia la stessa chiave. Una chiamata diversa invia una chiave diversa. La tua API può quindi considerare le due richieste come una singola operazione di scrittura.
Anche la tua API deve fare la sua parte. Deve memorizzare la chiave e restituire il primo risultato quando rileva nuovamente la chiave.
An endpoint with no key is not protected
If you give no key, a retry of the call can write two times. A GET endpoint does not need a key, because a read does not change data.
Associa una Skill dell'organizzazione
Una Skill è un modello di istruzioni riutilizzabile. Un'organizzazione può associare la stessa Skill a più Assistenti.
- Apri Tools & Skills.
- Trova la Organization Skill richiesta.
- Collega la Skill all'Assistente.
- Verifica il risultato in Preview.
- Pubblica l'Assistente quando il risultato è corretto.
Le modifiche alle Skill sono immediatamente disponibili in Preview. Il Widget pubblicato utilizza l'ultimo snapshot di Publication.
Consenti alle persone di avviare una Skill dalla finestra di chat
Una Skill può avere un Opening line. Scrivilo dal punto di vista della persona che pone la domanda, non dell'Assistente.
La finestra di chat mostra un menu / con ogni Skill che ha una opening line. Quando l'utente seleziona una Skill, la finestra di chat inserisce la opening line nella casella dei messaggi. Puoi modificare il testo prima di inviarlo.
Se la opening line è vuota, la Skill non viene visualizzata nel menu /. Per i set di Skill brevi (fino a 4.000 caratteri in totale), inserisci le istruzioni per ogni risposta. Per i set più lunghi, il modello visualizza i nomi e le descrizioni e carica i playbook corrispondenti su richiesta. Fornisci a ogni Skill una descrizione chiara di quando si applica.
Pubblica l'Assistente dopo aver scritto una riga di apertura. Il Widget utilizza l'ultimo snapshot di Publication.
Gli allegati e la Knowledge non sono la stessa cosa
Sia un allegato sia una Knowledge Source diventano testo, e Ciele li legge entrambi con lo stesso extractor. Quello che accade dopo è diverso.
Una Knowledge Source è permanente. Ciele ne memorizza il testo, lo indicizza e l'Assistente può citarlo in ogni conversazione successiva.
Un allegato appartiene alla sua conversazione. Ciele lo legge una sola volta, scarta i byte e non lo aggiunge mai alla Library. Nessun'altra conversazione lo vede.
Per rendere permanente un file, aggiungilo invece in Library.
Verifica la configurazione
Poni una domanda che richieda ciascuno degli strumenti abilitati. Prima di pubblicare, controlla il pannello Thinking e le Sources.
Per i dati strutturati, esegui il test di una ricerca esatta per attributo e di una ricerca testuale. Prova l'accesso con ambito utente utilizzando due account diversi con cui hai effettuato l'accesso.