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.
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:
- Um recurso do Microsoft Foundry ou Azure OpenAI com pelo menos um modelo implantado.
- A URL do endpoint para essa implantação (encontrada no Portal do Azure).
- 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