Framework competenze e integrazioni skills-and-integrations
Un’integrazione (precedentemente nota come strumento) è una connessione a un’origine dati o a un back-end. Un’abilità è un comportamento.
Un’integrazione può essere utilizzata da molte abilità. Un’abilità può utilizzare diverse integrazioni. Puoi configurarli in modo indipendente e mapparli insieme.
Competenza
Un’abilità è il livello di comportamento di un portinaio. Si tratta di un’unità riutilizzabile denominata che definisce un singolo lavoro che il portinaio può svolgere: ciò che gestisce, quando esegue il passaggio e come risponde. Un’abilità non contiene dati propri; prende in prestito la funzionalità dalle integrazioni ad essa associate.
Ogni abilità è composta da cinque parti:
Funzionamento di un’abilità in fase di runtime: quando arriva un messaggio utente, la piattaforma lo confronta con l’attivazione “use when” di ogni abilità attiva e indirizza il messaggio all’abilità corrispondente. Tale abilità esegue quindi le sue istruzioni e chiama solo le integrazioni associate. Le sue istruzioni sono composte nel comportamento di runtime complessivo del concierge, insieme al profilo del marchio e a qualsiasi altra abilità attiva.
Un’abilità decide cosa fare e quando. Non si connette ad alcun dato; questo è il ruolo dell’integrazione.
Esempio dell’abilità di Site Advisory
Integrazioni
Un’integrazione è il livello di capacità di un portinaio. Si tratta di una connessione a un sistema esterno o back-end (una knowledge base, un’origine di contenuto, un catalogo live commerce) che recupera effettivamente i dati o esegue un’azione. Quando un’abilità è giudizio, un’integrazione è capacità.
Ogni integrazione presenta le seguenti caratteristiche:
Funzionamento di un’integrazione in fase di runtime: quando un’abilità viene attivata e decide di aver bisogno di dati, chiama uno degli strumenti dell’integrazione. L’integrazione esegue tale chiamata sul back-end live e restituisce all’abilità i dati strutturati, che l’abilità utilizza per formare la propria risposta.
Un’integrazione fornisce capacità ma non esercita alcun giudizio. Aspetta di essere chiamato da un’abilità, fa il lavoro specifico richiesto di esso, e restituisce il risultato.
Capacità e limiti (il limite self-service)
-
Autonomo, nessun intervento tecnico: Modificare le istruzioni, modificare i trigger “usa quando”, allegare o scollegare integrazioni esistenti, abilitare o disabilitare un’abilità e connettere un’integrazione supportata (come Commerce MCP con credenziali valide).
-
Non self-service, richiede progettazione: Crea uno strumento o un connettore nuovo che non esiste già nel catalogo, aggiungi una nuova categoria di guardrail non supportata dal framework o modifica i dati esposti da un backend.
-
La sovrapposizione dei trigger tra due abilità comporta un rischio di configurazione: Se è plausibile che due abilità vengano attivate sullo stesso messaggio, il routing potrebbe essere incoerente. Scrivere i trigger per evitare l’ambiguità reale anziché affidarsi al router per risolverla.
Integrazioni disponibili e pronte all’uso
Di seguito sono riportate le integrazioni mostrate nel pannello Sfoglia integrazioni di Composer.
Abilità disponibili pronte all’uso
Di seguito sono riportate le abilità mostrate nel pannello Sfoglia abilità del Compositore. Ciascuno elenca le sue integrazioni consigliate.
Le due competenze di commerce sono funzionalità di sola lettura e dipendono dall’integrazione MCP di Commerce, che non fa parte della linea di base. In un concierge non-commerce, Site Advisory e Product Advisory vengono eseguiti contro la Knowledge Base Search creata automaticamente.
Cosa viene cablato nella creazione del portinaio
Quando un portinaio viene creato mediante una configurazione con un solo clic, la linea di base viene assemblata automaticamente.
Domande frequenti
Qual è la differenza tra un’abilità e un’integrazione?
Un’integrazione è una connessione a un’origine dati o a un back-end; è ciò a cui il concierge può rivolgersi, ad esempio una knowledge base o un catalogo live commerce. Un’abilità è un comportamento; decide cosa fa il portinaio, quando lo fa, e quali integrazioni può usare.
Regola generale: un’integrazione è una funzionalità; un’abilità è il giudizio su quando e come utilizzare tale funzionalità.
La stessa integrazione può essere utilizzata da più di un’abilità?
Sì, e questo è intenzionale. Gli strumenti di Commerce MCP sono condivisi tra Catalog Discovery e Product Comparison. La creazione di un’integrazione una volta e il suo riutilizzo in molte competenze e molti clienti è l’efficienza principale del framework 2.0; è ciò che rimuove la build personalizzata per cliente.
Un professionista può aggiungere una funzionalità completamente nuova senza ricorrere alla progettazione?
Solo se un’integrazione per essa esiste già nel catalogo. Un professionista può mappare, configurare e istruire liberamente qualsiasi integrazione esistente; questo è self-service. Tuttavia, se la funzionalità richiede un back-end o un connettore non ancora esistente (una nuova API o un nuovo tipo di origine dati), si tratta di un’attività tecnica per creare prima l’integrazione. Una volta che esiste nel catalogo, la sua configurazione diventa nuovamente self-service.
Differenza rispetto al prompt di sistema di BC 1.0?
Nella versione 1.0, il comportamento era guidato da un grande prompt di sistema (il manifesto), che era difficile da modificare in modo sicuro e in genere richiedeva modifiche tecniche. In 2.0 il manifesto esiste ancora, ma è composto da pezzi modulari piuttosto che scritto come un blocco. Questo è ciò che rende il comportamento configurabile da un professionista e rende i singoli guardrail e le istruzioni leggibili e controllabili invece di essere sepolti in un unico prompt.
Cosa crea esattamente la scansiona anticipata?
Il scansiono crea una knowledge base, un archivio ricercabile del contenuto del sito, creato dalle prime 10 alle 15 pagine trovate tramite sitemap. Questo è solo il livello dati. Il scansiono non crea un’abilità o un’integrazione, ma produce il contenuto su cui successivamente agiscono.
Se la scansiona crea la Knowledge Base, qual è l’integrazione della Knowledge Base Search?
La ricerca nella knowledge base è un’integrazione integrata il cui compito è quello di effettuare ricerche in tale knowledge base. La knowledge base è costituita dai dati; la funzione di ricerca della knowledge base è la funzionalità che consente di eseguire query. Sono due cose separate: una è il contenuto, l’altra è lo strumento che legge il contenuto. È un errore comune trattarli come se fossero la stessa cosa; non lo sono.
Come risponde il portinaio a una domanda generale al momento della creazione, end-to-end?
Tre livelli funzionano in sequenza e si mappano esattamente sull’abilità, l’integrazione e il modello dati:
- Il scansiono anticipato crea la knowledge base dalle pagine (dati) del sito.
- L’integrazione integrata di Knowledge Base Search esegue la ricerca in tale knowledge base (integrazione).
- L’abilità Site Advisory è stata creata per chiamare la ricerca della knowledge base (comportamento).