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.
Usa Criteri di Azure in Microsoft Foundry per gestire le configurazioni della casella degli strumenti salvate e gli agenti di prompt senza l'harness di Microsoft Copilot. Usare i controlli dello strumento di Project per limitare l'uso dello strumento di runtime. Mantenere allineati gli elenchi consentiti e verificare il salvataggio e l'esecuzione separatamente.
Questa guida illustra la governance degli strumenti nativi. Non richiede un gateway di intelligenza artificiale. Per il routing del gateway, i limiti di frequenza e le restrizioni IP sul traffico MCP, vedere Gestire gli strumenti MCP usando un gateway di intelligenza artificiale.
Prerequisites
- Un progetto Foundry e il relativo ID risorsa Azure. Usare un progetto di test prima di applicare restrizioni ai carichi di lavoro di produzione.
- Deve disporre del ruolo Proprietario o Resource Policy Contributor nell'ambito in cui si assegna Criteri di Azure. Per altre informazioni, vedere Criteri di Azure e il controllo degli accessi in base al ruolo di Azure.
- Autorizzazione per leggere e aggiornare il progetto Foundry tramite Azure Resource Manager. Le autorizzazioni di assegnazione dei criteri e le autorizzazioni dello strumento di runtime sono separate.
- Per la procedura API REST o Terraform, interfaccia della riga di comando di Azure e
jqin Bash, inclusa Azure Cloud Shell. Accedere alla sottoscrizione che contiene il Project. - Terraform se si sceglie l'opzione Terraform. Nell'esempio viene usato il provider AzAPI per aggiornare un Project esistente.
- Un agente o una cassetta degli attrezzi con accesso funzionante agli strumenti per la verifica. Un elenco di autorizzazioni di governance non concede l'accesso a dati, credenziali o servizi esterni.
Comprendere i due controlli
Criteri di Azure e i controlli degli strumenti di Project hanno impostazioni e punti di imposizione diversi:
-
Criteri di Azure valuta le configurazioni supportate dell'agente prompt e della toolbox rispetto agli strumenti approvati dell'organizzazione. L'effetto
Denyblocca le operazioni di creazione o aggiornamento non conformi.Auditsegnala la mancata conformità senza bloccare tali operazioni. -
Controlli degli strumenti di Project vengono archiviati nella proprietà
properties.toolControlsdi Project e limitano l'uso degli strumenti in fase di esecuzione. ImpostaredefaultActionsuDenyed elencare gli strumenti consentiti inallowedTools.
Questi controlli di Criteri di Azure si applicano attualmente ai toolbox e agli agenti prompt che usano la Responses API senza l'harness Microsoft Copilot.
Gli agenti ospitati eseguono il codice, che questo criterio non controlla, indipendentemente dall'harness o dal framework in uso. Gestisci l'accesso allo strumento Foundry tramite le toolbox che chiamano. Controllare lo stato di conformità di ogni toolbox e configurare Project toolControls per limitare l'uso degli strumenti di runtime tramite il toolbox. Una toolbox non conforme non blocca la creazione dell'agente ospitato.
L'elenco del toolControls.allowedTools progetto è un controllo di runtime, non una regola di convalida per le operazioni CRUD (Agent o Toolbox Create, Read, Update o Delete). Ad esempio, con defaultAction: Deny e solo file_search in allowedTools, è comunque possibile salvare un agente o una casella degli strumenti configurati con web_search, a meno che un criterio Criteri di Azure applicabile blocchi il salvataggio. I controlli di Project bloccano l'uso del runtime di web_search dopo la propagazione delle impostazioni. Il salvataggio di una configurazione degli strumenti non esegue lo strumento.
L'assegnazione di un Criteri di Azure non popola o riscrive toolControls. L'aggiornamento di toolControls non crea o modifica un'assegnazione di criteri. La proprietà del progetto non è una definizione di Criteri di Azure.
Se toolControls è assente, questa funzionalità non limita l'uso dello strumento di runtime del progetto. Altri controlli, inclusi i criteri applicabili, l'autenticazione e le restrizioni di rete, si applicano ancora.
Considerate questi controlli come restrizioni sugli strumenti elaborati da Foundry, non come firewall di rete. Non basarsi su di essi per gestire le chiamate in uscita arbitrarie dal codice dell'agente ospitato. Usare l'isolamento della rete e l'autorizzazione specifica del servizio per tali chiamate.
Assegnare Criteri di Azure per gli strumenti
Il criterio predefinito[Anteprima]: agenti Microsoft Foundry e cassette degli strumenti devono usare solo gli strumenti approvati definisce un elenco di elementi consentiti. Supporta Audit, Deny, e Disabled, e per impostazione predefinita usa Audit.
Disabled ignora la valutazione per l'assegnazione di criteri. Non disabilita i controlli dello strumento di Project.
Inizia con Audit per valutare l'impatto sulle configurazioni supportate di agent e toolbox. Utilizzare Deny per bloccare le operazioni di creazione e aggiornamento non conformi per tali risorse.
Assegnare il criterio a livello di account Foundry quando possibile. Ogni assegnazione ha un limite per il numero di agenti e toolbox che può valutare. Gli ambiti più ampi possono raggiungere questo limite e lasciare alcune risorse non valutate.
Una richiesta deve soddisfare ogni Deny assegnamento applicabile e imposto (logica AND). Se una di queste rifiuta l'operazione di creazione o aggiornamento, un'altra assegnazione non può ignorare tale rifiuto. Per le risorse che necessitano di un'eccezione, vedere esenzioni di Criteri di Azure.
Le modifiche di Criteri di Azure possono richiedere fino a 30 minuti per avere effetto. La reportistica sulla conformità è separata: i risultati possono richiedere fino a 12 ore per essere visualizzati o aggiornati.
- Nel portale di Azure, aprire Criteri e quindi selezionare Definizioni.
- Cercare [Anteprima]: Microsoft Foundry agents e i toolbox devono usare solo gli strumenti approvati. Verificare che l'ID della definizione termini con
e7352ad2-6c86-4a07-9573-47f67b557ba8, aprire la definizione e selezionare Assegna. - Selezionare l'account Foundry come ambito di assegnazione quando possibile e configurare eventuali esclusioni necessarie.
- In Parametri configurare l'effetto e le restrizioni dello strumento:
-
Tipi di strumenti approvati (
approvedToolTypes): identificatori dei tipi di strumenti nel catalogo dei tipi di strumenti. -
Endpoint MCP approvati (
approvedMcpEndpoints): URL o modelli di endpoint del server MCP approvati. -
Connettori MCP approvati (
approvedMcpConnectors): identificatori del connettore MCP approvati.
-
Tipi di strumenti approvati (
- Esaminare l'incarico e crearlo.
- Verificare l'applicazione dopo il ritardo di propagazione dei criteri. Esaminare i risultati di conformità dell'assegnazione separatamente quando sono disponibili.
Per la procedura di assegnazione completa, vedere Creare un'assegnazione di criteri nel portale di Azure.
Per i passaggi di assegnazione dei criteri, selezionare il pivot del portale Azure. Le procedure API REST e Terraform in questo articolo aggiornano i controlli di runtime di Project, non le assegnazioni di criteri.
Scegliere i tipi di strumenti approvati
Utilizzare gli identificatori dei tipi di strumento nel catalogo seguente per approvedToolTypes. Si tratta di un elenco di riferimento, non di un elenco di elementi consentiti consigliato.
[
"a2a",
"azure_ai_search",
"azure_function",
"bing_custom_search",
"bing_grounding",
"browser_automation",
"code_interpreter",
"computer_use",
"custom",
"fabric_dataagent",
"fabric_iq",
"file_search",
"function",
"image_generation",
"mcp",
"memory_search",
"openapi",
"reminder",
"sharepoint_grounding",
"shell",
"toolbox_search",
"web_search",
"work_iq"
]
Selezionare solo i tipi approvati dall'organizzazione. La disponibilità varia in base alla versione dell'API, al modello e all'integrazione dell'agente o del toolbox.
Questo catalogo descrive i valori dei parametri del criterio. Non significa che ogni identificatore sia supportato da Project toolControls o da ogni percorso di runtime. In particolare, l'approvazione di mcp in base al tipo ha un ambito più ampio rispetto all'approvazione di una singola destinazione MCP.
Limitare i target MCP
La politica degli strumenti approvati accetta uno strumento quando il tipo, l'endpoint MCP o il connettore MCP corrisponde a una voce approvata. Si tratta di corrispondenze alternative, non requisiti per cui tutti debbano corrispondere.
Per limitare l'accesso MCP a determinati server, aggiungere i relativi URL a approvedMcpEndpoints o i relativi identificatori di connettore a approvedMcpConnectors. Non aggiungere il tipo generale mcp a approvedToolTypesperché l'azione approva gli strumenti MCP per tipo senza richiedere una corrispondenza tra endpoint o connettore.
Per le restrizioni basate su endpoint, aggiungere l'endpoint MCP del toolbox a approvedMcpEndpoints in ogni assegnazione applicabile. Approvare l'endpoint del toolbox separatamente dagli strumenti al suo interno.
I modelli di endpoint MCP in Criteri di Azure non fanno distinzione tra maiuscole e minuscole. Ogni pattern supporta al massimo un carattere jolly *; le espressioni regolari e altre sintassi di corrispondenza dei pattern non sono supportate.
Ad esempio, https://mcp.contoso.com/* corrisponde agli endpoint in tale host. Un modello come https://*.contoso.com/* non è supportato perché contiene due caratteri jolly. Usare il modello più stretto che soddisfi le proprie esigenze.
Configurare i controlli dello strumento di Project
Project toolControls non ha alcuna modalità di audit. Testa l'elenco di elementi consentiti completo in un progetto di test prima di applicarlo a un progetto con carichi di lavoro in esecuzione. L'applicazione delle modifiche può richiedere alcuni minuti.
Includi tutti gli endpoint MCP usati dai tuoi strumenti in allowedTools per evitare di bloccare involontariamente l'accesso agli strumenti.
Leggere la configurazione del Project corrente prima di modificarla. Gli esempi di API REST e Terraform consentono solo file_search nei controlli degli strumenti del Project. Non configurano lo strumento in un agente o concedono l'accesso a un archivio vettoriale.
La procedura precedente del portale Azure assegna Criteri di Azure; non aggiorna la allow list di runtime del progetto. Selezionare l'API REST o il pivot Terraform per tali aggiornamenti.
Leggere la configurazione corrente del progetto
Impostare gli identificatori del progetto e leggere il progetto. Sostituire i segnaposto con i valori ed eseguire i comandi in questa procedura nella stessa sessione Bash.
SUBSCRIPTION_ID="<subscription-id>"
RESOURCE_GROUP="<resource-group-name>"
FOUNDRY_RESOURCE="<foundry-resource-name>"
PROJECT_NAME="<project-name>"
PROJECT_ID="/subscriptions/$SUBSCRIPTION_ID"
PROJECT_ID+="/resourceGroups/$RESOURCE_GROUP"
PROJECT_ID+="/providers/Microsoft.CognitiveServices/accounts"
PROJECT_ID+="/$FOUNDRY_RESOURCE/projects/$PROJECT_NAME"
PROJECT_URL="https://management.azure.com${PROJECT_ID}"
PROJECT_URL+="?api-version=2026-09-15-preview"
az rest --method get --url "$PROJECT_URL" \
--output json > project-before.json
jq '.properties.toolControls' project-before.json
Il comando visualizza i controlli del progetto archiviati o null se la proprietà è assente. Mantenere project-before.json come record della configurazione precedente.
Riferimento: az rest.
Configurare i controlli dello strumento di progetto con REST
Creare un file denominato
tool-controls.jsoncon il contenuto seguente:{ "properties": { "toolControls": { "defaultAction": "Deny", "allowedTools": [ { "type": "file_search" } ] } } }Questa è la lista delle sostituzioni consentite prevista, non un'istruzione per accodare una voce. Includi ogni strumento necessario per il progetto prima di applicarla. Mantieni tutte le altre impostazioni esistenti
toolControlsnella tua richiesta.Aggiorna il progetto con una richiesta
PATCH. Usare l'ETag dal progetto letto per evitare di sovrascrivere una modifica simultanea.ETAG=$(jq -r '.etag // .eTag // empty' project-before.json) if [ -z "$ETAG" ]; then printf 'No project ETag returned. Stop without updating.\n' >&2 exit 1 fi az rest --method patch --url "$PROJECT_URL" \ --headers "Content-Type=application/json" "If-Match=$ETAG" \ --body @tool-controls.jsonSe l'aggiornamento non riesce, arrestare e controllare l'errore. Per una modifica simultanea, leggere di nuovo il progetto e riconciliare le modifiche prima di inviare una nuova richiesta.
Riferimento: az rest.
Dopo l'aggiornamento, verificare i controlli del progetto archiviati.
Aggiornare i controlli dello strumento di progetto con Terraform
Usare azapi_update_resource per gestire toolControls in un progetto esistente senza creare o sostituire il progetto. Questa opzione modifica i controlli del progetto, non le assegnazioni di Criteri di Azure.
Scegliere REST o Terraform per gestire queste impostazioni. Non gestire la stessa proprietà tramite più risorse Terraform.
Creare
main.tfcon il contenuto seguente:terraform { required_providers { azapi = { source = "Azure/azapi" version = "~> 2.13.0" } } } variable "subscription_id" { type = string } variable "tenant_id" { type = string } variable "project_resource_id" { type = string } provider "azapi" { subscription_id = var.subscription_id tenant_id = var.tenant_id use_cli = true use_msi = false use_oidc = false skip_provider_registration = true } resource "azapi_update_resource" "tool_controls" { type = "Microsoft.CognitiveServices/accounts/projects@2026-09-15-preview" resource_id = var.project_resource_id body = { properties = { toolControls = { defaultAction = "Deny" allowedTools = [ { type = "file_search" } ] } } } ignore_missing_property = false response_export_values = ["properties.toolControls"] } output "tool_controls" { value = azapi_update_resource.tool_controls.output.properties.toolControls }Riferimento: azapi_update_resource.
In questo esempio viene sostituito l'elenco elementi consentiti del progetto con
file_search. Includi tutti gli strumenti necessari e conserva eventuali altre impostazioni esistentitoolControlsprima di applicarla. Per le voci MCP, usare un concretoserverUrloconnectorId.Creare
terraform.tfvarscon i dettagli del progetto:subscription_id = "<subscription-id>" tenant_id = "<tenant-id>" project_resource_id = "<full-project-resource-id>"Riferimento: variabili di input terraform.
Usare l'ID risorsa completo Azure, non l'endpoint del progetto. Verificare che l'accesso ad interfaccia della riga di comando di Azure e che la sottoscrizione e il tenant forniti siano quelli del progetto.
Inizializzare il provider ed esaminare un piano salvato:
terraform init terraform fmt -check terraform validate terraform plan -out=tool-controls.tfplanRiferimento: terraform plan.
Verificare che il piano riguardi il progetto esistente previsto e che vengano modificati solo i controlli richiesti. Terraform può mostrare la risorsa di aggiornamento come aggiunta allo stato; questo non significa che crea un progetto Azure.
Applicare il piano salvato ed esaminare i controlli risultanti:
terraform apply tool-controls.tfplan terraform output -json tool_controls terraform plan -detailed-exitcodeRiferimento: terraform apply e terraform output.
L'output contiene
defaultAction: Denye un arrayallowedToolscontenente solofile_search. Un secondo piano non deve segnalare alcuna modifica e restituire il codice0di uscita . Dopo aver applicato il piano, verificare i controlli del progetto archiviati.
L'eliminazione di un azapi_update_resource lo rimuove dallo stato di Terraform. Non elimina il progetto Azure, non rimuove i controlli né ripristina i valori precedenti. Per modificare o ripristinare i controlli, applicare in modo esplicito la configurazione desiderata; non usare terraform destroy come rollback.
Verificare i controlli del progetto archiviati
Attendere il completamento dell'aggiornamento del progetto e quindi leggere di nuovo la configurazione archiviata:
az rest --method get --url "$PROJECT_URL" --output json \
--query "properties.{state:provisioningState,toolControls:toolControls}"
Se il provisioning è ancora in corso, ripetere la lettura. Se il provisioning non riesce, arrestare e controllare l'errore dell'operazione. Verificare che lo stato sia Succeeded e che l'elenco elementi consentiti archiviati corrisponda alla configurazione desiderata.
Un aggiornamento accettato non è una prova che l'imposizione a runtime si sia propagata. Attendere alcuni minuti affinché le modifiche toolControls abbiano effetto prima di controllare il comportamento di runtime.
Riferimento: az rest.
Aggiungere un server MCP all'elenco di elementi consentiti di runtime
Per un server MCP, aggiungi un target specifico all'array allowedTools. Usa l'URL del server utilizzato dall'agente o dal toolbox:
{
"type": "mcp",
"serverUrl": "https://mcp.contoso.com/mcp"
}
Per uno strumento MCP basato su connettore, usa invece il relativo identificatore del connettore:
{
"type": "mcp",
"connectorId": "<approved-connector-id>"
}
Questi frammenti sono singole voci allowedTools, non richieste complete di aggiornamento del progetto. Ogni voce MCP deve specificare esattamente uno di serverUrl o connectorId. Una voce costituita dal solo {"type": "mcp"} non è valida.
Usare gli URL effettivi del server o gli identificatori effettivi del connettore nella configurazione del progetto. Mantieni separati i modelli di endpoint di Criteri di Azure da queste voci concrete del progetto.
Per una toolbox a cui si accede tramite MCP, includere l'endpoint, gli strumenti necessari e ogni endpoint MCP usato da tali strumenti in allowedTools. L'autorizzazione di uno strumento interno non approva automaticamente la connessione MCP esterna.
Confronta il comportamento previsto delle policy
La tabella seguente distingue la valutazione dei criteri degli strumenti approvati dai controlli di runtime del Project. I controlli degli strumenti di Project non convalidano le operazioni CRUD dell'agente o del toolbox.
Nelle colonne agent/toolbox, agent indica un agente prompt che usa l'API Responses senza il harness Copilot. I prompt agent con harness Copilot non vengono attualmente valutati. Per gli agenti ospitati, il criterio valuta i toolbox che usano, non il codice o la creazione dell'agente ospitato.
Questi scenari presuppongono richieste valide, autorizzazioni necessarie e impostazioni propagate. Per quanto riguarda Deny, si presuppone anche che l'applicazione sia abilitata.
| Configuration | Versioni esistenti dell'agente o della casella degli strumenti | Creare o aggiornare l'agente o il toolbox | Runtime |
|---|---|---|---|
| Solo controlli Project | Nessuna valutazione dei criteri di policy. | Consentito; nessun controllo Project-control. | I controlli di Project consentono o negano l'uso dello strumento. |
Politica degli strumenti approvati con Deny |
Le mancate corrispondenze di definizione vengono segnalate; le versioni non vengono riscritte. | Le operazioni di scrittura non conformi vengono rifiutate. | I controlli di Project consentono o negano l'uso dello strumento. |
Politica degli strumenti approvati con Audit |
Le mancate corrispondenze di definizione vengono segnalate; le versioni non vengono riscritte. | Consentito; le incongruenze delle policy vengono controllate, non negate. | I controlli di Project consentono o negano l'uso dello strumento. |
Audit e Disabled non sovrascrivono le restrizioni del Project. Lo stato di conformità del criterio non blocca le chiamate dello strumento di runtime. Il runtime usa i controlli degli strumenti archiviati del progetto, inclusi per le definizioni degli strumenti inline e le versioni dell'agente salvate in precedenza.
Le versioni esistenti non sono modificabili. Per modificare una definizione, creare una versione conforme anziché riscrivere quella precedente. Per una toolbox, è possibile impostare come predefinita la versione conforme. La modifica del valore predefinito non modifica le versioni mantenute o i client bloccati a esse.
Eliminare le versioni inutilizzate
Eliminare le versioni inutilizzate come parte della manutenzione di routine per tutti gli agenti e i toolbox, anche quando i controlli degli strumenti del progetto non sono configurati. Mantenere le versioni necessarie per le applicazioni attive o i piani di rollback.
Per indicazioni, vedere Limiti della versione del servizio Agent e Eliminare una versione del toolbox.
Verificare il salvataggio e l'esecuzione separatamente
Usare un test Project e strumenti che non apportano modifiche indesiderate ai sistemi esterni. Per i controlli al momento del salvataggio, usare una casella degli strumenti o un agente di prompt senza Copilot harness. Controllare sia i percorsi di configurazione che di runtime dopo la propagazione dei criteri e delle modifiche del Project.
- Leggere le assegnazioni dei criteri degli strumenti approvati nell'ambito del Project, incluse le assegnazioni ereditate. Verificare l'ID della definizione
approvedToolTypese i parametri MCP, gli effetti e le impostazioni di imposizione. - Leggere la
toolControlsdel progetto e verificare che siano elencati gli strumenti di runtime necessari. - Salva una versione dell'agente o della cassetta degli strumenti con uno strumento approvato. Verificare che il salvataggio abbia esito positivo.
- Con un criterio imposto
Deny, provate a salvare una versione contenente uno strumento non incluso nell'insieme approvato dal criterio. Conferma che il salvataggio sia bloccato. - Eseguire un agente che usa uno strumento consentito dalla configurazione del progetto. Confermare che possa usare lo strumento, con la normale autenticazione e le normali autorizzazioni.
- Nel progetto di test usare uno strumento che Criteri di Azure consente, ma i controlli del progetto escludono. Verificare che un nuovo agente o salvataggio della casella degli strumenti abbia esito positivo, ma l'uso di runtime di tale strumento è bloccato.
- Testa uno strumento escluso dai controlli di Project in due configurazioni: nessun criterio per agent/toolbox e un'assegnazione
Audit. I salvataggi dovrebbero andare a buon fine; l'accesso in fase di esecuzione dovrebbe rimanere bloccato. - Verificare una versione salvata esistente dopo averne limitato lo strumento nei controlli di Project. Confermare che l'accesso in fase di esecuzione sia bloccato senza riscrivere la versione salvata.
Non considerare un salvataggio corretto, un risultato dei criteri conforme o un aggiornamento di progetto riuscito come prova che un agente possa funzionare. Controllare il percorso di runtime effettivo usato dall'applicazione.
Attendere fino a 30 minuti per rendere effettive le modifiche ai criteri. Le modifiche apportate a toolControls possono richiedere alcuni minuti, anche quando si ripristina l'accesso in fase di esecuzione.
Risoluzione dei problemi relativi alla governance degli strumenti
Identificare se il problema si verifica durante il salvataggio di una configurazione o l'esecuzione di un agente prima di modificare uno dei controlli. Gli esempi di criteri al momento del salvataggio si applicano alle caselle degli strumenti e agli agenti prompt senza l'harness di Copilot.
Viene eseguito uno strumento, ma non è possibile salvare una nuova versione dell'agente
Un amministratore può rendere più restrittivi i criteri relativi ad agent e toolbox senza modificare i controlli di Project. Se i controlli di Project consentono uno strumento all'esterno del set approvato del criterio, una richiesta di runtime inline o una versione esistente può usarlo. Il salvataggio di una nuova versione con tale strumento è bloccato dall'effetto Deny del criterio.
Esaminare il criterio indicato nell'errore di salvataggio e confrontarlo con la lista consentita del Project. Collaborare con l'amministratore per allineare la configurazione del progetto e la definizione dell'agente alla policy. Non presupporre che l'assegnazione di una policy cambi automaticamente i controlli di runtime esistenti.
Una versione dell'agente viene salvata, ma la richiesta di runtime è bloccata
Una nuova versione dell'agente o del toolbox può superare i controlli di Criteri di Azure anche quando i relativi strumenti non sono in toolControls.allowedTools. Ad esempio, il criterio consente web_search, ma il Project consente solo file_search. Il salvataggio ha esito positivo, ma la ricerca Web di runtime è bloccata.
La stessa situazione si applica alle versioni esistenti dopo la modifica dei controlli di Project. I controlli di Project non rifiutano né riscrivono le definizioni salvate.
Rimuovere lo strumento escluso dall'agente o chiedere a un amministratore del progetto autorizzato di aggiornare l'elenco di elementi consentiti di runtime all'interno della configurazione approvata dell'organizzazione.
Uno strumento MCP è bloccato anche se lo strumento interno è consentito
Controllare l'URL del server MCP o l'identificatore del connettore nella configurazione dello strumento dell'agente. Per una casella degli strumenti accessibile tramite MCP, controllare l'endpoint, gli strumenti necessari e ogni endpoint MCP usato da tali strumenti. Aggiungere eventuali voci necessarie mancanti a toolControls.allowedTools anziché consentire in generale l'accesso MCP.
Un criterio di policy segnala la mancata conformità, ma non blocca un salvataggio
Controllare prima il tipo di agente. Questi controlli dei criteri non valutano attualmente gli agenti prompt che usano il Copilot harness. Per un agente ospitato, testare la configurazione del toolbox anziché la creazione dell'agente ospitato.
Per i tipi supportati, controllare l'effetto e la modalità di imposizione dei criteri.
Audit segnala la mancata conformità; non blocca l'operazione. Verificare che l'assegnazione si applichi all'ambito previsto e che le modifiche ai criteri siano state propagate.
Un tipo di strumento specifico o un endpoint MCP viene comunque salvato dopo l'assegnazione di un criterio Di negazione
Per prima cosa, identifica quale impostazione hai modificato.
toolControls Project non blocca i salvataggi, anche quando defaultAction è Deny. Verificare l'uso dello strumento di runtime di test per verificare tale controllo.
Per un'assegnazione di Criteri di Azure, esaminare l'ID della definizione e i parametri. La definizione degli strumenti approvati usa approvedToolTypes. Omettere web_search dall'elenco approvato per rendere non conforme una configurazione contenente tale strumento.
Cinque minuti non sono sufficienti per escludere la propagazione dei criteri. Attendere fino a 30 minuti, confermare l'ambito dell'assegnazione e la modalità di applicazione e riprovare con un toolbox o un agente di prompt senza l'harness di Copilot. L'aggiornamento dei report di conformità può richiedere fino a 12 ore; tale ritardo di segnalazione è separato dall'applicazione.
Se una nuova versione del toolbox contenente web_search continua a essere salvata anche dopo che un'assegnazione Deny applicabile e applicata è stata propagata, ciò non è spiegato dalle esclusioni dell'agente ospitato o di Copilot-harness. Acquisire la definizione dei criteri e gli ID di assegnazione, l'ID della risorsa di destinazione e i dettagli della richiesta di salvataggio affinché il supporto possa analizzarli.
Uno strumento consentito continua a non funzionare
Un elenco di elementi consentiti non concede autorizzazioni o configura la connettività. Controllare la connessione, le credenziali, l'accesso ai dati e le impostazioni di rete dello strumento. Per l'autenticazione MCP, vedere Configurare l'autenticazione per gli strumenti MCP.
Contenuti correlati
Usare queste guide per configurare l'accesso agli strumenti e i controlli complementari: