Usare strumenti e modelli di intelligenza artificiale in Funzioni di Azure

Funzioni di Azure fornisce risorse di calcolo serverless che si integrano con l'intelligenza artificiale e i servizi di Azure per facilitare la creazione di applicazioni intelligenti ospitate nel cloud. Questo articolo illustra scenari, integrazioni e risorse correlati all'intelligenza artificiale che è possibile usare nelle app per le funzioni.

Usa la seguente tabella per scegliere un'integrazione basata su come inizia il lavoro e su come altri componenti la consumano:

Option Soluzione ottimale Modello di invocazione Considerazioni principali
Funzioni di Azure ospita competenze Aggiungi ragionamento AI ai carichi di lavoro guidati dagli eventi utilizzando istruzioni e strumenti dichiarativi. Trigger di funzioni o endpoint HTTP e MCP integrati opzionali Preview
Associazioni di agenti per Python Aggiungere il ragionamento con agente limitato a una funzione Python mantenendo però il controllo guidato dal codice su validazione, ramificazione, errori e output. Un trigger standard Functions invoca codice Python, che chiama un oggetto iniettato nel Microsoft Agent Framework Agent Anteprima; Solo Python
Implementazioni degli endpoint del Model Context Protocol (MCP) Espone strumenti sincroni e riutilizzabili agli agenti Microsoft Foundry e ad altri client MCP. HTTP gestibile in streaming Scegliere tra le competenze ospitate, l'estensione MCP generalmente disponibile e l'anteprima dell'hosting basato su SDK.
Strumenti Funzioni di Azure basati su code Esegui strumenti asincroni in background per gli agenti Microsoft Foundry. archiviazione code di Azure: code di input e di output Specifico per la fonderia; richiede un agente della fonderia con la configurazione standard.
Flussi di lavoro agentici Coordina attività di IA di lunga durata o in più fasi che devono proseguire anche dopo riavvii e periodi di attesa. Orchestrazioni durevoli avviate da eventi applicativi Scegli l'orchestrazione diretta di Durable Functions o i flussi di lavoro dinamici delle skill ospitate.

Questo articolo è specifico del linguaggio, quindi assicurarsi di scegliere il linguaggio di programmazione nella parte superiore della pagina.

Funzioni di Azure ospita competenze

Funzioni di Azure hosted skills è un modello di programmazione per costruire capacità intelligenti cloud e guidate dagli eventi su Funzioni di Azure. Definisci il comportamento con Markdown, istruzioni in linguaggio naturale e configurazione dichiarativa. Il runtime individua i file .agent.md, registra trigger ed endpoint ed esegue le skill ospitate quando si verificano eventi.

Importante

Le skill ospitate in Funzioni di Azure sono attualmente in anteprima. Le funzionalità, i nomi di configurazione e i connettori supportati possono cambiare prima della disponibilità generale.

Non è necessario scrivere codice Python per definire una competenza ospitata. Definisci il suo comportamento, i trigger e gli strumenti configurati in Markdown e file di configurazione. Se hai bisogno di una logica di app personalizzata oltre a queste capacità configurate, puoi aggiungere strumenti Python personalizzati.

Usa le competenze ospitate da Funzioni di Azure quando vuoi aggiungere un comportamento intelligente a un'applicazione guidata da eventi in risposta a una richiesta HTTP, programmazione, messaggio, cambiamento di dati, evento da un connettore gestito o altro evento. Puoi anche abilitare un endpoint MCP integrato facoltativo che espone ogni funzionalità ospitata come uno strumento basato su IA per altre applicazioni, agenti o framework di agenti.

Per iniziare, vedere questi articoli:

Associazioni di agenti per Python

Importante

Le associazioni degli agenti per le app per funzioni Python sono attualmente in versione di anteprima. Funzionalità, nomi di pacchetti e configurazioni possono cambiare prima della disponibilità generale.

I binding degli agenti aggiungono un oggetto Microsoft Agent Framework Agent configurato a una normale chiamata di funzione Python. La funzione mantiene il controllo della logica di trigger e deterministica applicativa, e il suo gestore decide se, quando e come invocare l'Agente.

Usa le associazioni Agent quando la funzione Python è il modello di esecuzione principale e il ragionamento dell’Agent costituisce una parte circoscritta del suo lavoro. Usa invece le competenze ospitate da Funzioni di Azure quando una skill ospitata definita in modo dichiarativo è il modello di esecuzione principale dell'applicazione. Usa direttamente l'SDK del Microsoft Agent Framework quando il tuo codice deve controllare l'intero ciclo di vita dell'Agente, invece di ricevere un Agente configurato tramite un binding.

Le associazioni di agenti supportano anche chiamate sicure per la riproduzione dalle orchestrazioni di funzioni permanenti. Per saperne di più e iniziare, consulta Agent bindings per Python in Funzioni di Azure.

