Strumenti API personalizzati

Gli strumenti API personalizzati sono la storia del "collega qualsiasi cosa" di AnyBot. Quando un sistema non ha un'integrazione integrata in questa pagina, punta invece un agente verso la sua API REST: dagli un base URL, scegli gli endpoint, e ognuno diventa uno strumento che l'agente può richiamare a metà conversazione per recuperare dati o attivare un'azione, senza codice personalizzato.

Quando ricorrervi

• Nessuna integrazione integrata copre il sistema, un servizio interno, un SaaS di nicchia o il tuo backend.
• Esponi già un'API REST (o una specifica OpenAPI/Swagger) e vuoi che l'agente la usi.
• Vuoi che l'agente legga dati in tempo reale o attivi un'azione che risiede dietro un tuo endpoint.

Se esiste già un'integrazione di prima classe, CRM, Commerce, Notion, Ricerca web, ricorri prima a quella. È mantenuta per te ed è già consapevole della privacy, così eviti la configurazione dello schema e dell'autenticazione.

Come si collega (la versione breve)

1. Apri Integrazioni, scegli Custom API e dagli un base URL.
2. Importa una specifica OpenAPI/Swagger (tramite URL o incollandola) per scoprire automaticamente gli endpoint, oppure configura gli strumenti a mano.
3. Imposta l'autenticazione, Bearer, Basic, API Key o nessuna.
4. Scegli quali endpoint esporre, testa ognuno nel pannello integrato, poi Connetti.

Il vero trabocchetto: l'agente può raggiungere solo ciò che esponi. Importare una specifica elenca ogni endpoint che trova, ma solo quelli che selezioni diventano strumenti, e riprocessare la specifica in seguito recepisce le modifiche dell'API senza doverla ricostruire da zero.

Pubblico vs privato, per singolo strumento

Le integrazioni integrate arrivano con una suddivisione fissa public-safe/owner-only. Gli strumenti personalizzati ribaltano tutto: scegli tu la visibilità per ogni strumento, Public (public-safe, un visitatore del sito può attivarlo), Private (owner-only, solo canali interni) o Both. Rendi Public le ricerche sicure di sola lettura; tieni Private tutto ciò che scrive o tocca dati sensibili.

Poiché gli strumenti sono definiti per singola istanza, non c'è un elenco o un conteggio fisso, la superficie è esattamente ciò che costruisci.

Esempio pratico

I tuoi ordini risiedono in un servizio interno senza integrazione integrata. Punti uno strumento API personalizzato verso https://api.internal.example.com, importi la sua specifica OpenAPI ed esponi un endpoint di sola lettura, get_order_status, come strumento Public. Un visitatore chiede "dov'è l'ordine 4821?" e l'agente lo richiama e risponde con lo stato in tempo reale. Tieni l'endpoint di rimborso Private, così solo i canali rivolti allo staff possono raggiungerlo.

Limiti

• Solo in uscita. L'agente chiama la tua API; la tua API non chiama l'agente.
• L'agente usa le credenziali che configuri; non può mai superare ciò che quella chiave API è autorizzata a fare.
• Rimuovere l'integrazione si limita a scollegare gli strumenti, nessuna modifica viene apportata alla tua API esterna.

Risoluzione dei problemi

• La specifica non viene processata. Verifica che sia un OpenAPI/Swagger valido e raggiungibile; incolla il contenuto grezzo se l'URL è protetto.
• Autenticazione fallita. Ricontrolla il token, il suo prefisso e se la chiave va in un header o in un parametro della query.
• L'agente non richiama lo strumento. Assicurati che l'endpoint sia selezionato/esposto e che la sua visibilità corrisponda al canale, uno strumento Private non si attiva su un bot pubblico.

FAQ

Devo scrivere del codice? No. Collega un'API REST tramite specifica o a mano, nessun codice richiesto.

Può chiamare qualsiasi API? Qualsiasi endpoint HTTP REST raggiungibile a cui puoi autenticarti.

Quanti strumenti posso definire? Non c'è un conteggio fisso, costruiscine quanti te ne servono.

Prossimi passi

• Panoramica delle integrazioni