Slack e canali

Collega Slack a un progetto e controlla le sessioni da un canale.

Un canale collega una piattaforma di chat a un progetto. Un messaggio in un canale collegato avvia una sessione. L’agente risponde nello stesso thread.

Canali disponibili

Al momento Beeuni supporta quattro piattaforme di canale:

• Slack — collega con un clic tramite l’app gestita da Beeuni oppure usa il tuo token bot.
• Microsoft Teams — collega tramite OAuth con consenso dell’amministratore dell’organizzazione oppure usa il tuo Azure Bot (sperimentale; abilitalo in Impostazioni → Flag delle funzionalità).
• Email — un canale basato su AgentMail (sperimentale; abilitalo in Impostazioni → Flag delle funzionalità).
• Voce — un canale vocale in tempo reale (sperimentale; abilitalo in Impostazioni → Flag delle funzionalità). Parla con un agente in tempo reale.

Solo Slack e Microsoft Teams si collegano tramite CLI e dashboard. Email e voce si gestiscono dalla dashboard. Questa pagina tratta Slack. Teams segue le stesse regole per sessioni, collegamento delle identità e credenziali.

Come un canale avvia una sessione

Il primo messaggio in un thread Slack o in una conversazione Teams crea una sessione. Il thread mantiene la sessione anche dopo l’arresto e la ripresa della sandbox.

In un canale Slack, un messaggio successivo raggiunge la sessione solo se menziona il bot. Le risposte senza menzione sono rivolte alle persone nel thread. L’agente le legge la volta successiva che qualcuno lo menziona. In un messaggio diretto, ogni messaggio raggiunge la sessione.

In un’area di lavoro Slack collegata a più di un progetto, alla prima menzione viene mostrato un selettore di progetto.

Collegamento delle identità

Beeuni collega ogni mittente della chat a un account Beeuni prima che l’agente operi per suo conto. Esegui /beeuni login in Slack e segui il link per accedere. Teams prevede lo stesso requisito. A un mittente non collegato viene chiesto di collegare il proprio account, anziché avviare una sessione.

Un link di accesso funziona una sola volta e scade dopo 10 minuti. Un account Slack collegato a un account Beeuni non può essere collegato a un altro: esegui prima /beeuni logout. Se la tua organizzazione richiede l’autenticazione a due fattori, Beeuni ti chiede il secondo fattore prima di collegarti; la chat viene eseguita con il fattore usato per il collegamento.

Ogni azione viene eseguita con l’account collegato della persona che l’ha intrapresa, usando il ruolo di quell’account nel progetto. I proprietari e gli amministratori degli account sono considerati responsabili del progetto.

Dove risiedono le credenziali

Il token bot di un canale collegato è un segreto associato al connettore. Non compare nella pagina Secrets del progetto. Beeuni non lo inietta mai in una sandbox. Beeuni recupera il token lato server quando l’agente invia o legge un messaggio in chat.

Collegare Slack

beeuni channels connect

beeuni channels connect --manual --bot-token xoxb-... --signing-secret ...

beeuni channels status

Collegando Slack viene aggiunta per te una voce channel connettore a beeuni.yaml. Non devi mai scrivere questa voce manualmente.

Usare Slack

Menziona il bot con un’attività in qualsiasi canale a cui ha accesso, oppure apri un messaggio diretto. Come descritto sopra, il thread mantiene la sessione. Per continuare, menziona di nuovo il bot nel thread del canale. Una menzione senza attività genera un promemoria che ti invita ad aggiungerne una, invece di avviare una sessione.

Cosa può leggere l’agente

L’agente legge Slack tramite il connettore Slack del progetto (beeuni_slack oppure il comando slack nella sandbox). Tutti i progetti collegati alla stessa area di lavoro Slack usano lo stesso bot, quindi Beeuni limita ogni lettura alle conversazioni del progetto interessato:

Una lettura rifiutata restituisce 403 con il motivo conversation_not_in_project e un messaggio che identifica la conversazione. Per leggere una conversazione non collegata ad alcun progetto, collegala prima: esegui /beeuni switch nella conversazione e scegli questo progetto.

• La cronologia del canale esclude i messaggi appartenenti al thread di un altro progetto.
• get_history e get_thread aggiungono user_name a ogni messaggio il cui autore può essere identificato da Slack, accanto all’id user. Ogni lettura identifica al massimo 25 persone; i nomi che Slack non restituisce entro 2 secondi vengono omessi.
• list_channels elenca tutti i canali pubblici e i canali privati e messaggi diretti che l’agente può leggere.
• channel_info risponde per qualsiasi canale pubblico. Per un canale privato o un messaggio diretto, si applica la tabella sopra.
• file_info risponde se il file è condiviso in una conversazione che l’agente può leggere o in un thread di questo progetto. slack download segue la stessa regola: se un file è condiviso solo nella conversazione di un altro progetto, restituisce 403. Il download si interrompe a 50 MB e restituisce 413.
• search_messages viene eseguito solo se all’area di lavoro non è collegato nessun altro progetto, perché la ricerca non può essere limitata alle conversazioni di un singolo progetto.
• list_users, user_info e auth_test leggono la directory dell’area di lavoro e non sono soggetti a limitazioni.

