Encontre respostas para perguntas comuns sobre o Foundry Agent Service.
Se não conseguir encontrar respostas às suas perguntas neste artigo e ainda precisar de ajuda, consulte o suporte e as opções de ajuda da Foundry Tools. O Serviço de Agente de Fundição faz parte da Foundry Tools.
Para começar, veja:
Configuração e acesso
Qual é a diferença entre a configuração básica e a configuração padrão?
A configuração básica armazena o estado do agente em recursos geridos pela Microsoft.
A configuração padrão armazena os dados dos agentes (threads, ficheiros e armazenamentos vetoriais) nos teus recursos Azure que ligas através de hosts de capacidade.
Para comparar opções de configuração e escolher a correta, consulte Configurar o seu ambiente e hosts de capacidade.
De que permissões (funções RBAC) necessito?
Os requisitos do cargo dependem do que estás a fazer. Funções comuns incluem:
- Azure AI Account Owner: Criar contas e projetos
- Azure AI User: Criar e editar agentes
- Administrador de Controlo de Acesso Baseado em Papéis (ou Proprietário): Necessário para a configuração padrão que permite atribuir funções a recursos conectados
Para configuração padrão, também precisas da Microsoft.Authorization/roleAssignments/write autorização.
Para requisitos completos das funções, veja Permissões Necessárias e Controlo de Acesso Baseado em Funções (RBAC) no Foundry da Microsoft.
Por onde devo começar se sou novo no Foundry Agent Service?
Começa por configurar o teu ambiente e depois cria o teu primeiro agente.
- Experiência clássica: Início rápido: Crie um novo agente
- Nova experiência na Foundry: Início rápido: Comece com agentes no código
Geral
Você armazena algum dado usado na API do Foundry Agent Service?
Yes. O Foundry Agent Service é uma API com estado, o que significa que retém dados. Dois tipos de dados são armazenados na API do Serviço de Agentes da Fundição:
- Entidades com estado: Conversas e respostas criadas durante o uso.
- Ficheiros e armazenamentos vetoriais: Dados carregados durante a configuração do Foundry Agent Service ou como parte de uma geração de resposta.
Para saber como funcionam as conversas e respostas, veja componentes de execução do Agente.
Onde esses dados são armazenados?
- Configuração básica: Os dados são armazenados numa conta de armazenamento segura, gerida pela Microsoft, logicamente separada.
-
Configuração padrão: Os dados são armazenados nos seus próprios recursos Azure, por isso tem total propriedade e controlo:
- Azure Storage: Ficheiros e anexos
- Azure Cosmos DB: Tópicos e histórico de conversas
- Azure AI Search: Vector stores
Para saber mais sobre opções de configuração que controlam onde os dados são armazenados, consulte Configurar o seu ambiente.
Durante quanto tempo são armazenados estes dados?
Os dados persistem a menos que os apagues explicitamente. Para eliminar dados do agente, use a API ou SDK para eliminar threads, ficheiros ou armazenamentos vetoriais.
Para conceitos e terminologia (por exemplo, conversa e resposta), veja Componentes de runtime do agente.
O Foundry Agent Service suporta encriptação CMK?
- A configuração básica suporta apenas chaves geridas pela Microsoft.
- A configuração padrão suporta chaves geridas pelo cliente (CMKs).
A Microsoft usa os meus dados para treinar modelos?
Não, a Microsoft não usa os seus dados para treinar modelos. Para mais informações, consulte a documentação da Responsible AI.
Onde os dados são armazenados geograficamente?
Os endpoints do Foundry Agent Service são regionais, e os dados são armazenados na mesma região que o endpoint. Para obter mais informações, consulte a documentação de residência de dados do Azure.
Como me são faturados os serviços do Foundry Agent?
És cobrado pelo custo de inferência (entrada e saída) do modelo base que estás a usar para cada agente (por exemplo, gpt-4-0125). Se criaste vários agentes, és cobrado pelo modelo base associado a cada agente.
Se ativaste a ferramenta Code Interpreter, és cobrado pela sua utilização por sessão. Por exemplo, se o seu agente chamar Code Interpreter simultaneamente em dois threads, esta atividade cria duas sessões de Code Interpreter. Cada uma dessas sessões é cobrada.
Por padrão, cada sessão está ativa durante uma hora. Se o seu utilizador continuar a dar instruções ao Interpretador de Código no mesmo tópico durante até uma hora, paga esta taxa apenas uma vez.
A pesquisa de ficheiros é cobrada com base no armazenamento vetorial que utiliza.
Para obter mais informações, consulte a página de preços.
Existe algum preço ou cota adicional para usar o Serviço de Agente de Fundição?
Não. Todas as cotas se aplicam ao uso de modelos com o Foundry Agent Service.
Ferramentas e integrações
Onde posso aprender sobre ferramentas como o Code Interpreter e o File Search?
Comece com uma visão geral das Ferramentas, depois veja as orientações específicas para cada ferramenta:
Como posso utilizar o meu próprio armazenamento, o Azure Cosmos DB ou o Azure AI Search para dados de agentes?
Utilize hosts com capacidade e ligue os seus próprios recursos.
- Conceitos: Anfitriões de funcionalidades
- Como fazer: Use os seus próprios recursos
Acompanhamento e operações
Como posso monitorizar o serviço Foundry Agent?
Para compreender as opções de utilização e monitorização, consulte Métricas e Monitorizar o serviço.
O que devo fazer para a continuidade do negócio e recuperação de desastres (BCDR)?
A orientação BCDR do Serviço de Agentes depende da sua configuração e dos recursos que provisiona. Para as orientações atuais, consulte BCDR para agentes.
Redes virtuais
O que é isolamento de rede virtual?
Redes virtuais ajudam a proteger o acesso de entrada e saída aos seus recursos Azure. Consegue-se isolamento de rede através de integrações virtuais de rede no Azure.
Para requisitos e limitações da rede privada do Serviço de Agentes, consulte Como usar uma rede virtual com o Serviço de Agentes da Foundry.
Porque é que preciso de delegação de sub-rede?
O Agent Service networking utiliza Azure Container Apps. Quando implementa na sua rede virtual, deve usar uma sub-rede dedicada e delegada para Microsoft.App/environments.
Para mais detalhes, veja Como usar uma rede virtual com Foundry Agent Service e configuração de rede virtual.
Que regiões suportam o isolamento da rede virtual?
A disponibilidade de regiões para isolamento de rede virtual pode mudar. Para as regiões e limitações atualmente suportadas, veja Como usar uma rede virtual com o Foundry Agent Service.
Qual intervalo de classes é suportado para sub-redes de Classe A, B e C, públicas ou privadas?
Apenas são suportados intervalos de IP privados:
- Classe A: 10.0.0.0/8
- Classe B: 172.16.0.0/12
- Classe C: 192.168.0.0/16
Intervalos de IP públicos não são suportados para sub-redes de agentes.
Qual é o tamanho mínimo da sub-rede do agente e quantos IPs devo usar?
O tamanho recomendado da sub-rede do agente delegado é /24. O mínimo é /27.
Para orientações sobre dimensionamento e como os IPs são consumidos, veja Como usar uma rede virtual com Foundry Agent Service e configuração de rede virtual.
Qual é o intervalo mínimo e recomendado de endereços para redes virtuais no Foundry Agent Service?
Desde que a sub-rede do agente e os endpoints privados tenham espaço de endereçamento, o intervalo de endereços para redes virtuais pode ser qualquer coisa.
Posso usar redes virtuais emparelhadas? Posso ter recursos em diferentes redes virtuais?
Yes. A rede virtual está na tua subscrição, e deves conseguir fazer peering com qualquer rede virtual. Mas a transferência de dados é dispendiosa, por isso não a recomendamos. O requisito é que todos os recursos estejam na mesma região do recurso Microsoft Foundry.
Preciso de adicionar alguns FQDNs a uma lista de permissão se estiver a usar um firewall do Azure?
Yes. Permita os nomes de domínio totalmente qualificados (FQDNs) necessários para a identidade gerida, conforme descrito em Use Azure Firewall com Azure Container Apps, ou permita a etiqueta de serviço AzureActiveDirectory.
Para orientações sobre redes privadas do Serviço de Agentes, consulte Como usar uma rede virtual com o Serviço de Agentes da Foundry.
Podem múltiplos recursos da Microsoft Foundry reutilizar a rede virtual?
Sim, vários recursos da Microsoft Foundry podem reutilizar a mesma rede virtual. No entanto, cada recurso Foundry requer a sua própria sub-rede dedicada de execução de agente — a sub-rede de agente não pode ser partilhada entre múltiplos recursos Foundry.
A rede virtual precisa estar no mesmo grupo de recursos que o Foundry?
Não precisam de estar no mesmo grupo de recursos, mas precisam de estar na mesma região.
Que configuração adicional preciso se quiser adicionar ferramentas aos meus agentes?
Se estiver a usar uma configuração segura em rede, algumas ferramentas requerem configurações adicionais, como endpoints privados e ligações de recursos.
Para as orientações e limitações atuais, veja Como usar uma rede virtual com o Foundry Agent Service.