Perguntas frequentes do Serviço de Agentes da Fundição

Encontre respostas para questões frequentes 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 das Ferramentas de Fundição.

Para começar, veja:

Configuração e acesso

Qual é a diferença entre a configuração básica e a configuração padrão?

Basic setup armazena o estado do agente em recursos geridos por Microsoft.

Configuração Standard armazena os dados do agente (threads, ficheiros e armazenamentos vetoriais) nos seus recursos de Azure que liga através de hosts de capacidade.

Para comparar opções de configuração e escolher a opção correta, veja Configurar o seu ambiente e Hospedeiros de Capacidade.

Que permissões (funções RBAC) eu preciso ter?

Os requisitos do cargo dependem do que estás a fazer. Funções comuns incluem:

  • Proprietário da Conta Azure AI: Criar contas e projetos
  • Azure AI User: Criar e editar agentes
  • Role Based Controlo de Acesso Administrator (ou Owner): Necessário para a configuração padrão de atribuição de funções a recursos ligados

Para configuração padrão, também precisas da permissão Microsoft.Authorization/roleAssignments/write.

Para requisitos completos de funções, veja Permissões necessárias e Controlo de acesso baseado em funções (RBAC) na Microsoft Foundry.

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.

Geral

Armazena algum dado usado na API do Serviço de Agentes da Fundição?

Sim. 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 é que estes dados são armazenados?

  • Configuração básica: Os dados são armazenados numa conta de armazenamento segura, gerida por Microsoft, que está logicamente separada.
  • Configuração padrão: Os dados são armazenados nos seus próprios recursos do Azure, pelo que tem total propriedade e controlo:
    • Armazenamento do Azure: Ficheiros e anexos
    • Azure Cosmos DB: Tópicos e histórico de conversas
    • Pesquisa de IA do Azure: Armazenamentos vetoriais

Para saber mais sobre opções de configuração que controlam onde os dados são armazenados, consulte Configurar o seu ambiente.

Quanto tempo é armazenado 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 são armazenados os dados geograficamente?

Os endpoints do Foundry Agent Service são regionais, e os dados são armazenados na mesma região que o endpoint. Para mais informações, consulte a documentação Azure sobre residência de dados.

Como sou cobrado pelo Serviço de Agente Foundry?

  • É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 defeito, 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 mais informações, consulte a página de preços.

Existe algum preço ou quota adicional para usar o Foundry Agent Service?

Não. Todas as quotas aplicam-se ao uso de modelos com 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 trazer o meu próprio armazenamento, Azure Cosmos DB ou Pesquisa de IA do Azure para dados de agentes?

Utilize hosts com capacidade e ligue os seus próprios recursos.

Monitorização e operações

Como posso monitorizar o Serviço de Agentes da Fundição?

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 Agente depende da sua configuração e dos recursos que disponibiliza. Para obter as orientações atuais, consulte Recuperação de Desastres do Foundry Agent Service.

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 os requisitos e limitações de redes privadas do Serviço de Agentes, consulte Como usar uma rede virtual com o Foundry Agent Service.

Porque é que preciso de delegação de sub-rede?

A rede de serviços de agentes utiliza Azure Container Apps. Quando implementa na sua rede virtual, deve usar uma sub-rede dedicada delegada a 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.

Que intervalo de classes é suportado para sub-redes públicas ou privadas de Classe A, B e C?

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 em 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 com emparelhamento? Posso ter recursos em diferentes redes virtuais?

Sim. 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 do Microsoft Foundry.

Preciso de adicionar alguns FQDNs a uma lista de autorizações se estiver a usar um firewall do Azure?

Sim. Permita os nomes de domínio totalmente qualificados (FQDNs) necessários para 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 do 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 de estar no mesmo grupo de recursos do 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.

Próximos passos