# Strumenti & Workflow

**Skills - Tools & Workflows** è la lista delle autorizzazioni: cosa questo agent può *fare*, non cosa *sa*. Uno strumento che è spento non può attivarsi, anche se il prompt lo chiede. Un workflow che non è collegato qui non può eseguire, anche se l'ha costruito sotto **Workflows**.

L'intestazione mostra quanti strumenti sono abilitati (per esempio **6 of 51 tools enabled**) e quante integrazioni sono connesse.

  <ShotPlaceholder
    src="/assets/agent-configuration/tools.png"
    name="tools"
    alt="Panoramica Tools and Workflows"
    capture="Skills - Tools and Workflows."
  />

Non abiliti l'intero catalogo il primo giorno. Strumenti extra sono modi extra per uscire dal copione. L'agent di attivazione ha già un piccolo set **Enabled** - è abbastanza per le prove.

## Quale lista le serve?

- **Un lavoro multi-passo che ha già costruito (API, email, branch)** — turn on **Business Workflows** (needs Lo colleghi qui o l'agent non può eseguirlo. Lo stato vuoto mostra **No workflows added yet.** Usi **Add workflow** per creare e collegarne uno.)
- **Un lavoro che il prodotto già fornisce (SMS, skip-turn, voicemail)** — turn on **Built-in Tools** (needs Toggle + ingranaggio. **Enabled** è la verità; navighi il catalogo con gli altri filtri.)
- **Un server strumenti remoto (Claude / un MCP personalizzato)** — turn on **MCP servers** (needs **Add MCP**, connetta (Streamable HTTP, Bearer, o OAuth), poi scelga quali dei suoi strumenti questo agent può chiamare.)

## Prima configurazione - un receptionist che non parla sopra le cifre

1. **Apra Skills - Tools & Workflows**

   Noti **N of M tools enabled**. Quel numero è ciò che il modello può chiamare.

2. **Lasci Business Workflows vuoto fino a quando non ha un lavoro reale**

   Poi **Add workflow** o colleghi una riga esistente e attivi il suo toggle. La matita apre l'editor del workflow.

3. **Su Built-in Tools, inizi da Enabled**

   I filtri includono **Enabled**, **Essentials**, **All categories**, **Conversation**, **Outbound** e **Integrations**. **Enabled** è ciò che questo agent effettivamente userà. Usi gli altri filtri per trovare qualcosa da attivare *on*.

4. **Mantenga questi attivi per una prima linea in entrata**

   Un set di attivazione tipico include:

- **Skip Turn** — Il chiamante sta per leggere un numero o codice. Senza questo l'agent parla sopra le cifre. Apra l'ingranaggio (**Skip Turn - Tool Settings**). Usi un template: **Phone number**, **Product code**, **Order number**, o **Continue after Input**. Timeout e max skips per turn controllano quanto resta silenzioso.
- **Handle Silence** — La linea diventa silenziosa. Configuri l'intervallo, quanti solleciti, poi **Forward the call** e/o **End the call**. Se l'azione è forward/transfer, Transfer sotto Call handling deve essere pronto o **Required** può bloccarla.
- **Detect Voice Mail** — Chiamate in uscita o callback di chiamate perse, così non "parla" a una casella vocale.
- **Lock on Speaker** — Aiuta l'agent a rimanere bloccato sul parlante giusto quando utile per la sua linea.

     <ShotPlaceholder
       src="/assets/agent-configuration/tools-skip.png"
       name="tools-skip"
       alt="Impostazioni strumento Skip Turn con template phone number"
       capture="Modale Skip Turn Tool Settings."
     />

5. **Aggiunga SMS solo se effettivamente manderà messaggi**

   **Send SMS** e **Capture Data via SMS** usano crediti e devono essere richiesti. Metta una riga nel prompt di personalità ("Manda un messaggio di conferma quando chiedono") così il modello sa che è permesso - il toggle da solo non è un brief.

6. **Play wait music on tools**

   Quando attivo, i chiamanti sentono musica invece di silenzio mentre uno strumento esegue. Lo lasci spento se l'agent parla principalmente senza pause per strumenti.

7. **Try this agent**

   Legga un numero di telefono lentamente. Se l'agent parla sopra di lei, Skip Turn è spento o il suo prompt è vago. Stia in silenzio per un po': Handle Silence dovrebbe sollecitare, poi inoltrare o terminare come configurato.

Lasci CRM, IVR, appuntamenti e sentiment spenti fino a quando quel lavoro esiste. Strumenti che mostrano **Connect** / **Authorize** restano bloccati fino a quando un admin li connette sotto Integrations (o il pulsante sulla riga).

Transfer stesso è configurato sotto **Call handling - Transfer** (Warm è spesso raccomandato; Attended e Blind sono anche disponibili) - abiliti il percorso dello strumento qui solo quando quel lavoro lo necessita.

## Come l'agent decide di attivare uno strumento

Il prompt dell'ingranaggio è il contratto: *quando* mandare l'SMS, *quando* restare silenzioso. Prompt vaghi si attivano al momento sbagliato.

Il prompt di personalità dovrebbe menzionare lo strumento in una riga. Altrimenti il modello potrebbe non sceglierlo mai, anche quando il toggle è attivo.

## Server MCP

**Add MCP** se ha un server strumenti remoto. Scelga il trasporto (per esempio Streamable HTTP) e l'auth (None, Bearer token, o OAuth). OAuth reindirizza per connettere, poi ritorna e seleziona strumenti. Solo gli strumenti che abilita vengono inviati all'IA. Un MCP che è aggiunto ma non connesso non eseguirà.

Connessioni Claude / ChatGPT aziendali (Edit with AI) sono **Integrations - AI Connections**, non questa lista.

## Risoluzione dei problemi

**Dovrei abilitare tutto?**

No. Abiliti ciò che il lavoro di questo agent richiede. **Enabled** dovrebbe restare una lista breve che può spiegare ad alta voce - non dozzine del catalogo.

**Required menziona Handle Silence**

Silence è impostato per inoltrare, ma Transfer non è pronto. O configuri Transfer sotto Call handling, o cambi l'azione silence a **End the call**.

**Skip Turn è attivo e l'agent parla ancora sopra il numero**

L'ingranaggio non ha prompt, o il prompt è vago. Usi un template **Phone number** (o order/product), imposti timeout / max skips, Save, poi menzioni Skip Turn nel prompt di personalità.

**Il workflow esegue nell'editor ma mai su una chiamata**

Non è attivato per *questo* agent, o il prompt non dice mai al modello quando usarlo. Colleghi + toggle + una riga in Instructions.

## Prossimi passi

[Workflow](https://docs.voicelogica.ai/workflows/) - [Riagganciare](https://docs.voicelogica.ai/agent-configuration/end-call/) - [Trasferimento](https://docs.voicelogica.ai/telephony/transfer/) - [Conoscenza](https://docs.voicelogica.ai/agent-configuration/memory/)