Domande frequenti
Le domande che emergono nella prima settimana.
Hai domande? Chiedi all'agente
Se hai domande su cosa può fare Letaido, riscontri un errore o non sei sicuro di come funzioni qualcosa, il modo più veloce per ottenere una risposta è chiedere direttamente all'agente nella chat. Può leggere la propria documentazione, controllare la tua Area di lavoro, verificare le tue impostazioni e guidarti attraverso ciò che vede, tutto nello stesso posto.
Le FAQ qui sotto coprono le domande che vengono poste più spesso. Se la tua non è presente, chiedi all'agente; se vale la pena portarla avanti, l'agente si offrirà di aggiungerla.
Nozioni di base
Ricorda tra le chat?
Sì, ma solo ciò che gli dici di ricordare. Legge ~/workspace/.memory.md all'inizio di ogni chat. Dì "ricorda questo: X" e lo aggiunge. Viene letto anche il registro delle modifiche (progress.md), così sa cosa è stato creato di recente.
Posso annullare qualcosa che ha creato?
I file sono facili: chiedi "mostrami cosa hai modificato nell'ultima ora e ripristina X." Le modifiche al database non vengono ripristinate automaticamente, ma ogni azione viene registrata, quindi annullare è solitamente una conversazione chiara. Per le modifiche distruttive (eliminazione di tabelle, rimozione di skill), l'agente chiede prima di procedere.
Più persone possono condividere un'Area di lavoro?
Sì. I ruoli sono proprietario, amministratore, membro e visualizzatore. Il proprietario e l'amministratore decidono le schede di approvazione, gestiscono i segreti e attivano/disattivano il sito pubblico. I membri chattano e usano le pagine della Console. I visualizzatori hanno accesso in sola lettura.
Qualcosa di ciò che scrivo viene inviato a terze parti?
L'agente ragiona attraverso un provider LLM tramite un proxy locale. I messaggi vengono inviati per l'inferenza e gli output tornano indietro. Nessuna conservazione oltre a quanto previsto dalla policy del provider del modello. Niente viene condiviso con altre aree di lavoro.
Cosa succede quando un'API esterna non funziona?
L'agente segnala l'errore (codice di stato, categoria di errore se il connettore ne espone una), si ferma e attende istruzioni. Non riprova finché il tuo budget non esplode.
Creare cose
Quanto tempo ci vuole per creare un'app Console?
Quelli semplici (un modulo, una query, un risultato) arrivano in pochi minuti. Quelli complessi (pipeline multi-step, integrazioni di terze parti, visualizzazione personalizzata) richiedono una sessione di chat, a volte due. L'agente ti dirà se prevede di aver bisogno di più di un round trip.
Come condivido qualcosa con un cliente?
Costruiscilo sul sito pubblico, ottieni l'URL, imposta la modalità del sito su open o authorized, condividi il link. Pattern da conoscere: report con accesso tramite token (/<route>/<token>), documentazione pubblica (questo sito), pagine di acquisizione lead.
L'agente può costruire qualcosa che non ha mai costruito prima?
Sì, purché esistano le primitive (blueprint della Console, route del sito, cron job, webhook, connettore). Le compone. Se la primitiva non esiste (è necessaria una nuova funzionalità della piattaforma), te lo dirà chiaramente invece di inventare.
E se non c'è un connettore per il servizio di cui ho bisogno?
Chiedi al supporto di aggiungere un nuovo connettore per quell'app. I nuovi connettori vengono aggiunti regolarmente in base alle richieste dei clienti; nel frattempo, l'agente può solitamente ripiegare su una chiave API generica, un allowlist di domini e HTTP grezzo, ma un connettore appropriato è sempre preferibile (include input tipizzati, logging, credenziali con ambito definito e approvazione per superficie pronti all'uso).
Memoria, competenze, voce
Come faccio ad assicurarmi che l'agente utilizzi la voce del nostro brand?
C'è una skill per la voce del brand nella tua area di lavoro. L'agente la legge quando scrive o rivede il testo. Per aggiungere una nuova regola: "aggiorna la skill per la voce del brand per aggiungere:
Perché dici di non usare i trattini lunghi?
È una scelta stilistica a cui quest'area di lavoro si è impegnata. La regola è memorizzata e presente nella skill della voce del brand, quindi ogni bozza (e questi documenti) li evita. Sostituiscili con virgole, due punti, punti o parentesi.
Devo mettere tutto in memoria?
No. La memoria è per cose che cambiano le impostazioni predefinite dell'agente: chi sei, come scrivi, cosa ti interessa a lungo termine. Per le regole del flusso di lavoro ("la nostra checklist di lancio standard è X"), una skill è meglio. Per il contesto occasionale ("questo cliente è sensibile riguardo ai prezzi"), dillo in chat.
Sito pubblico, documentazione, digest settimanale
Come vengono aggiornati questi documenti?
Il sorgente markdown si trova in ~/workspace/docs/*.md. Il manutentore modifica a mano. Un processo di sincronizzazione (ogni 30 minuti) renderizza il markdown nel database. Il sito pubblico legge dal database.
Cos'è il digest settimanale?
Un job programmato che viene eseguito ogni lunedì alle 10:00 Europe/Bucharest. Confronta la memoria dell'agente, il registro delle modifiche e la cartella skills dall'ultimo digest, chiede all'LLM cosa è cambiato che i clienti dovrebbero sapere e invia su Slack le modifiche suggerite alla documentazione al maintainer. Il maintainer le rivede; la documentazione viene aggiornata.
Perché non pubblicare automaticamente i suggerimenti?
Due motivi. (1) Una modifica suggerita da un LLM può essere sottilmente sbagliata; la documentazione è il volto pubblico del prodotto. (2) La revisione umana mantiene il tono coerente e individua cose che sembrano corrette ma non lo sono.
Come faccio a segnalare un problema con la documentazione?
Comunicalo all'agente nella chat. Aprirà una nota nell'area di lavoro e la invierà al responsabile della documentazione nel prossimo riepilogo settimanale.
Approvazioni, segreti, denaro
Perché continua a chiedermi di approvare le cose?
Perché l'azione costa denaro, colpisce la rete o tocca le credenziali. Ognuna viene registrata. La soluzione per "troppe schede di approvazione" è solitamente raggruppare la richiesta: chiedi all'agente di pianificare l'intero flusso prima in modo che richieda tutti gli ambiti e le approvazioni in una volta sola.
Posso vedere quali credenziali sono configurate?
Sì, dall'interfaccia dell'area di lavoro. Puoi vedere il nome del segreto, il tipo, lo stato e a quali connettori e superfici è concesso. Non puoi vedere il valore del segreto; nessuno può, incluso l'agente.
Posso limitare la spesa dell'agente?
La piattaforma misura i token LLM e le chiamate ai connettori. Per un controllo dei costi sostenuto, i job sono la superficie giusta (rappresentano una spesa ricorrente esplicita); la spesa per le chat ad-hoc è quella che richiedi. Se un job non funziona correttamente, mettilo in pausa dalla scheda Job.
Risoluzione dei problemi
L'URL del sito pubblico restituisce 403.
La modalità del sito è off. Passa a authorized (solo membri) o open (chiunque) dalla scheda Sito pubblico.
Una pagina della Console si carica all'infinito.
La pagina sta effettuando una chiamata esterna lunga (il timeout di nginx è di 30 secondi; per operazioni lunghe dovresti usare il pattern job-id-then-poll), oppure il processo Flask si è bloccato. Controlla i log in coda su /home/console/http/data/.tail.log.
Una chiamata al connettore restituisce approval_pending o not_approved.
Prima volta per quella combinazione di (connettore, segreto, superficie). Approva la card. Per le superfici Console o sito, un proprietario o amministratore fa clic su request_connector_approval separatamente dalla superficie della chat.
Un job non è stato eseguito quando me lo aspettavo.
Gli orari cron sono in UTC sull'host. Se il tuo lavoro è "ogni lunedì alle 9 del mattino a Bucarest", la riga di pianificazione è 0 7 * * 1 (estate) o 0 8 * * 1 (inverno); l'agente di IA in genere ne sceglie uno e aggiunge una protezione zoneinfo all'interno dello script per gestire l'ora legale. Controlla la scheda Jobs per l'orario della prossima esecuzione.
Un Trigger non si attiva.
Controlla l'elenco delle sottoscrizioni. Se mostra paused o revoked, effettua nuovamente la sottoscrizione. Se mostra active ma non ci sono eventi, controlla la configurazione dell'app di terze parti (anche da parte loro deve essere impostato l'URL della sottoscrizione).
La mia area di lavoro sembra lenta.
Le sessioni di chat lunghe peggiorano. Avvia una nuova chat; la memoria e i progressi trasferiscono il contesto importante.