Connetti Microsoft Foundry | Easy Understand Hermes Agent

Considera questa funzionalità come un traduttore universale per i tuoi modelli di intelligenza artificiale: permette ad Hermes Agent di parlare con Microsoft Foundry (e Azure OpenAI) indipendentemente dal “dialetto” che parla il tuo modello, così non devi preoccuparti dei dettagli tecnici.

Perché è così importante?

Microsoft Foundry può ospitare modelli di IA che usano due “dialetti” diversi per comunicare:

Stile OpenAI (come GPT-4, GPT-5, Llama, Mistral) — questi usano un endpoint di chat standard.
Stile Anthropic (come Claude) — questi usano un formato di messaggi diverso.

Normalmente, dovresti scrivere codice separato per ciascuno. Ma il provider azure-foundry di Hermes Agent rileva automaticamente il formato usato dal tuo modello e gestisce la traduzione per te. È come avere un adattatore plug-and-play per ogni modello.

Prima di iniziare

Ti serviranno tre cose:

Una risorsa Microsoft Foundry o Azure OpenAI con almeno un modello distribuito.
L’URL dell’endpoint per quella distribuzione (lo trovi nel portale Azure).
Uno di questi due metodi di autenticazione:
- Una chiave API (la trovi nel portale sotto “Chiavi ed endpoint”), oppure
- Il ruolo Azure AI User (chiamato anche “Foundry User” in alcuni tenant) se vuoi usare Microsoft Entra ID — questo è il metodo senza chiave che Microsoft raccomanda.

Avvio rapido: un solo comando

Una volta che hai il tuo endpoint e le credenziali, la configurazione è un solo comando:

hermes model

Tutto qui. La procedura guidata:

Sonda il tuo endpoint per vedere quale trasporto usa (stile OpenAI o stile Anthropic).
Elenca le distribuzioni disponibili così puoi sceglierne una.
Rileva la lunghezza del contesto di ogni modello (quanto testo può gestire in una volta).

Non devi conoscere nessuno dei dettagli tecnici — Hermes Agent lo capisce da solo.

Cosa succede dopo?

Dopo aver scelto un modello, Hermes Agent ricorderà la tua scelta. Ora puoi usarlo per qualsiasi attività, come chattare o creare agenti, senza riconfigurare nulla.

Se vuoi cambiare modello o controllare cosa è disponibile, basta eseguire di nuovo hermes model.

Un esempio semplice

Immagina di avere due modelli in Foundry: un GPT-4 (stile OpenAI) e un Claude (stile Anthropic). Con Hermes Agent, puoi passare da uno all’altro eseguendo hermes model e selezionando quello che vuoi. Il provider gestisce i diversi “linguaggi” dietro le quinte, quindi parli con la tua IA normalmente.

Riepilogo e consiglio pratico

In breve: questa funzionalità elimina il mal di testa di gestire diversi formati API. Indichi a Hermes Agent la tua risorsa Foundry, lui capisce il resto e sei pronto a partire.

Consiglio pratico: se sei in un ambiente aziendale, usa il percorso senza chiave con Microsoft Entra ID (il ruolo Azure AI User) invece delle chiavi API — è più sicuro ed è l’approccio raccomandato da Microsoft. Assicurati solo che il tuo utente o service principal abbia quel ruolo assegnato prima di eseguire hermes model.

Ora vai a collegare i tuoi modelli — è letteralmente a un comando di distanza.