Integrazioni e connessioni

Integrazioni è un catalogo di servizi che puoi collegare, e un elenco di ciò che è già collegato. Un servizio viene collegato una sola volta, poi assegnato agli agenti che ne hanno bisogno.

Messenger

Telegram e MAX — un agente può avere un proprio bot dedicato (risponde solo per lui, istantaneamente), oppure un bot condiviso tramite una connessione che instrada i messaggi all’agente giusto.

Telegram dispone anche di argomenti: un agente gestisce ogni argomento di un gruppo come una propria conversazione separata — vedi Agenti per i dettagli.

I tuoi servizi personali

Se non esiste una scheda pronta per un servizio di cui hai bisogno, la categoria “Generici” ne coprirà qualsiasi altro, in tre modi:

• Il tuo servizio (REST API) — indirizzo base, metodo di accesso, un segreto e, opzionalmente, un indirizzo OpenAPI. L’agente chiama il servizio direttamente; il segreto non lascia mai il tuo server.
• Eventi in entrata (webhook) — la connessione riceve un proprio indirizzo, come /api/hooks/<token>, opzionalmente firmato con HMAC-SHA256. Ogni evento in entrata diventa un messaggio che l’agente legge e su cui può agire, nello stesso modo in cui agirebbe su un messaggio in un messenger. Fino a 120 eventi al minuto per connessione; nulla nel corpo di un evento viene mai eseguito come comando.
• Server MCP — Neo aggiunge il server al set di strumenti dell’agente, senza esporre segreti in chiaro. L’agente vede i nuovi strumenti dopo un riavvio.

Quando una voce del catalogo viene rinominata o unificata

A volte una scheda del catalogo ne sostituisce diverse più vecchie (Bitrix24, ad esempio, offre una scelta del metodo di connessione — webhook oppure login e password). Le connessioni create con la vecchia scheda passano automaticamente a quella nuova, mantenendo i loro valori; i campi del metodo non scelto vengono semplicemente nascosti, non richiesti.