Procedure consigliate per gli strumenti per Microsoft servizio agente Foundry

Quando si compilano agenti in Microsoft servizio agente Foundry, gli strumenti estendono le operazioni che l'agente può eseguire, recuperando informazioni, chiamando LE API e connettendosi a servizi esterni. Questo articolo illustra come configurare gli strumenti in modo efficace, controllare quando l'agente li chiama e proteggere i dati.

Mancia

Nelle istruzioni dell'agente descrivere il valore di ogni strumento e quando usarlo. Per esempio:

When you need information from my indexed documents, use File Search. When you need to call an API, use the OpenAPI tool. When a tool call fails or returns no results, explain what happened and ask a follow-up question.

Prerequisiti

• Accedere a un progetto Foundry nel portale foundry con il ruolo Azure developer di intelligenza artificiale o autorizzazioni equivalenti.
• Modello distribuito nello stesso progetto.
• Tutte le connessioni necessarie configurate per gli strumenti che si prevede di usare( ad esempio, Azure AI Search, SharePoint o Bing a terra).

Configurare e convalidare l'utilizzo degli strumenti

• Configurare strumenti e connessioni nel catalogo degli strumenti Foundry. Vedere Individuare e gestire gli strumenti nel catalogo degli strumenti Foundry (anteprima).
• Esaminare le tracce di esecuzione per verificare quando l'agente chiama gli strumenti e controllare gli input e gli output degli strumenti. Per la configurazione della traccia end-to-end, vedere Tracciare l'applicazione.

Migliorare l'affidabilità delle chiamate agli strumenti

Chiamare lo strumento di controllo con tool_choice

Usare tool_choice per il controllo più deterministico sulle chiamate agli strumenti.

• auto: il modello decide se chiamare gli strumenti.
• required: il modello deve chiamare uno o più strumenti.
• none: il modello non chiama gli strumenti.

Per informazioni dettagliate, vedere in tool_choiceREST del progetto Foundry (anteprima).

Scrivere istruzioni efficaci per gli strumenti

• Mantenere le istruzioni specifiche e coerenti con la configurazione dello strumento.
• Indicare al modello il valore di ogni strumento.
• Se sono presenti più strumenti che si sovrappongono, aggiungere una regola decisionale, ad esempio "Usa ricerca file prima della ricerca Web per il contenuto interno".

Utilizzo sicuro degli strumenti

Gli strumenti inviano e ricevono dati all'esterno del modello. Ridurre i rischi per la sicurezza e la privacy con queste procedure:

• Considerare gli output dello strumento come input non attendibile e convalidare i valori critici prima di agire su di essi.
• Inviare solo le informazioni necessarie per completare l'attività.
• Non includere chiavi, token o altre credenziali nelle richieste.
• Evitare di registrare segreti nelle tracce o nei log applicazioni.
• Se ci si connette a server MCP non servizi Microsoft (ad esempio, server MCP di terze parti), esaminare le considerazioni in Discover e gestire gli strumenti nel catalogo degli strumenti Foundry (anteprima).
• Se è necessario un routing centralizzato e l'applicazione dei criteri per gli strumenti MCP, vedere Strumenti di governance con gateway di intelligenza artificiale (anteprima).

Supporto degli strumenti in base all'area geografica e al modello

Area e modello determinano quali strumenti sono disponibili per l'agente.

Nota

Nelle tabelle seguenti: Sì significa completamente supportato, No significa non supportato e Limited significa supporto parziale che varia in base alla configurazione dello strumento. Per informazioni dettagliate, vedere la documentazione dei singoli strumenti.

La tabella seguente illustra la disponibilità degli strumenti in base all'area.

Nota

Questa tabella di disponibilità dell'area account solo per la disponibilità del servizio. È necessario assicurarsi che il modello che si vuole usare sia disponibile anche nella stessa area.

Nome area	Agent2Agent	Azure AI Search	Automazione del browser	Interprete di codice	Uso computer	agente dati Fabric	Ricerca file	Funzione	Base con Ricerca personalizzata Bing	Base con Ricerca Bing	Generazione di immagini	MCP	OpenAPI	SharePoint	Ricerca Web
australiaeast	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
brasilesouth	Sì	Sì	Sì	Sì	No	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì
canadaeast	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
eastus	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
eastus2	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
francecentral	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
germaniawestcentral	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
italynorth	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
japaneast	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
koreacentral	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
northcentralus	Sì	Sì	Sì	Sì	No	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì
norvegiaeast	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
poloniacentral	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
southafricanorth	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
southcentralus	Sì	Sì	Sì	No	No	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì
sudestasia	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
southindia	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
spagnacentral	Sì	Sì	Sì	No	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
sveziacentral	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
svizzeranorth	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
uaenorth	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
uksouth	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
westus	Sì	Sì	Sì	Sì	No	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì
westus3	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì

Gli strumenti sono supportati dai modelli seguenti.

Nota

Per lo strumento di generazione di immagini, è necessario sia il modello gpt-image-1 che un modello LLM (Large Language Model) come agente di orchestrazione nello stesso progetto Microsoft Foundry.

