Configura o teu ambiente

Neste artigo, implementa a infraestrutura necessária para criar agentes com o Foundry Agent Service. Depois de concluir esta configuração, pode criar e configurar agentes usando o SDK que preferir ou o portal Foundry.

Criar o seu primeiro agente é um processo em dois passos:

1. Configure o ambiente do seu agente (este artigo).
2. Crie e configure o seu agente.

Permissões necessárias

Configura o teu ambiente de agente

Para começar, precisa de um recurso Microsoft Foundry e de um projeto Foundry.
Os agentes são criados dentro de um projeto específico, e cada projeto funciona como um espaço de trabalho isolado. Isto significa:

• Todos os agentes do mesmo projeto partilham acesso ao mesmo armazenamento de ficheiros, armazenamento de threads (histórico de conversas) e índices de pesquisa.
• Os dados são mantidos isolados por projeto. Os agentes de um projeto não podem aceder a recursos de outro. Atualmente, os projetos constituem a unidade de partilha e isolamento na Foundry. Consulte o artigo sobre o que é a AI Foundry para mais informações sobre projetos Foundry.

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente.
• Garantir que a pessoa que cria a conta e o projeto tem o papel de Proprietário da Conta Azure IA no âmbito da subscrição
• Se estiver a configurar uma configuração standard, o mesmo indivíduo deve também ter permissões para atribuir funções aos recursos necessários (Cosmos DB, Pesquisa de IA do Azure, Armazenamento de Blobs do Azure). Para mais informações sobre funções RBAC, específicas para Serviços de Agentes, consulte Funções RBAC em Serviço de Agentes.
  • O papel integrado necessário é Administrador de Acesso Baseado em Funções.
  • Alternativamente, ter o papel de Proprietário ao nível da subscrição também satisfaz este requisito.
  • A permissão chave necessária é: Microsoft.Authorization/roleAssignments/write

Escolhe a tua configuração

O Serviço de Agente oferece três modos de configuração de ambiente para responder a diferentes necessidades:

• Configuração Básica:

  Esta configuração é compatível com o OpenAI Assistants e gere os estados dos agentes usando o armazenamento integrado da plataforma. Inclui as mesmas ferramentas e capacidades da API Assistants, com suporte adicional para modelos e ferramentas não OpenAI, como Pesquisa de IA do Azure e Bing.

• Configuração Padrão:

  Inclui tudo na configuração básica e um controlo detalhado sobre os teus dados, permitindo-te usar os teus próprios recursos do Azure. Todos os dados dos clientes — incluindo ficheiros, threads e armazenamentos vetoriais — são armazenados nos seus próprios recursos Azure, dando-lhe total propriedade e controlo.

• Configuração Padrão com Bring Your Own (BYO) Rede Virtual:

  Inclui tudo na Configuração Padrão, com a capacidade adicional de operar inteiramente dentro da sua própria rede virtual. Esta configuração suporta o Bring Your Own Rede Virtual (BYO virtual network), permitindo um controlo rigoroso sobre o movimento de dados e ajudando a prevenir a exfiltração de dados ao manter o tráfego confinado ao seu ambiente de rede.

Compare as opções de configuração

Opções de implantação

Para personalizar estes modelos, veja usar os seus próprios recursos.

Se quiser suporte para Isolamento de Rede Privada, consulte configuração em rede segura para mais informações sobre como implementar a sua própria rede virtual.

Descrição e Implantação Automática	Diagrama (clique para ampliar)
Implemente uma configuração básica de agente que use Identidade Gerida para autenticação. São criados uma conta e um projeto. É implementado um modelo GPT-4.1. Um Cofre de Chaves gerido pela Microsoft é usado por padrão.
Implemente uma configuração padrão de agente que utilize Managed Identity para autenticação. São criados uma conta e um projeto. É implementado um modelo GPT-4.1. Azure recursos para armazenar dados de clientes — Armazenamento do Azure, Azure Cosmos DB e Pesquisa de IA do Azure — são automaticamente criados se os recursos existentes não forem fornecidos. Estes recursos estão ligados ao seu projeto para armazenar ficheiros, threads e dados vetoriais. Um Cofre de Chaves gerido pela Microsoft é usado por padrão.

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

Pode personalizar o modelo usado pelo seu agente editando os parâmetros do modelo no modelo de autodeploy. Para implementar um modelo diferente, deves atualizar pelo menos os parâmetros modelName e modelVersion.

Por defeito, o modelo de implementação está configurado com os seguintes valores:

Verifique a sua implementação

Após a conclusão da implementação (normalmente 5-10 minutos), verifique se os seus recursos foram criados com sucesso:

1. Vai ao portal Azure.
2. Procure o nome do seu grupo de recursos.
3. Confirme que existem os seguintes recursos:
   • Configuração básica: Conta Foundry, implementação do projeto e modelo.
   • Configuração Standard: Todos os recursos básicos mais Armazenamento do Azure conta, conta Azure Cosmos DB e serviço Pesquisa de IA do Azure.

Resolução de problemas

E agora?

• Crie o seu primeiro agente

• Explore mais:

  • Use os seus recursos existentes
  • Configuração de agente seguro em rede