Agenti

I passaggi agente girano su Mate, con la tua chiave IA o sul tuo runner: aggiungi una chiave, scopri modelli, limiti per esecuzione e cronologia.

Un agente è un’IA che esegue il passaggio agente di un’automazione: legge il record che ha avviato l’automazione, usa gli stessi strumenti CRM di Mate e riferisce che cosa ha fatto. Dove gira un agente è il runtime del passaggio: Mate (l’agente ospitato di Customermates, pagato con i crediti IA del tuo piano, solo Cloud), La tua chiave (un agente nel cloud di Customermates o sulla tua istanza self-hosted che usa una chiave API del tuo fornitore di IA, fatturata dal fornitore) oppure Il tuo runner (Claude Code o Codex sul tuo computer, con il tuo login).

Apri Agenti, nelle impostazioni, per vedere quali runtime sono disponibili, aggiungere chiavi di fornitore, vedere i runner dello spazio di lavoro e leggere le ultime esecuzioni. La pagina è per chi può modificare le impostazioni dello spazio di lavoro.

Come aggiungo una chiave di fornitore?

Apri Agenti, fai clic su Aggiungi chiave e scegli il Fornitore (Anthropic, OpenAI o Google). Dai un' Etichetta alla chiave, incolla la Chiave API dalla console del fornitore e scegli un Modello predefinito. Customermates chiede al fornitore se la chiave funziona prima di conservarla. Una chiave rifiutata dal fornitore non viene salvata e, se il fornitore al momento non è raggiungibile, ti viene chiesto di riprovare. Una chiave che il fornitore accetta ma a cui non permette di elencare i modelli, per esempio una chiave OpenAI con restrizioni, viene salvata con una nota che dice che non è stato possibile verificarla.

La chiave viene salvata cifrata e non viene mai più mostrata: l’elenco mostra solo l’etichetta, il fornitore e gli ultimi quattro caratteri. Uno spazio di lavoro ha una chiave per fornitore, quindi aggiungere una chiave per un fornitore che ne ha già una la sostituisce. Prova interroga di nuovo il fornitore e aggiorna Ultimo controllo, Rimuovi elimina la chiave per sempre. Se il segreto di cifratura del server è cambiato dopo il salvataggio della chiave, Prova e le esecuzioni degli agenti dicono che la chiave non si può leggere, e la salvi di nuovo. Le chiavi funzionano su ogni piano a pagamento e sulle istanze self-hosted, dove la chiave è comunque tua; il piano Free non può aggiungerne una.

Quanto costa?

Un agente con la tua chiave ti costa quello che il fornitore addebita per le chiamate, sulla fattura del fornitore. Non usa i crediti IA del tuo piano Customermates. Un agente su Mate usa i crediti della persona proprietaria dell’automazione, la stessa quota delle chat di Mate e delle routine, e ogni esecuzione mostra i crediti usati. Un’esecuzione su Mate riserva i crediti un turno alla volta e si ferma prima di usare più di 10 crediti o più di quanto resta di quella quota.

Quali modelli posso usare?

L’elenco per fornitore è curato da Customermates e mostra i modelli dei fornitori per cui hai aggiunto una chiave:

  • Anthropic: Claude Sonnet 5.5 (predefinito), Claude Opus 5.5, Claude Haiku 5.5, Claude Sonnet 4.5 e Claude Haiku 4.5.
  • OpenAI: GPT-5 mini (predefinito), GPT-5, GPT-5 nano, GPT-4.1 e GPT-4.1 mini.
  • Google: Gemini 2.5 Flash (predefinito), Gemini 2.5 Pro e Gemini 2.5 Flash-Lite.

Un passaggio salvato senza modello mantiene da quel momento il modello predefinito dell’unica chiave di fornitore dello spazio di lavoro. Con più chiavi il passaggio ha bisogno di un modello, così rimuovere una chiave non sposta mai un passaggio su un altro fornitore. Quando il modello predefinito di una chiave non è più offerto, l’esecuzione usa il modello predefinito del fornitore e lo indica nella trascrizione. Customermates non chiede mai un login Claude Pro o Max: il runtime con chiave propria funziona solo con una chiave API dalla console del fornitore.

Che cosa può fare un passaggio agente?

Un passaggio agente gira come proprietario dell’automazione, con i suoi permessi, senza che nessuno guardi. Può leggere e modificare record, leggere la base di conoscenza e usare gli altri strumenti dello spazio di lavoro di Mate. Non può usare l’interfaccia e non ha la ricerca web. Tutto ciò che richiede un’approvazione, come eliminare record o invitare persone, viene rifiutato e l’agente riferisce che cosa resta da fare.

