Usare Microsoft Entra Agent ID con Microsoft Foundry

Microsoft Foundry include il supporto predefinito per Microsoft Entra Agent ID. Foundry crea e gestisce il blueprint di identità dell'agente, Agent ID e le credenziali della piattaforma. Non si aggiunge un segreto client o si implementa lo scambio di token ID agente.

Usare il modello a oggetti dell'agente Foundry corrente per acconsentire esplicitamente a questa integrazione. Gli agenti che usano il modello legacy continuano a usare un'identità del progetto condiviso o un'identità dell'applicazione agente.

Prerequisites

  • Un progetto di Microsoft Foundry.
  • Autorizzazione per creare agenti nel progetto.
  • Autorizzazione per concedere all'ID agente l'accesso a ogni risorsa downstream.

Creare un agente con ID agente

Creare un nuovo agente usando il modello dell'agente Foundry corrente. Un nuovo agente riceve:

  • Un modello univoco di identità dell'agente.
  • Un ID agente univoco per la sua istanza predefinita.
  • Endpoint dell'agente stabile.
  • Credenziale federata gestita dalla piattaforma usata da Foundry per lo scambio di token.

Seguire Configurare e condividere l'agente Microsoft Foundry per creare e configurare l'agente.

Se il progetto contiene un agente legacy, creare un nuovo agente dalla stessa definizione. Foundry non aggiunge direttamente un ID agente univoco a un agente legacy. Per i passaggi di consenso esplicito e migrazione, vedere Eseguire la migrazione da applicazioni agente al nuovo modello di agente Microsoft Foundry.

Verificare l'identità dell'agente

Recupera o esamina l'agente e verifica che instance_identity non sia null. Un valore non Null identifica un agente creato con il modello corrente.

Foundry gestisce la credenziale del blueprint e lo scambio di token di runtime. Non creare altre credenziali per il blueprint gestito da Foundry.

Per informazioni dettagliate sugli oggetti creati da Foundry, vedere Concetti relativi all'identità dell'agente in Microsoft Foundry.

Concedere l'accesso a una risorsa

I nuovi ID agente iniziano senza autorizzazioni per le risorse. Concedere l'accesso all'ID agente usato dalla chiamata allo strumento:

  • Per una risorsa Azure, assegnare il ruolo di Azure con privilegi minimi nell'ambito pratico più ristretto.
  • Per un'API personalizzata, assegnare l'autorizzazione dell'applicazione o il ruolo dell'app richiesto.
  • Per l'accesso delegato, configurare una connessione di delega utente supportata e ottenere il consenso.

Usare l'ID oggetto dell'ID agente, non l'ID client, quando un'assegnazione di ruolo Azure richiede un ID entità.

Per gli strumenti e i modelli di autorizzazione supportati, vedere Autorizzazioni e limiti di accesso in Microsoft Foundry.