Strumenti e server MCP

I modelli di intelligenza artificiale e gli agenti usano la chiamata di funzione per richiedere risorse esterne note come strumenti. Utilizzando la chiamata di funzioni, modelli e agenti possono evocare dinamicamente funzionalità specifiche in base al contesto di una conversazione o di un compito.

Il servizio Funzioni è particolarmente adatto per l'implementazione di chiamate di funzione nei flussi di lavoro agentici perché ridimensiona in modo efficiente la domanda e fornisce estensioni delle associazioni che semplificano la connessione degli agenti ai servizi di Azure remoti. Quando si compilano o si ospitano strumenti di intelligenza artificiale in Funzioni, si ottengono anche modelli di prezzi serverless e funzionalità di sicurezza della piattaforma.

MCP è lo standard industriale per l'interazione con server remoti. Offre un modo standardizzato per i modelli e gli agenti di intelligenza artificiale per comunicare con sistemi esterni. Utilizzando un server MCP, questi client AI possono determinare in modo efficiente gli strumenti e le capacità di un sistema esterno.

Funzioni di Azure supporta attualmente l'esposizione del codice della funzione usando questi tipi di strumenti:

Tipo di strumento Descrizione
Endpoint MCP integrato per competenze ospitate Esponi competenze ospitate che applicano il ragionamento AI come strumenti tramite un endpoint MCP integrato.
Server MCP remoto Creare strumenti MCP deterministici o ospitare server MCP basati su SDK per chiamate sincrone di strumenti.
Strumento basato su coda per Funzioni di Azure Usa lo strumento specifico di Microsoft Foundry per la chiamata asincrona di funzioni tramite code di messaggi.

Scegli come esporre un endpoint MCP

Functions supporta queste opzioni per esporre le capacità tramite MCP:

  • Abilita l'endpoint MCP integrato per le competenze ospitate da Funzioni di Azure per esporre strumenti basati su IA definiti nei .agent.md file. Le competenze ospitate sono attualmente in anteprima.
  • Usa l'estensione MCP binding per creare e ospitare strumenti MCP deterministici come faresti con qualsiasi altra app di funzione.
  • Server MCP self-host creati utilizzando gli SDK MCP ufficiali. Questa opzione di hosting è attualmente in anteprima.

Ecco un confronto delle attuali opzioni di endpoint MCP fornite da Functions:

Caratteristica / Funzionalità Endpoint MCP integrato per competenze ospitate Estensione di associazione MCP Server MCP self-hosted
Soluzione ottimale Esponi una funzionalità in hosting basata sull'IA come strumento MCP. Crea strumenti MCP deterministici con trigger e binding di Functions. Ospita un server esistente costruito con un SDK MCP ufficiale.
Livello di supporto corrente Preview Generalmente disponibile Anteprima*
Modello di programmazione Competenza ospitata .agent.md Trigger e associazioni di funzioni SDK MCP standard
Esecuzione con stato Storia delle sessioni supportata Sostenuto Non è al momento supportato
Linguaggi di codice personalizzati Python (strumenti personalizzati opzionali) C# (processo isolato)
Python
TypeScript
JavaScript
Java		 C# (processo isolato)
Python
TypeScript
Java
Piano di hosting Piano a Consumo Flessibile
Premium
Dedicato (servizio app)		 Piani di hosting Funzioni di Azure supportati Solo consumo flessibile
Altri requisiti Abilita builtin_endpoints.mcp nella skill ospitata None Server senza stato che utilizza il trasporto HTTP con streaming
Modalità di implementazione Endpoint MCP integrato nel runtime hosted-skills Estensione di associazione MCP Gestori personalizzati

*I dettagli di configurazione per i server MCP self-hosted cambiano durante l'anteprima.

Usa le seguenti risorse specifiche per linguaggio per iniziare con server MCP remoti in Functions:

Per C#, confronta queste risorse per l'estensione MCP e l'hosting basato su SDK:

Options Estensione di associazione MCP Server MCP ospitati localmente
Documentation Estensione di associazione MCP Non applicabile
Samples Server remoto MCP personalizzato Server meteorologico
Modelli HelloTool Non applicabile

Per Python, confronta queste risorse per l'estensione MCP e l'hosting basato su SDK:

Options Estensione di associazione MCP Server MCP ospitati localmente
Documentation Estensione di associazione MCP Non applicabile
Samples Server remoto MCP personalizzato Server meteorologico

Per TypeScript, confronta queste risorse per l'estensione MCP e l'hosting basato su SDK:

Options Estensione di associazione MCP Server MCP ospitati localmente
Documentation Estensione di associazione MCP Non applicabile
Samples Server remoto MCP personalizzato Server meteorologico

