Con Agent Builder puoi creare un agente dichiarativo per Microsoft 365 Copilot definendone il compito, le istruzioni e le fonti di conoscenza, poi provarlo e condividerlo. È pensato per assistenti mirati e semplici; per azioni che coinvolgono servizi esterni, flussi di lavoro a basso codice o distribuzione su più canali, Microsoft indirizza a Copilot Studio.
Quando scegliere Agent Builder
Agent Builder è adatto a un assistente circoscritto, per esempio uno che aiuta il team di vendita a preparare materiali a partire da informazioni aziendali. Microsoft lo descrive come uno strumento per creare agenti dichiarativi in modo rapido. Se il progetto deve eseguire azioni su servizi esterni o funzionare su più canali, la scelta indicata da Microsoft è Copilot Studio. (Microsoft Learn: Agent Builder)
| Esigenza | Agent Builder | Copilot Studio |
| Creare un agente dichiarativo per un compito semplice e circoscritto | È il caso d’uso indicato da Microsoft | Percorso per esigenze di sviluppo più articolate |
| Collegare azioni a servizi esterni o creare flussi a basso codice | Non permette di creare queste azioni | Microsoft lo indica per azioni, connettori e flussi di lavoro |
| Distribuire l’agente su più canali | Non è il percorso indicato per questa esigenza | Microsoft lo indica per la distribuzione multicanale |
Puoi aprire Agent Builder da microsoft365.com/chat, office.com/chat oppure da Microsoft Teams sul web o desktop. Le versioni mobili delle app e dei siti elencati non sono tra i punti di accesso indicati da Microsoft. Le fonti disponibili possono dipendere dalle licenze assegnate e dalla configurazione del tenant.
Definisci il compito e le istruzioni
Prima di configurare l’agente, chiarisci a chi serve e quale lavoro deve svolgere. Per esempio, un assistente commerciale potrebbe aiutare a preparare una bozza di proposta usando informazioni aziendali. Specifica il tipo di risposta attesa e delimita il compito: istruzioni precise rendono più semplice capire se l’agente sta rispondendo nel modo utile.
- Apri Agent Builder da uno dei punti di accesso web o desktop indicati da Microsoft.
- Descrivi in linguaggio naturale il compito dell’agente, oppure passa alla configurazione manuale.
- Rivedi e adatta le istruzioni generate o inserite: devono rispecchiare il lavoro previsto e i limiti dell’assistente.
Scegli le fonti di conoscenza
Aggiungi le fonti pertinenti al compito, non tutto ciò che è disponibile. Agent Builder supporta, tra le altre, pagine web pubbliche, SharePoint, OneDrive, chat e riunioni di Teams, email di Outlook, file caricati e connettori di Microsoft 365 Copilot. La disponibilità può variare in base alle licenze e alla configurazione del tenant. (Microsoft Learn: aggiungere fonti di conoscenza)
Microsoft indica questi limiti per agente:
| Fonte | Limite per agente |
| URL di siti web pubblici | 4 |
| File di SharePoint | 100 |
| Elenchi di SharePoint | 1 |
| File di OneDrive | 50 |
| Chat di Teams | 5 |
| Riunioni di Teams | 5 |
| File caricati | 20 |
Per scegliere file e contenuti cloud, cerca nella sezione dedicata e seleziona le fonti utili al lavoro dell’agente. Se servono altri tipi di dati, l’interfaccia mostra anche un’opzione per altre origini e alcuni connettori.
Imposta l’uso del web e prova le risposte
Se l’agente deve usare contenuti web, considera sia l’impostazione visibile nell’interfaccia sia le regole del tenant. La policy amministrativa Allow web search in Copilot prevale sull’interruttore Web content: se la policy blocca i contenuti web, l’interruttore può risultare attivo senza consentirne l’uso.
Prima di condividere l’agente, provalo con richieste rappresentative del compito e rivedi le risposte. Se non sono adatte, torna alle istruzioni o alle fonti e correggi la configurazione. Microsoft raccomanda di testarlo prima di usarlo, condividerlo o pubblicarlo.
Prima di aggiungere una fonte o invitare colleghi, chiediti quali contenuti servono davvero e chi deve poterli consultare.
Condividilo con i permessi adatti
Gli agenti sono privati all’inizio. Per consentire ad altri di usarli, scegli il ruolo Can chat, che permette di interagire con l’agente, oppure Can edit, che assegna diritti di modifica, condivisione e gestione a livello di proprietario. La pubblicazione nel catalogo dell’organizzazione è un passaggio distinto e richiede la revisione e l’approvazione di un amministratore. (Microsoft Learn: condividere e gestire gli agenti)
La condivisione dell’agente non assegna automaticamente ai colleghi l’accesso ai file collegati in SharePoint o OneDrive: per queste fonti continuano a valere i permessi e le etichette di riservatezza già applicati. I file caricati nell’agente, invece, possono essere usati per generare risposte a chi può accedere all’agente, nel rispetto delle autorizzazioni previste dalle etichette di riservatezza del contenuto. Scegli quindi con attenzione cosa caricare prima di concedere l’accesso.