Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Una flotta di agenti è un set di agenti eseguiti in un runtime cloud condiviso. Ad esempio, una piattaforma che consente ai team o ai clienti di distribuire i propri agenti ospita ogni nuovo agente nella stessa base di calcolo e codice. Ogni agente della flotta ottiene la propria identità dell'agente, in modo che gli accessi, le autorizzazioni e i record di controllo rimangano separati dagli altri agenti.
Il runtime contiene una singola credenziale del progetto di identità dell'agente e la usa per acquisire i token per qualsiasi identità dell'agente creata da tale progetto. Il runtime sceglie l'identità dell'agente da usare in ogni richiesta di token.
Scegliere tra un singolo agente e una flotta
| Consideration | Agente singolo | Flotta di agenti |
|---|---|---|
| Numero di agenti per implementazione | One | Molti elementi vengono aggiunti e rimossi in fase di esecuzione |
| Quando vengono create le identità dell'agente | Prima della distribuzione dell'agente, a opera di uno sviluppatore o di un amministratore | Quando ogni agente viene distribuito, dal runtime o da Agent 365 |
| Da dove proviene l'ID identità dell'agente | Configuration | Una ricerca a ogni richiesta |
| Modalità di concessione dell'accesso | Per l'identità dell'agente, prima della distribuzione dell'agente | Per ogni identità dell'agente, quando viene effettuato il provisioning dell'agente |
| Guidance | Crea agenti cloud con ASP.NET Core o sidecar Auth SDK | Questo articolo e gli articoli della flotta che lo seguono |
Il runtime della flotta seleziona l'identità di un agente per ogni operazione. Seguire gli esempi della flotta in questo percorso: le esercitazioni sull'agente cloud usano un'identità configurata e omettono la selezione dell'identità per richiesta richiesta da una flotta.
Components
| Componente | Purpose | Cardinalità |
|---|---|---|
| Progetto di identità dell'agente | Definisce le autorizzazioni, l'ambito in ingresso e i ruoli dell'app della flotta. Crea ed elimina le identità degli agenti. | Uno per flotta o uno per ogni tipo di agente |
| Credenziale blueprint | Autentica il runtime come blueprint. Usare una credenziale federata con identità gestita nell'ambiente di produzione. | Uno per modello |
| L'identità dell'agente | Rappresenta un agente. Riceve i token di accesso usati per chiamare le API. | Uno per agente |
| Account utente dell'agente | Fornisce a un agente un oggetto utente per i carichi di lavoro di Microsoft 365, ad esempio una cassetta postale o l'appartenenza a Teams. | Facoltativo, al massimo uno per identità agente |
| Directory agente | Archivio del runtime che esegue il mapping di ogni agente all'identità dell'agente e all'account utente dell'agente. | Uno per ogni flotta |
| Servizio di provisioning | Crea ed elimina le identità quando gli agenti vengono distribuiti e ritirati. | Una per flotta |
| Gestore di token | Acquisisce i token per una determinata identità agente. Microsoft.Identity.Web nel processo di runtime o nel sidecar di Auth SDK. | Uno o più per runtime |
Ciclo di vita dell'agente
- Distribuisci. Un utente o una pipeline effettua il deployment di un nuovo agente nel runtime.
- Provvigione. Il servizio di provisioning crea un'identità agente dal modello. Se l'agente necessita di funzionalità utente Microsoft 365, crea anche l'account utente di un agente. Registra entrambi gli ID nella directory dell'agente e all'identità dell'agente viene concesso l'accesso necessario all'agente.
- Correre. Per ogni operazione, il runtime cerca l'identità dell'agente nella directory dell'agente e la passa al broker di token.
- Disattiva. Il servizio di provisioning elimina l'account utente dell'agente e quindi l'identità dell'agente e rimuove la voce della directory dell'agente.
Scegliere la modalità di provisioning degli agenti
| Option | Funzionamento | Usarlo quando |
|---|---|---|
| Il runtime effettua il provisioning delle identità | Il servizio di provisioning esegue l'autenticazione come blueprint e chiama Microsoft Graph per creare ed eliminare le identità degli agenti e gli account utente dell'agente. | Il runtime controlla la distribuzione dell'agente. |
| Agent 365 esegue il provisioning delle identità | Agent 365 crea l'identità dell'agente quando un agente viene sottoposto a provisioning. Il runtime è in ascolto degli eventi di provisioning dell'agente, che includono l'ID identità dell'agente, e registra tale ID nella directory dell'agente. | Gli agenti vengono creati tramite esperienze di Microsoft 365. Per informazioni dettagliate, vedere la documentazione per sviluppatori di Agent 365. |
Entrambe le opzioni producono la stessa voce di directory dell'agente. Il resto delle linee guida della flotta si applica a entrambe le opzioni.
Selezionare l'identità dell'agente in ogni richiesta
Le credenziali del blueprint possono acquisire token per ogni identità dell'agente creata dal blueprint. Il codice di runtime che sceglie l'identità dell'agente è quindi un confine di sicurezza.
- Risolvere l'identità dell'agente dalla directory dell'agente usando una chiave che il runtime controlla, ad esempio il proprio ID agente.
- Non accettare un ID client di identità agente o l'ID dell'account utente dell'agente da una richiesta, un prompt o un output dello strumento.
- Verificare che il chiamante sia autorizzato a usare l'agente di destinazione prima di richiedere un token per esso.
Pianificare i confini di attendibilità
- Tenere la credenziale lontano dal codice dell'agente. Conservare la credenziale blueprint nel runtime o nel sidecar, mai nel codice che l'autore di un agente o un modello controlla.
- Isolare il broker di token. Se gli agenti eseguono codice non attendibile o fornito dal cliente, non consentire a tale codice di chiamare direttamente il broker di token. Un processo che può raggiungere il broker può richiedere un token per qualsiasi agente nella flotta.
- Separare il provisioning dall'acquisizione di token. Il servizio di provisioning usa token blueprint che possono creare ed eliminare identità. Eseguirlo con il proprio percorso di accesso in modo che il codice dell'agente non possa richiedere tali token.
- Limitare l'impatto. Usare più progetti quando i gruppi di agenti vengono eseguiti in zone di attendibilità diverse o appartengono a clienti diversi.
Pianificazione dei limiti
Un principal del blueprint può creare al massimo 250 identità dell'agente. Per una flotta più grande, creare più blueprint e assegnare ogni agente a un blueprint al momento del provisioning. Registrare il blueprint nella voce della directory dell'agente. Per informazioni dettagliate, vedere principali del blueprint dell'identità dell'agente.
Gli articoli di implementazione che seguono usano un blueprint per ogni configurazione di runtime. Se si estendono a più blueprint, risolvere anche la configurazione e la credenziale del blueprint corrispondenti per ogni agente; la selezione di un ID agente da solo non seleziona un blueprint diverso. Il record della directory di esempio deve essere esteso per tale configurazione.
Concedere l'accesso a ogni agente
Assegnare a ogni identità agente solo l'accesso necessario all'agente. Concedere le autorizzazioni dell'applicazione, le autorizzazioni delegate, Azure le assegnazioni di ruolo e l'accesso ad altre risorse direttamente all'identità dell'agente, come parte del provisioning o subito dopo. Le concessioni per agente mantengono separato l'accesso di ogni agente, in modo da poter esaminare, modificare o revocare l'accesso di un agente senza influire sul resto della flotta. Per i modi per concedere l'accesso, vedere Concedere le autorizzazioni dell'applicazione e Concedere autorizzazioni delegate.
Per le autorizzazioni necessarie per ogni agente nella flotta, è possibile usare le autorizzazioni ereditabili per praticità. Un amministratore concede queste autorizzazioni una sola volta all'entità progetto e ogni identità dell'agente creata dal progetto le riceve nei token. Le autorizzazioni ereditate non vengono visualizzate nell'identità dell'agente, quindi le concessioni per agente sono più facili da controllare.
Instradare le richieste utente agli agenti
Gli utenti chiamano un agente della flotta con un token di accesso per l'ambito del access_agent blueprint. Ogni agente della flotta condivide tale gruppo di destinatari, quindi il token dimostra chi è l'utente, ma non identifica l'agente. Il runtime deve:
- Determinare l'agente di destinazione dalla richiesta, ad esempio da un segmento del percorso.
- Verificare che l'utente sia autorizzato a utilizzare quell'agente. I ruoli dell'app nel blueprint si applicano all'intera flotta, quindi applica l'accesso per agente nel runtime.
- Usare l'identità dell'agente di destinazione per qualsiasi richiesta di token OBO (On-Behalf-Of).
Passaggio successivo
Configurare un modello di identità dell'agente per una flotta