# Dai strumenti a un agente

> Collega gruppi di strumenti, associa account e scegli le regole di approvazione per ogni azione.

Dai all’agente le azioni necessarie per il suo lavoro. Il permesso di usare uno strumento e una connessione utilizzabile sono requisiti distinti.

## Prima di iniziare

Serve accesso owner o editor della dashboard per cambiare strumenti. Collega gli account dei servizi in [account collegati](/it/docs/tools/connected-accounts). Per collegare app serve il permesso di gestirle.

## Collega strumenti e account

1. Apri la scheda **Connessioni** dell’agente.
2. Seleziona il nodo più per gli strumenti e scegli un gruppo.
3. Apri il nodo del gruppo collegato.
4. Scegli **Account del workspace** per un servizio collegato, oppure **Credenziali per questo agente** per uno strumento personalizzato che richiede segreti.
5. Risolvi permessi mancanti o autorizzazioni scadute indicati per quella connessione.
6. Imposta la regola di approvazione di ogni azione in **Strumenti e policy di approvazione**.
7. Prova un compito rappresentativo in **Chat**.

Le associazioni appartengono a ogni gruppo di strumenti su questo agente. Per esempio, associa Gmail a sales@ e Drive a ops@; le azioni del gruppo usano il suo account. Più agenti possono riutilizzare una connessione o un profilo credenziali dell’account.

> **Attenzione** — Uno strumento che richiede una connessione non funziona senza un’associazione valida. Gli agenti non ripiegano mai sull’account personale del membro. Usa **Chiedi** per azioni potenti o distruttive finché non ti fidi del comportamento.

## Scegli le approvazioni

| Regola | Effetto |
| --- | --- |
| **Automatico** | Esegue senza fermarsi per l’approvazione del singolo strumento |
| **Chiedi** | Si ferma in attesa dell’approvazione di una persona |
| **Disattivato** | Non può essere eseguito |

Il controllo **Tutti** applica una regola alle azioni del gruppo. La regola consigliata è un suggerimento iniziale, non permanente. Restano valide le approvazioni indipendenti di consegna o sicurezza, compreso il trasferimento di file a strumenti esterni.

Collegare Slack o WhatsApp concede strumenti; i messaggi in arrivo avviano separatamente i workflow iscritti. Vedi [trigger dei workflow](/it/docs/workflows/triggers).

## Collega un’app interna

1. Seleziona il nodo più **App** in **Connessioni**.
2. Scegli i ruoli dell’app e un’app pubblicata. Le app precedenti usano **Viewer** per leggere o **Editor** per modificare.
3. Apri il nodo per controllare o cambiare i ruoli.
4. Imposta la regola di approvazione di ogni strumento dell’app in **Strumenti e policy di approvazione**.
5. Usa **Apri Accesso all’app** per controllare la stessa associazione nell’app, oppure **Scollega dall’agente** per rimuoverla.

I ruoli dell’agente nell’app determinano quali strumenti compaiono. Si applica anche l’accesso all’app del membro richiedente. Scegli al massimo otto ruoli dell’app.

Gli strumenti dell’app hanno **Automatico**, **Chiedi** o **Disattivato** come gli altri strumenti. Finché non li cambi, le letture vengono eseguite in automatico e le modifiche chiedono prima. La regola appartiene all’agente, quindi è la stessa chiunque lo chieda. Scollegare l’app ne rimuove le regole.

Gli agenti possono anche leggere i file salvati nell’app, come PDF, scansioni o fogli di calcolo caricati: ne salvano una copia nei download del loro Workspace e la leggono da lì. Valgono i permessi dell’app e la regola dello strumento dell’app che restituisce il file.

Un’app in pausa, sospesa, non pubblicata o nel cestino non fornisce strumenti. Nemmeno un agente inattivo può usarli. L’associazione resta visibile finché torna disponibile o la scolleghi.

## Pagine correlate

- [Account collegati](/it/docs/tools/connected-accounts)
- [Strumenti personalizzati](/it/docs/tools/custom-tools)
- [Accesso alle app](/it/docs/apps/access)
- [Capacità integrate](/it/docs/agents/capabilities)