🤖HermesBlog
Guias Práticos do Hermes · Parte 228/9/2026

Conectar Microsoft Foundry

Conectar Microsoft Foundry — guia fácil de entender baseado na documentação oficial

Pense neste recurso como um tradutor universal para seus modelos de IA — ele permite que o Hermes Agent converse com o Microsoft Foundry (e o Azure OpenAI) não importa qual “idioma” seu modelo fale, para que você não precise se preocupar com os detalhes técnicos.

guide-azure-foundry

Qual é a Grande Vantagem?

O Microsoft Foundry pode hospedar modelos de IA que usam dois “dialetos” diferentes para comunicação:

  • Estilo OpenAI (como GPT-4, GPT-5, Llama, Mistral) — estes usam um endpoint de chat padrão.
  • Estilo Anthropic (como Claude) — estes usam um formato de mensagem diferente.

Normalmente, você teria que escrever código separado para cada um. Mas o provedor azure-foundry do Hermes Agent detecta automaticamente qual formato seu modelo usa e, em seguida, cuida da tradução para você. É como ter um adaptador plug-and-play para cada modelo.


Antes de Começar

Você precisará de três coisas:

  1. Um recurso do Microsoft Foundry ou Azure OpenAI com pelo menos um modelo implantado.
  2. A URL do endpoint para essa implantação (encontrada no Portal do Azure).
  3. Uma destas duas formas de autenticação:
    • Uma chave de API (pegue-a no Portal em “Chaves e Endpoint”), ou
    • A função Azure AI User (também chamada de “Foundry User” em alguns locatários) se você quiser usar o Microsoft Entra ID — este é o método sem chave que a Microsoft recomenda.

Início Rápido: Um Único Comando

Assim que você tiver seu endpoint e credenciais, a configuração é apenas um comando:

hermes model

É isso. O assistente irá:

  • Testar seu endpoint para ver qual transporte ele usa (estilo OpenAI ou estilo Anthropic).
  • Listar as implantações disponíveis para você escolher uma.
  • Detectar o comprimento do contexto de cada modelo (quanto texto ele pode processar de uma vez).

Você não precisa saber nenhum dos detalhes técnicos — o Hermes Agent descobre tudo para você.


O Que Acontece Depois?

Após escolher um modelo, o Hermes Agent lembrará da sua escolha. Você pode usá-lo para qualquer tarefa, como conversar ou construir agentes, sem reconfigurar.

Se quiser trocar de modelo ou ver o que está disponível, basta executar hermes model novamente.


Um Exemplo Simples

Imagine que você tem dois modelos no Foundry: um GPT-4 (estilo OpenAI) e um Claude (estilo Anthropic). Com o Hermes Agent, você pode alternar entre eles executando hermes model e selecionando o que deseja. O provedor lida com os diferentes “idiomas” nos bastidores, então você apenas conversa com sua IA normalmente.


Resumo e Dica Prática

Em resumo: Este recurso elimina a dor de cabeça de lidar com diferentes formatos de API. Você aponta o Hermes Agent para seu recurso do Foundry, ele descobre o resto, e você está pronto para começar.

Dica prática: Se você estiver em um ambiente corporativo, use o caminho sem chave do Microsoft Entra ID (a função Azure AI User) em vez de chaves de API — é mais seguro e é a abordagem recomendada pela Microsoft. Apenas certifique-se de que seu usuário ou principal de serviço tenha essa função atribuída antes de executar hermes model.

Agora vá conectar seus modelos — está a apenas um comando de distância.


📖 Documentação oficial

この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › guides/azure-foundry