Quale esperienza stai usando?
Questa documentazione copre entrambe le esperienze. Se Impostazioni → Personale → My Okou è disponibile, segui i passaggi di My Okou. Se usi una pagina Agents con New agent, segui i passaggi dei Legacy Agents. La disponibilità può variare tra membri; questa documentazione non modifica la tua esperienza.
In entrambe le esperienze, puoi eseguire più chat o attività contemporaneamente, riutilizzare i flussi di lavoro e condividere con il tuo team il lavoro revisionato. Un subagent di runtime è uno strumento di esecuzione, non un profilo di prodotto separato che devi creare.
Differenze di configurazione: My Okou usa le istruzioni personali (Instructions) in Impostazioni → Personale → My Okou e i flussi di lavoro dello spazio di lavoro. Qualsiasi passaggio qui sotto che ti chiede di scegliere, creare o autorizzare un agente con nome si applica solo ai Legacy Agents. In My Okou, usa la tua chat e segui la richiesta di account e di autorizzazione con nome mostrata. I flussi di lavoro condivisi non condividono le credenziali; le automazioni usano il contesto e l'accesso del loro proprietario.
Una chat è un thread di conversazione. Ogni messaggio che chiede a Okou di agire avvia un run all'interno di quel thread. Rispondere nella stessa chat mantiene disponibili come contesto i messaggi e gli artefatti precedenti del thread; aprire una nuova chat avvia un contesto separato.
Perché le chat sono importanti
- Il contesto è limitato al thread. Un run può usare i messaggi e gli artefatti della propria chat. Non legge automaticamente la cronologia di un'altra chat.
- I run sono ispezionabili. Il thread mostra i messaggi, l'attività degli strumenti, gli artefatti, lo stato e gli errori prodotti dai suoi run.
- Il lavoro può essere reindirizzato mentre è in esecuzione. Puoi interrompere un run attivo o inviare una correzione mentre Okou sta ancora lavorando — la nuova istruzione viene acquisita all'interno del run attivo invece di scartare il lavoro già in corso. I messaggi consecutivi restano raggruppati nel thread come un'unica raffica. Per rispondere a una frase esatta, selezionala e scegli Quote per inserire quel testo nel tuo messaggio successivo.
Come iniziano chat e run
- Aprire una nuova conversazione nell'app web crea un nuovo thread di chat.
- Inviare un'altra attività in quella conversazione avvia un altro run nello stesso thread.
- Una conversazione Slack mantiene il contesto all'interno del proprio thread Slack associato.
- Un'automazione viene eseguita nella chat di automazione associata al suo flusso di lavoro e al suo proprietario. Le attivazioni ripetute di quel flusso di lavoro riutilizzano quella chat di automazione.
Più thread possono essere eseguiti contemporaneamente. Thread di chat diversi procedono in modo indipendente — avvia una ricerca di mercato in uno, scrivi una bozza di post in un altro, ed entrambi avanzano nello stesso momento. Quanti possono essere eseguiti in parallelo dipende dal tuo piano; vedi Crediti e fatturazione. Quando ogni slot di esecuzione è occupato, il run successivo attende che se ne liberi uno.
All'interno di un thread, i run sono sequenziali. Un thread esegue un run alla volta. Una correzione che invii mentre un run è in corso si unisce a quel run invece di avviarne un secondo in parallelo.
Dove viene eseguito un run
Ogni run ottiene una macchina tutta sua — una vera macchina, con un terminale, un file system e un browser. È questo che permette a Okou di eseguire davvero la trasformazione del foglio di calcolo, clonare il repository o renderizzare la presentazione, invece di descrivere come lo faresti tu.
Quell'ambiente è privato per il run e viene smantellato quando il run termina. Il codice che vi gira dentro non riceve mai le credenziali dei tuoi connettori — vengono iniettate al confine di rete — e ogni richiesta effettuata dal run viene registrata. Vedi Sicurezza per sapere come è costruito l'isolamento.
Considera la macchina come temporanea. Tutto ciò che vale la pena conservare dovrebbe finire in un luogo durevole: pubblicato come pagina, archiviato in uno strumento connesso oppure scaricato. Un percorso file sulla macchina del run non è qualcosa che puoi condividere.
Continuare o iniziare da capo
Continua nello stesso thread quando la richiesta successiva dipende da messaggi, file o decisioni precedenti. Apri un nuovo thread quando vuoi un contesto indipendente.
I canali sono punti di ingresso allo stesso spazio di lavoro, ma non creano una cronologia di conversazione globale unica. Un nuovo thread web, Slack, Telegram o telefono non importa automaticamente i messaggi di un altro thread. Quando sposti il lavoro in un nuovo thread, includi il contesto o l'artefatto di cui ha bisogno.
Ispezionare un run
Usa il controllo di attività o log del thread per ispezionare il run. Registra la sequenza visibile dei messaggi, l'attività degli strumenti, gli artefatti, le modifiche di stato e gli errori. È il primo posto da controllare quando un risultato è incompleto o un'azione del connettore non è avvenuta.
Risoluzione dei problemi
| Cosa vedi | Cosa controllare o fare |
|---|---|
| Queued | Lo spazio di lavoro non ha slot di run liberi, quindi il run non è ancora iniziato. Attendi che si liberi uno slot; un messaggio in coda può essere rimosso prima che inizi. Inviare una correzione a un run già in corso non lo mette in coda — quel messaggio si unisce al run attivo. |
| Una scheda Connect o Authorize | L'account richiesto non è connesso oppure a questo agente manca un'autorizzazione del connettore richiesta. Completa la scheda e scegli solo l'accesso e la durata necessari per l'attività. Se il run non riprende, riprova la richiesta nello stesso thread. |
| Selected model is not available | Il modello del thread non è attualmente utilizzabile in base ai criteri dei modelli dello spazio di lavoro o alla connessione del provider. Scegli un modello disponibile nel composer, oppure riconnetti il provider richiesto in Impostazioni → Modelli. |
| Insufficient credits | Lo spazio di lavoro non può avviare altro lavoro dei modelli con il saldo attuale. Apri Fatturazione per controllare il saldo, aggiungere fondi o cambiare piano, quindi riprova. |
| Un errore di caricamento dell'allegato | Il file non ha terminato il caricamento, quindi non è disponibile per il run. Riprova il caricamento prima di inviare di nuovo il messaggio. |
| Un run è Failed | Il run è terminato senza un risultato. Apri il suo errore visibile e il log di attività, correggi il problema segnalato di connettore, autorizzazione, modello, input o servizio, quindi riprova. |
Quando chiedi aiuto al supporto, condividi l'URL della chat e l'errore visibile del run fallito. Non incollare mai segreti del connettore o chiavi del provider nella chat.
Cosa c'è dopo
- Vedi Permessi per ciò che viene applicato al confine della chat.
- Vedi Crediti e fatturazione per sapere come viene calcolato il costo della chat.
- Vedi Automazioni per il modello di chat ricorrente e guidato dagli eventi.