Le scritture seguono la regola descritta di seguito.

Cosa può pubblicare l’agente

Pubblicare, inviare un file, modificare, eliminare, aggiungere una reazione, accedere a un canale e associare un thread seguono un’unica regola: l’agente non opera mai all’interno del canale o del thread di un altro progetto.

Una scrittura rifiutata restituisce 403 con il motivo conversation_not_in_project e un messaggio che identifica la conversazione. slack send --file e slack bind-thread seguono la stessa regola.

channel deve essere l’id della conversazione o dell’utente, ad esempio C0123ABCD o U0123ABCD, non il nome di un canale. Slack pubblica in base a un nome, che non può essere verificato rispetto alla regola. Se Slack pubblica comunque un messaggio in una conversazione diversa da quella verificata, Beeuni lo elimina e rifiuta la pubblicazione.

Per pubblicare in un canale gestito da un altro progetto, esegui /beeuni switch nel canale e scegli questo progetto, oppure pubblica da quel progetto.

Controllare una sessione con i comandi slash

Digita questi comandi come /beeuni <command> in Slack o come testo normale in un messaggio diretto. I comandi slash non vengono eseguiti nel pannello dei messaggi diretti dell’Assistente, quindi Beeuni interpreta lì le stesse parole come testo normale.

policy accetta project_open (impostazione predefinita: qualsiasi membro del progetto che menzioni il bot avvia una sessione), owner_approval o owner_only. È un’impostazione per singola risorsa, applicata a un canale, non un ruolo. Non concede alcun permesso negato dalla decisione sul ruolo: vedi Account e accesso.

Modelli e chiavi

/beeuni models elenca tutti i modelli che puoi usare qui, come nel selettore web: i modelli Beeuni e quelli accessibili tramite una chiave API del provider o un abbonamento ChatGPT. Per ciascuno indica come viene pagato. Se l’elenco è lungo, puoi digitare nel menu a discesa. Scegli un modello oppure digita /beeuni model <id>; /beeuni model default ripristina il valore predefinito del progetto.

Le chiavi disponibili dipendono dalla conversazione:

• Un messaggio diretto con il bot — le tue chiavi personali e il tuo abbonamento ChatGPT, oltre alle chiavi condivise con il progetto. Le sessioni sono private.
• Un canale o un messaggio diretto di gruppo — solo le chiavi condivise con l’intero progetto. Per usare un modello che si basa sulle tue chiavi personali, scegli un messaggio diretto.

Un modello che usa chiavi utilizza tutte le chiavi disponibili per il relativo provider, alternandole in caso di limiti di frequenza. Il modello del canale viene usato per avviare ogni nuovo thread; un thread mantiene il modello con cui è stato avviato. Se un thread non può più usare il proprio modello, per quel messaggio viene usato un modello sostitutivo invece di interromperlo. Vedi Chiavi dei provider e accesso dei membri.

Un messaggio di continuazione con un’immagine viene elaborato da un modello in grado di leggere immagini. Se nessun modello disponibile può farlo, il prompt informa l’agente che non riesce a vedere l’immagine e gli chiede di fornire il testo, invece di indovinare.

Nomi di canali e persone

Slack invia ID, come C0123ABCD e U0123ABCD. Beeuni mostra i nomi visibili alle persone in Slack e conserva gli ID per le operazioni.

Se Slack non riesce a trovare un canale, viene indicato come Canale non disponibile e l’ID viene conservato. Succede se il canale è stato eliminato o il bot è stato rimosso. I nomi che Slack non restituisce entro 2 secondi vengono omessi dal messaggio. Il prompt riporta solo gli ID e il turno non attende.

Approvazioni

Quando l’agente ha bisogno della decisione di una persona prima di procedere, crea un elemento di revisione. Se la sessione è stata avviata da questo thread, qui viene mostrata una scheda con il titolo, un riepilogo, un livello di rischio e le opzioni Approva, Richiedi modifiche e Nega.

Richiedi modifiche apre un campo per specificare cosa cambiare. Il testo inserito viene salvato insieme alla decisione e trasmesso all’agente, che non dovrà chiedertelo una seconda volta. È facoltativo: se invii il campo vuoto, all’agente viene detto di chiedere. Per approvare o negare basta un clic.

Per intervenire su una revisione serve un account Beeuni collegato con accesso in scrittura al progetto.

Interrompere un’esecuzione

Mentre l’agente lavora, il suo messaggio in tempo reale mostra un pulsante Interrompi. Arresta l’esecuzione nell’ambiente runtime, non solo nel messaggio: se l’esecuzione resta attiva, assorbe il messaggio successivo nel thread invece di rispondervi.

Può interromperla la persona che ha inviato il messaggio a cui si sta rispondendo, così come chiunque sia stato approvato per la sessione, purché possa ancora usare il progetto. Chiunque altro nel canale non può farlo e riceve una nota privata che lo informa.

Funzionalità non disponibili

• I comandi slash non vengono eseguiti nel pannello dei messaggi diretti dell’Assistente. Lì digita invece /beeuni <command> come testo normale.
• Al momento non sono supportate altre piattaforme di chat, incluso Telegram. Solo Slack e Microsoft Teams si collegano tramite CLI e dashboard; email e voce si collegano tramite dashboard.