Use seus próprios recursos

Use esse artigo se quiser usar o Serviço de Agente do Azure com recursos que você já possui.

Observação

• Se você usar um recurso existente dos Serviços de IA/Serviço OpenAI do Azure, nenhum modelo será implantado. Você pode implantar um modelo no recurso após a conclusão da configuração do agente.
• Verifique se o recurso do OpenAI do Azure e o projeto da Fábrica de IA do Azure estão na mesma região.

Escolha a configuração básica ou padrão do agente

Para usar seus próprios recursos, você pode editar os parâmetros nos modelos de implantação fornecidos. Para começar, determine se você deseja editar o modelo de configuração básica do agente ou o modelo de configuração padrão do agente.

Configuração Básica: os agentes usam recursos de pesquisa e armazenamento multilocatários totalmente gerenciados pela Microsoft. Você não tem visibilidade ou controle sobre esses recursos subjacentes do Azure. Você só pode usar sua própria conta de serviços de IA com essa opção.

Configuração padrão: os agentes usam recursos de pesquisa e armazenamento de locatário único de propriedade do cliente. Com essa configuração, você tem controle total e visibilidade sobre esses recursos, mas incorre em custos com base no seu uso. Você pode usar sua própria conta de serviços de IA, conta de armazenamento e/ou recurso de Pesquisa de IA do Azure com essa opção.

Configuração Básico do agente: use um recurso existente do AI Services/Azure OpenAI

Substitua o valor do parâmetro aiServiceAccountResourceId pelo ID completo do recurso arm do AI Services ou do recurso Azure OpenAI que você deseja usar.

1. Para obter o ID do recurso da conta do AI Services, entre na CLI do Azure e selecione a assinatura com sua conta do AI Services:

   az login

2. Substitua <your-resource-group> pelo grupo de recursos que contém seu recurso e your-ai-service-resource-name pelo nome do seu recurso de serviço de IA e execute:

   az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv

   O valor retornado é o aiServiceAccountResourceId que você precisa usar no modelo.

3. No arquivo de modelo de agente básico, substitua os seguintes espaços reservados:

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

   Se quiser usar um recurso existente do Azure OpenAI, você precisará atualizar os parâmetros aiServiceAccountResourceId e aiServiceKind no arquivo de parâmetros. O parâmetro aiServiceKind deve ser definido como AzureOpenAI.

Configuração padrão do agente: use um recurso existente do AI Services/Azure OpenAI, armazenamento e/ou IA do Azure Search

Use um recurso de Pesquisa de IA, uma conta de armazenamento e/ou um recurso de Pesquisa de IA do Azure existente, fornecendo a ID completa do recurso ARM no arquivo de modelo de agente padrão.

Use um recurso existente do AI Services ou do Azure OpenAI:

1. Siga as etapas na configuração básica do agente para obter o ID do recurso da conta do AI Services.

2. No arquivo de modelo de agente padrão, substitua os seguintes espaços reservados:

   aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   [Azure OpenAI Only] aiServiceKind: AzureOpenAI
   

Usar uma conta de armazenamento existente

1. Para obter o ID do recurso da sua conta de armazenamento, entre na CLI do Azure e selecione a assinatura com sua conta de armazenamento:

   az login

2. Em seguida, execute o comando :

   az search service show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv

   A saída é o aiStorageAccountResourceID que você precisa usar no modelo.

3. No arquivo de modelo de agente padrão, substitua os seguintes espaços reservados:

   aiStorageAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}
   

Use um recurso existente do IA do Azure Search

1. Para obter sua ID de recurso do IA do Azure Search, entre no CLI do Azure e selecione a assinatura com seu recurso de pesquisa:

   az login

2. Em seguida, execute o comando :

   az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv

3. No arquivo de modelo de agente padrão, substitua os seguintes espaços reservados:

   aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}
   

Confira também

• Aprenda sobre as diferentes ferramentas que os agentes podem usar.