Un’esecuzione ha due limiti: al massimo 25 chiamate agli strumenti e 10 minuti. Quando un limite viene raggiunto, l’esecuzione si ferma e lo dice. Quando l’evento che ha avviato l’automazione arriva dall’esterno dello spazio di lavoro, per esempio un modulo, un webhook o un messaggio in arrivo, l’agente tratta il record e tutto il suo contenuto come dati, mai come istruzioni. Lo stesso vale per il nome di un record che l’istruzione usa con {{record.name}}: arriva all’agente contrassegnato come dato e limitato a 200 caratteri. Un’esecuzione che un testo esterno può raggiungere in uno di questi modi non può inviare e-mail o messaggi di chat, inviare inviti di collegamento, né creare, modificare o avviare webhook e routine: l’agente scrive nel suo rapporto che cosa andrebbe inviato o modificato. Lo stesso vale quando il record che ha avviato l’automazione è stato scritto da un modulo pubblico, da un webhook in entrata o da un passaggio agente che un testo esterno poteva raggiungere, qualunque sia il trigger dell’automazione. Nessun passaggio agente crea, modifica o elimina pagine della base di conoscenza. Allo stesso modo nessun passaggio agente avvia una routine, né crea o modifica una routine che reagisce a eventi, perché una routine del genere potrebbe riavviare l’automazione senza fine. Un passaggio avviato da un messaggio in arrivo viene informato di quale conversazione leggere. Un’esecuzione interrotta dopo l’avvio, per esempio da un riavvio del server, non viene mai avviata una seconda volta, perché potrebbe aver già inviato o modificato qualcosa: termina come tempo scaduto pochi minuti dopo la scadenza del suo limite di tempo. Uno spazio di lavoro esegue al massimo cinque passaggi agente alla volta su Mate o sulla propria chiave; gli altri aspettano in coda finché uno è concluso. Un’esecuzione che non è stato possibile avviare viene ritentata entro pochi minuti e termina come tempo scaduto se dopo 15 minuti non è ancora partita. Un’esecuzione che fallisce per colpa del fornitore mostra la classe di errore del fornitore, mai la chiave.

Dove vedo che cosa ha fatto un agente?

Ultime esecuzioni degli agenti nella pagina Agenti elenca le esecuzioni, le più recenti per prime, con lo stato (In coda, In avvio, In corso, Completata, Non riuscita, Tempo scaduto o Annullata), il runtime, il modello, i token e, per Mate, i crediti usati. Apri un’esecuzione per leggerne la trascrizione: l’istruzione, ogni strumento chiamato con un breve riassunto degli argomenti, un breve riassunto di ogni risultato e il rapporto finale. Le esecuzioni vengono conservate per 90 giorni. Chi vede tutte le automazioni vede tutte le esecuzioni, gli altri vedono quelle delle proprie automazioni. L’istruzione, la trascrizione e il rapporto finale di un’esecuzione sono mostrati solo al proprietario dell’automazione e agli amministratori; le altre persone che vedono l’esecuzione ne vedono lo stato, il runtime, il modello, i token e gli orari.

Per gli agenti

Il passaggio agente è l’effetto agent di una regola in manage_rules tramite MCP: runtime è mate, ownKey o runner, prompt è il compito (può usare {{record.name}} e {{rule.name}}), model sceglie per ownKey un modello del fornitore della chiave e runnerId fissa per runner un runner preciso. Un runtime non disponibile fa fallire l’effetto con il motivo plan, noKey, noRunner, selfHosted o notConfigured.

Domande frequenti

Posso usare il mio abbonamento Claude Pro o Max?

No. Customermates esegue gli agenti con una chiave API dalla console del fornitore, che il fornitore fattura a consumo. Un login Claude Pro o Max appartiene a Claude stesso e non viene usato da Customermates.

La mia chiave è al sicuro?

La chiave viene verificata presso il fornitore, salvata cifrata e non viene mostrata più da nessuna parte, nemmeno agli amministratori. Viene aperta solo per la durata di un’esecuzione, per le chiamate di quell’esecuzione al fornitore, e non viene mai scritta nella cronologia delle esecuzioni.

Perché La tua chiave non è disponibile?

La pagina Agenti indica il motivo accanto a ogni runtime: il tuo piano non lo include, oppure non è ancora stata aggiunta nessuna chiave di fornitore. Un runner è disponibile se ne è stato visto uno negli ultimi due minuti.

Un’esecuzione continua se chiudo la pagina?

Sì. Un’esecuzione viene avviata sul server dall’automazione e termina lì. La pagina mostra solo ciò che è stato registrato.