Per JavaScript, usa le risorse dell'estensione MCP. È supportato l'hosting basato su SDK, ma attualmente non è disponibile un quickstart in JavaScript.

Options Estensione di associazione MCP Server MCP ospitati localmente
Documentation Estensione di associazione MCP Non applicabile
Samples Non ancora disponibile Non ancora disponibile

Per Java, usa la documentazione delle estensioni MCP. Al momento non sono disponibili campioni specifici per linguaggio.

Options Estensione di associazione MCP Server MCP ospitati localmente
Documentation Estensione di associazione MCP Non applicabile
Samples Non ancora disponibile Non ancora disponibile

PowerShell non è attualmente supportato per entrambe le opzioni di hosting del server MCP.

Scegli strumenti Funzioni di Azure basati su code per Microsoft Foundry Agent Service

Microsoft Foundry Agent Service fornisce anche uno strumento specifico per Funzioni di Azure per la chiamata asincrona di funzioni. L'agente inserisce una richiesta in una coda di input di archiviazione code di Azure. Una funzione attivata dalla coda elabora la richiesta e restituisce il risultato tramite una coda di uscita.

Utilizza questa integrazione specifica per Foundry per operazioni in background che non richiedono una risposta immediata e traggono vantaggio dalla consegna affidabile dei messaggi e dai tentativi di nuovo invio. Per interazioni sincrone o strumenti che vuoi riutilizzare con altri client AI, usa invece un server MCP.

Gli strumenti Funzioni di Azure basati su code richiedono un agente Foundry con configurazione standard. Per esaminare gli SDK supportati e costruire uno strumento, vedi Usa Funzioni di Azure con Foundry Agent Service.

Flussi di lavoro agentici

Usa Durable Functions quando il codice applicativo definisce una sequenza affidabile di chiamate agenti, chiamate modellate, approvazioni e altri lavori. Durable Functions mantiene lo stato di orchestrazione durante le attese e i riavvii e supporta modelli comuni come la concatenazione di funzioni, fan-out/fan-in e le interazioni umane.

Se usi le competenze ospitate da Funzioni di Azure, i flussi di lavoro dinamici offrono un'opzione di anteprima in cui un modello crea un piano strutturato di chiamate di strumenti, attività di subagent e attese. Il runtime delle Hosted Skills esegue quel piano tramite un'orchestrazione di Durable Functions. Usa l'invocazione diretta degli strumenti quando l'attività può concludersi in un'unica interazione e usa un flusso di lavoro dinamico quando l'attività deve proseguire oltre un singolo passaggio, diramarsi, attendere o continuare anche dopo un riavvio.

Option Chi definisce il flusso di lavoro Soluzione ottimale Considerazioni principali
Orchestrazione di Direct Durable Functions Codice dell'applicazione Flussi di lavoro prevedibili con flusso di controllo esplicito, nuovi tentativi, attese e approvazioni Usa il modello di programmazione Durable Functions per il tuo linguaggio.
Flusso di lavoro dinamico delle competenze ospitate Modello di intelligenza artificiale Flussi di lavoro adattivi che pianificano invocazioni di strumenti, attività dei sottoagenti, attese e diramazioni durante l'esecuzione. Anteprima; richiede competenze ospitate in Funzioni di Azure.

Per indicazioni sull'implementazione, consulta i modelli applicativo e Crea ed esegue flussi di lavoro dinamici.

Strumenti e framework di intelligenza artificiale per Funzioni di Azure

Con Functions, puoi costruire app nella lingua che preferisci e usare le tue librerie preferite. Grazie a questa flessibilità, è possibile usare un'ampia gamma di librerie e framework di intelligenza artificiale nelle app per le funzioni abilitate per l'intelligenza artificiale.

Queste piattaforme e framework di Microsoft AI supportano diverse architetture applicative:

Piattaforma o framework Soluzione ottimale Come funziona con Funzioni di Azure
Microsoft Agent Framework Logica degli agenti e flussi di lavoro definiti nel codice che vengono eseguiti nella tua applicazione Esegui gli SDK del framework nel tuo codice di funzione.
Servizio Microsoft Foundry Agent Agenti gestiti che utilizzano strumenti ospitati da funzioni Crea e gestisci gli agenti come un servizio ospitato. Gli agenti Foundry possono chiamare strumenti ospitati nelle funzioni tramite MCP, code o OpenAPI.
SDK di Microsoft Foundry Chiamate dirette al modello e al servizio che non richiedono un agente gestito Chiama i modelli e i servizi Foundry direttamente dal tuo codice funzione.

In Functions, le tue app possono anche fare riferimento a librerie e framework di terze parti, così puoi utilizzare tutti i tuoi strumenti e librerie AI preferiti nelle tue funzioni abilitate all'IA.

  • Ultimo aggiornamento: