Data Actions: la tua API come strumento
Trasforma un endpoint che hai già in qualcosa che l'assistente può chiamare.
Data Actions serve per le domande dei clienti a cui nessun documento può rispondere: "dov'è il mio ordine?", "quanti ne restano in magazzino?", "il mio abbonamento è ancora attivo?". La risposta sta nel tuo sistema, dietro un'API. Una Data Action è quell'endpoint, descritto una volta sola, così l'assistente può chiamarlo durante la conversazione e rispondere con il dato reale.
Suggerimento: Non hai un'API tua? Salta questa pagina. L'assistente è completo anche senza: questa funzione è per i team i cui sistemi parlano già HTTP.
Differenza rispetto ad API Connections#
Entrambe danno strumenti all'assistente; cambia chi gestisce il server. API Connections collega un server MCP che esiste già ed espone i propri strumenti. Data Actions serve quando quel server non c'è: descrivi qui i tuoi endpoint e Pommy li presenta all'assistente come strumenti. Se la tua API ha un documento OpenAPI non devi descrivere nulla a mano: importalo e gli endpoint arrivano come gruppo.
Gruppi e azioni#
Le azioni stanno nei gruppi. Un gruppo è un sistema ("API ordini", "Magazzino") con il suo indirizzo base e, se serve, la sua autenticazione. Al suo interno, ogni azione è un singolo endpoint: un nome che l'assistente vede, una descrizione di quando usarlo, il metodo e il percorso, e i parametri. Scrivi la descrizione per l'assistente, non per uno sviluppatore: è l'unica cosa che gli dice *quando* quell'azione è quella giusta.
Aggiungerne una#
- Crea un gruppo
Apri Data Actions nel menu a sinistra e crea un gruppo per il sistema che stai collegando. Indica l'indirizzo base e, se l'API richiede credenziali, aggiungile qui: vengono salvate con il gruppo e non ripetute per ogni azione.
- Aggiungi le azioni o importale
Aggiungi gli endpoint uno per uno oppure usa Import from OpenAPI (importa da OpenAPI) e lascia che Pommy legga il documento. Le azioni importate arrivano disattivate, così puoi controllarle prima che qualcosa vada online.
- Attiva ciò che l'assistente può usare
Ogni azione ha il suo interruttore, e così anche il gruppo. Attiva solo ciò di cui questo assistente ha davvero bisogno: un'azione disattivata per lui è invisibile.
Azioni che devono sapere chi sta chiedendo#
Alcune risposte sono personali: un ordine appartiene a un solo cliente. Un gruppo può essere contrassegnato come con identità obbligatoria, e allora le sue azioni vengono eseguite solo se nella conversazione c'è un visitatore verificato. È questo che impedisce a un estraneo di chiedere informazioni sull'ordine di qualcun altro.
Attenzione: Una Data Action agisce sul tuo sistema reale con le credenziali che hai dato al gruppo. Inizia con endpoint di sola lettura; aggiungi quelli che scrivono dati solo dopo aver visto come si comportano quelli di lettura.
Provarla#
Dopo aver attivato un'azione, fai la domanda che farebbe un cliente, nel widget e con le sue parole, non con il nome dell'endpoint. Se l'assistente risponde con i dati del tuo sistema, la descrizione sta facendo il suo lavoro. Se ignora l'azione, di solito la causa è la descrizione: scrivi chiaramente a cosa risponde l'azione e quando va usata.