Compartilhar via

Configure seu ambiente

Criar seu primeiro agente com o Serviço do Agente do Azure AI Foundry é um processo de duas etapas:

  1. Configure o ambiente do agente.
  2. Crie e configure seu agente usando o SDK de sua escolha ou o Portal do Azure Foundry.

Use este artigo para saber mais sobre como configurar o ambiente do agente.

Permissões necessárias

Ação Função necessária
Criar uma conta e um projeto Proprietário da conta de IA do Azure
configuração padrão Somente: atribuir RBAC para recursos necessários (Cosmos DB, Pesquisa, Armazenamento etc.) Administrador de controle de acesso baseado em função
Criar e editar agentes Usuário de IA do Azure

Configurar o ambiente do agente

Para começar, você precisa de um recurso do Azure AI Foundry e um projeto do Foundry.
Os agentes são criados em um projeto específico e cada projeto atua como um workspace isolado. Isso significa:

  • Todos os agentes no mesmo projeto compartilham o acesso ao mesmo armazenamento de arquivos, armazenamento de threads (histórico de conversas) e índices de pesquisa.
  • Os dados são isolados entre projetos. Agentes em um projeto não podem acessar recursos de outro. Atualmente, os projetos são a unidade de compartilhamento e isolamento na Fábrica. Consulte o artigo O que é a Fábrica de IA para obter mais informações sobre projetos da Fábrica.

Pré-requisitos

  • Uma assinatura do Azure – Crie uma gratuitamente.
  • Verifique se o indivíduo que está criando a conta e o projeto tem a função de Proprietário da Conta de IA do Azure no escopo da assinatura
  • Se estiver configurando uma configuração padrão, o mesmo indivíduo também deverá ter permissões para atribuir funções aos recursos necessários (Cosmos DB, Azure AI Search, Armazenamento de Blobs do Azure). Para obter mais informações sobre as funções RBAC, específicas do Serviço do Agente Azure AI Foundry, consulte as funções RBAC do Serviço do Agente Azure AI Foundry.
    • A função interna necessária é Administrador do acesso baseado em função.
    • Como alternativa, ter a função Proprietário no nível da assinatura também atende a esse requisito.
    • A permissão de chave necessária é: Microsoft.Authorization/roleAssignments/write

Escolha sua configuração

O Serviço do Agente do Azure AI Foundry oferece três modos de configuração de ambiente para atender a diferentes necessidades:

  • Configuração básica:

    Essa configuração é compatível com assistentes openai e gerencia estados de agente usando o armazenamento interno da plataforma. Ele inclui as mesmas ferramentas e funcionalidades que a API de Assistentes, com suporte adicional para modelos e ferramentas não OpenAI, como o Azure AI Search e o Bing.

  • Configuração Padrão:

    Inclui tudo na configuração básica e controle refinado sobre seus dados, permitindo que você use seus próprios recursos do Azure. Todos os dados do cliente, incluindo arquivos, threads e repositórios de vetores, são armazenados em seus próprios recursos do Azure, oferecendo total propriedade e controle.

  • Configuração padrão com a rede virtual Bring Your Own (BYO):

    Inclui tudo na Instalação Padrão, com a capacidade adicional de operar inteiramente em sua própria rede virtual. Essa configuração dá suporte à Rede Virtual Bring Your Own (rede virtual BYO), permitindo um controle estrito sobre a movimentação de dados e ajudando a impedir a exfiltração de dados mantendo o tráfego confinado ao seu ambiente de rede.

Comparar opções de configuração

Casos de uso Configuração básica Configuração padrão com rede pública Configuração Padrão com Rede Privada
Comece rapidamente sem precisar gerenciar recursos ✅
Todo o histórico de conversas, arquivos e vetores são armazenados nos seus próprios recursos ✅ ✅
Suporte para CMK (Chaves Gerenciadas pelo Cliente) ✅ ✅
Isolamento de rede privada (traga sua própria rede virtual) ✅

Opções de implantação

Para personalizar esses modelos, consulte como usar seus próprios recursos.

Se você quiser suporte para isolamento de rede privada, consulte a configuração protegida pela rede para obter mais informações sobre como trazer sua própria rede virtual.

Descrição e Implantação Automática Diagrama (clique para ampliar)
Implante uma configuração básica do agente que usa a Identidade Gerenciada para autenticação.
Uma conta e um projeto são criados.
Um modelo GPT-4o é implantado.
Um Key Vault gerenciado pela Microsoft é usado por padrão.
Implantar no Azure		 Um diagrama de arquitetura para a configuração básica do agente.
Implante uma configuração de agente padrão que usa a Identidade Gerenciada para autenticação.
Uma conta e um projeto são criados.
Um modelo GPT-4o é implantado.
Os recursos do Azure para armazenar dados do cliente – Armazenamento do Azure, Azure Cosmos DB e Azure AI Search – serão criados automaticamente se os recursos existentes não forem fornecidos.
Esses recursos são conectados ao projeto para armazenar arquivos, threads e dados de vetor.
Um Key Vault gerenciado pela Microsoft é usado por padrão.
Implantar no Azure		 Um diagrama de arquitetura para a configuração do agente padrão.

[Opcional] Seleção de modelo no modelo de implantação automática

Importante

Não altere o parâmetro modelFormat.

Os modelos dão suporte apenas à implantação de modelos do Serviço OpenAI do Azure. Veja quais modelos do Azure OpenAI têm suporte no artigo de suporte ao modelo .

Você pode personalizar o modelo usado pelo agente editando os parâmetros de modelo no modelo de reimplantação automática. Para implantar um modelo diferente, você precisa atualizar pelo menos os parâmetros modelName e modelVersion.

Por padrão, o modelo de implantação é configurado com os seguintes valores:

Parâmetro de Modelo Valor Padrão
nome do modelo gpt-4o
modelFormat OpenAI (para o Serviço OpenAI do Azure)
modelVersion 2024-11-20
modelSkuName GlobalStandard
modelLocation eastus

O que vem a seguir?