Slack (strumenti in sola lettura)
Una famiglia di strumenti Slack in sola lettura, elenca i canali, leggi cronologia e thread, cerca utenti e messaggi. Solo per il proprietario, non pubblica mai nulla.
La stessa connessione Slack che permette al tuo agente di rispondere ai DM e alle @menzioni funge anche da famiglia di strumenti in sola lettura: il tuo agente può elencare i canali, leggere la cronologia dei canali e dei thread, cercare gli utenti dello spazio di lavoro e cercare messaggi, il tutto mentre svolge un'attività. Questi strumenti si limitano a leggere; non pubblicano mai nulla. Pubblicare resta il compito del canale Slack.
Connetti
Non c'è nulla di nuovo da collegare qui, gli strumenti sfruttano la stessa connessione del canale Slack. Se Slack è già connesso come canale, gli strumenti di lettura sono disponibili; in caso contrario, connettilo una volta ed entrambe le superfici si attivano.
- Segui Connetti Slack come canale, incolla il Bot Token e il Signing Secret della tua app Slack.
- Abilita gli strumenti di lettura Slack per l'agente che deve usarli.
- L'agente ora può leggere Slack mentre svolge un'attività, continua a non poter pubblicare tramite questi strumenti.
Il vero trucco: questi strumenti sono solo per il proprietario, vengono eseguiti solo su superfici interne/del proprietario (l'agente del tuo dashboard), mai per un visitatore di un sito web pubblico. E la ricerca richiede più di un bot token: slack_search_messages richiede un token con ambito utente e search:read. Uno spazio di lavoro connesso con il solo bot token ottiene gli altri sei strumenti, ma la ricerca restituisce un chiaro errore "requires a user token".
Strumenti
| Strumento | Accesso | Tipo | Cosa fa |
|---|---|---|---|
slack_list_channels | Solo proprietario | Read | Elenca i canali pubblici e privati che il bot può vedere, id, nome, argomento/scopo, numero di membri e stato di archiviazione. Impaginato tramite cursore. |
slack_channel_history | Solo proprietario | Read | Legge i messaggi recenti di un canale: mittente, testo, timestamp, informazioni sul thread e reazioni. Usa list_channels per trovare l'id del canale. |
slack_thread_replies | Solo proprietario | Read | Recupera le risposte in un thread, dato il timestamp del messaggio principale dalla cronologia del canale. |
slack_channel_members | Solo proprietario | Read | Elenca i partecipanti di un canale, risolvendo facoltativamente gli id utente in nomi ed email. |
slack_list_users | Solo proprietario | Read | Elenca gli utenti dello spazio di lavoro, id, nome, nome reale, email quando disponibile e flag bot/disattivato. Impaginato tramite cursore. |
slack_user_info | Solo proprietario | Read | Cerca un singolo utente per id: nome, email, fuso orario, titolo e stato. |
slack_search_messages | Solo proprietario | Read | Cerca messaggi in tutto lo spazio di lavoro con modificatori come in-channel e from-user. Richiede un user token con search:read. |
Questa è tutta la superficie: ogni strumento qui sopra è in sola lettura, e nulla qui scrive.
Solo per il proprietario vs. public-safe
A differenza di Web Search, nessuno degli strumenti Slack è public-safe. Ognuno è solo per il proprietario, l'agente può raggiungerli solo su una superficie interna/del proprietario, e un visitatore su un bot pubblico non li attiva mai. Questo è intenzionale: i canali dello spazio di lavoro, la cronologia dei messaggi e le email dei membri sono dati sensibili, quindi le chiamate agli strumenti sono anche nascoste dal flusso della conversazione. Se vuoi che l'agente agisca in Slack per il pubblico, rispondendo nei DM e alle @menzioni, quello è il canale Slack, una funzionalità separata.
Esempio pratico
Chiedi al tuo assistente di dashboard: "Cosa ha deciso il canale #launch riguardo alla pagina dei prezzi la settimana scorsa?" L'agente esegue slack_list_channels per trovare l'id di #launch, slack_channel_history per estrarre i messaggi recenti, segue una decisione nel suo thread con slack_thread_replies e ti riassume il tutto, leggendo soltanto, senza mai pubblicare una parola in Slack.
In sola lettura, per scelta progettuale
In questa famiglia non ci sono strumenti di scrittura. L'agente può elencare, leggere e cercare, ma non può pubblicare, modificare, reagire, invitare o archiviare. Tutto ciò che l'agente deve dire in Slack passa invece attraverso il canale.
Risoluzione dei problemi
- Gli strumenti non compaiono. Sono solo per il proprietario, verifica di essere su una superficie interna/del proprietario (non un canale pubblico) e che Slack sia connesso prima come canale.
- La ricerca restituisce "requires a user token".
slack_search_messagesrichiede un token con ambito utente esearch:read; uno spazio di lavoro con il solo bot token può usare gli altri sei strumenti ma non la ricerca. - Mancano i canali privati. Il bot vede solo i canali di cui è membro, invitalo nel canale privato, poi rielenca.
- I membri appaiono come ID, non come nomi. Mantieni attiva la risoluzione dei nomi per
slack_channel_members, oppure risolvi un singolo id conslack_user_info, Slack non sempre include i nomi in linea.
FAQ
L'agente può pubblicare tramite questi strumenti? No, sono rigorosamente in sola lettura. Pubblicare è compito del canale Slack.
Devo connettere Slack due volte? No. Un'unica connessione Slack alimenta sia il canale sia questi strumenti di lettura.
Perché il mio bot pubblico non può usarli? Espongono dati dello spazio di lavoro, quindi sono solo per il proprietario per scelta progettuale e non vengono mai eseguiti per un visitatore.
Avanti
- Canale Slack, la connessione che questi strumenti condividono, e come l'agente parla in Slack
- Custom API, connetti qualsiasi altro sistema al tuo agente
- Panoramica delle integrazioni, ogni app e famiglia di strumenti collegabile
Strumenti email
Una casella di posta collegata è anche una famiglia di strumenti per l'agente, leggi, cerca, apri, invia, rispondi, contrassegna e sposta la posta. Tutti owner-only, e distinti dall'Email-come-canale.
Wise
Collega Wise con un token API di sola lettura, così il tuo agente può fornire preventivi sui tassi e leggere saldi, destinatari e transazioni, non sposta mai denaro.