Modello	Agent2Agent	Azure AI Search	Funzioni di Azure	Base personalizzata bing	Ricerca Bing a terra	Automazione del browser	Interprete di codice	Uso computer	agente dati Fabric	Ricerca file	Funzioni	Generazione di immagini	MCP	OpenAPI	SharePoint	Ricerca Web
Cohere-command-r	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
Cohere-command-r-plus	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
DeepSeek-R1-0528	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
DeepSeek-V3-0324	No	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	No
DeepSeek-V3.1	No	No	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	No
FW-DeepSeek-V3.1	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-DeepSeek-V3.2	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-GLM-4.7	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-GLM-5	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-GPT-OSS-120B	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-Kimi-K2-Instruct-0905	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-Kimi-K2-Thinking	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-Kimi-K2.5	No	No	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-MiniMax-M2.5	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	No
FW-Qwen3.5-122B-A10B	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	Sì
FW-Qwen3.5-397B-A17B	No	Sì	No	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	Sì
Llama-3.3-70B-Instruct	No	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
Llama-4-Maverick-17B-128E-Instruct-FP8	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
Llama-4-Scout-17B-16E-Instruct	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
MAI-DS-R1	Sì	No	No	No	No	Sì	Sì	No	No	Sì	Sì	No	Sì	No	No	No
Meta-Llama-3.1-405B-Instruct	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
Mistral-large-2407	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
codex-mini	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
computer-use-preview	No	No	No	No	No	No	No	Sì	No	No	No	No	No	No	No	No
gpt-35-turbo	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-4	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-4.1	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-4.1-mini	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-4.1-nano	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-4.5-preview	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-4o	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-4o-mini	Sì	No	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-5	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì	Sì	Sì	Sì	Sì
gpt-5-chat	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5-codex	No	No	No	No	No	No	Sì	No	No	Sì	No	No	Sì	No	No	No
gpt-5-mini	No	No	No	No	No	No	Sì	No	No	Sì	No	No	Sì	No	No	Sì
gpt-5-nano	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5-pro	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5.1	No	Sì	Sì	No	Sì	No	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-5.1-chat	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5.1-codex	No	No	No	No	No	No	Sì	No	No	Sì	No	No	Sì	No	No	No
gpt-5.1-codex-max	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5.1-codex-mini	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
gpt-5.2	No	Sì	Sì	No	Sì	No	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
gpt-5.2-chat	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	No	Sì
gpt-5.2-codex	No	No	No	No	No	No	Sì	No	No	Sì	No	No	Sì	No	No	No
gpt-5.3-chat	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.3-codex	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.4	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.4-mini	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.4-nano	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.4-pro	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-5.5	Sì	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	Sì	Sì	Sì	Sì
gpt-oss-120b	No	No	No	No	No	No	Sì	No	No	Sì	Sì	No	Sì	No	No	No
grok-3	No	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	No
grok-3-mini	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
grok-4	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
grok-4-1-fast-non-reasoning	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
grok-4-1-fast-reasoning	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
grok-4-20-non-reasoning	No	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
grok-4-20-reasoning	No	Sì	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	Sì
grok-4-fast-non-reasoning	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
grok-4-fast-reasoning	No	No	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	Sì	No	No	No
mistral-small-2503	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
model-router	No	No	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	Sì	No
o1	No	Sì	No	Sì	No	Sì	Sì	No	No	Sì	Sì	No	Sì	No	Sì	Sì
o1-mini	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
o1-preview	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
o3	Sì	Sì	No	Sì	No	Sì	Sì	No	Sì	Sì	Sì	No	Sì	Sì	No	Sì
o3-deep-research	No	No	No	No	No	No	No	No	No	No	No	No	Sì	No	No	Sì
o3-mini	Sì	No	No	Sì	Sì	Sì	Sì	No	Sì	Sì	No	No	No	No	No	No
o3-pro	No	No	No	No	No	No	Sì	No	No	Sì	No	No	No	No	No	No
o4-mini	Sì	No	No	Sì	Sì	Sì	Sì	No	Sì	Sì	Sì	No	Sì	No	Sì	Sì

Risoluzione dei problemi relativi

Usare questi controlli per risolvere i problemi comuni:

• L'agente non chiama uno strumento:
  • Verificare che lo strumento sia collegato all'agente.
  • Verificare che il modello supporti lo strumento.
  • Se è necessario un comportamento deterministico, impostare su tool_choicerequired.
  • Esaminare le tracce di esecuzione per verificare se il modello ha generato una chiamata allo strumento.
• Le chiamate degli strumenti restituiscono risultati vuoti o irrilevanti:
  • Migliorare le descrizioni degli strumenti e le istruzioni dell'agente.
  • Per gli strumenti di recupero, assicurarsi che i dati vengano inseriti e ricercabili.
• Le chiamate agli strumenti hanno esito negativo:
  • Verificare la configurazione e l'autenticazione dello strumento.
  • Per gli strumenti MCP e OpenAPI, verificare che l'endpoint sia raggiungibile e restituisca le risposte previste.

Domande frequenti

Come si verifica se è stato chiamato uno strumento?

Esaminare le tracce di esecuzione per verificare se l'agente ha chiamato uno strumento e controllare gli input e gli output degli strumenti. Per la configurazione della traccia end-to-end, vedere Tracciare l'applicazione.

Come si rende più affidabile l'utilizzo degli strumenti?

Iniziare con istruzioni chiare per gli strumenti. Se è necessario chiamare uno strumento deterministico, usare tool_choice. Per informazioni dettagliate, vedere Chiamare lo strumento di controllo con tool_choice.

Contenuto correlato

Gestione degli strumenti

• Individuare e gestire gli strumenti nel catalogo degli strumenti Foundry (anteprima)
• Governance degli strumenti con il gateway di intelligenza artificiale (anteprima)

Strumenti di recupero e ricerca

• Azure AI Search
• Ricerca di file
• Ricerca Web
• Base con gli strumenti Bing
• SharePoint (anteprima)

Strumenti di integrazione e dati

• Fabric agente dati (anteprima)
• Model Context Protocol (MCP) (anteprima)
• Strumento OpenAPI
• Chiamata di funzione

Strumenti di automazione e generazione

• Interprete di codice
• Automazione del browser (anteprima)
• Uso computer (anteprima)
• Generazione di immagini (anteprima)
• Strumento Agent2Agent (A2A) (anteprima)