Använd dina egna resurser

Använd den här artikeln om du vill konfigurera ditt Foundry-projekt med dina egna resurser.

Limitations

Det finns vissa begränsningar som du bör känna till när du planerar att använda befintliga resurser med Azure AI Foundry Agent Service.

Om du använder ett hubbbaserat projekt eller Azure OpenAI-assistenter

För närvarande finns det ingen direkt uppgraderingssökväg för att migrera befintliga agenter eller deras associerade datatillgångar, till exempel filer, trådar eller vektorlager från ett hubbbaserat projekt till ett Azure AI Foundry-projekt. Det finns inte heller någon uppgraderingssökväg för att konvertera befintliga Azure OpenAI-assistenter till Foundry Agents, eller ett sätt att automatiskt migrera assistenternas filer, trådar eller vektorlager.

Du kan återanvända dina befintliga modelldistributioner och kvoter från Azure AI Services eller Azure OpenAI-resurser i ett Foundry-projekt.

SDK-användning med hubbbaserade projekt

Från och med maj 2025 använder Azure AI Agent Service en slutpunkt för Foundry-projekt i stället för anslutningssträngen som användes för hubbbaserade projekt före den här tiden. Anslutningssträngar stöds inte längre i aktuella versioner av SDK:erna och REST-API:et. Vi rekommenderar att du skapar ett nytt gjuteriprojekt.

Om du vill fortsätta använda ditt hubbbaserade projekt och din anslutningssträng måste du:

• Använd anslutningssträngen för projektet under Anslutningssträng i översikten över projektet.

  

• Använd en av de tidigare versionerna av SDK:et och den associerade exempelkoden:

  • C#: 1.0.0-beta.2 eller tidigare
  • Python: 1.0.0b10 eller tidigare

Azure Cosmos DB för NoSQL för lagring av trådar

• Ditt befintliga Azure Cosmos DB för NoSQL-konto som används i en standardkonfiguration måste ha en total dataflödesgräns på minst 3 000 RU/s. Både förutbestämd kapacitet och serverlöst stöds.
• Tre containrar etableras i ditt befintliga Cosmos DB-konto, var och en kräver 1 000 RU/s

Prerequisites

• En Azure-prenumeration – Skapa en kostnadsfritt.

• Se till att den person som skapar kontot och projektet har rollen Azure AI-kontoägare i prenumerationsomfånget

• Om du konfigurerar en standardkonfiguration måste samma person också ha behörighet att tilldela roller till nödvändiga resurser (Cosmos DB, Search, Storage). Mer information om RBAC i Azure AI Foundry finns i RBAC i Azure AI Foundry.

  • Den inbyggda roll som krävs är rollbaserad åtkomstadministratör.
  • Alternativt kan du också ha rollen Ägare på prenumerationsnivå som uppfyller det här kravet.
  • Den nyckelbehörighet som krävs är: Microsoft.Authorization/roleAssignments/write

• Registrera providrar. Följande leverantörer måste vara registrerade:

  • Microsoft.KeyVault
  • Microsoft.CognitiveServices
  • Microsoft.Storage
  • Microsoft.MachineLearningServices
  • Microsoft.Search
  • Microsoft.App
  • Microsoft.ContainerService
  • Så här använder du verktyget Grounding med Bing Search: Microsoft.Bing

     az provider register --namespace 'Microsoft.KeyVault'
     az provider register --namespace 'Microsoft.CognitiveServices'
     az provider register --namespace 'Microsoft.Storage'
     az provider register --namespace 'Microsoft.MachineLearningServices'
     az provider register --namespace 'Microsoft.Search'
     az provider register --namespace 'Microsoft.App'
     az provider register --namespace 'Microsoft.ContainerService'
     # only to use Grounding with Bing Search tool
     az provider register --namespace 'Microsoft.Bing'
  

Välj grundläggande agentkonfiguration eller standardagentkonfiguration

Om du vill använda dina egna resurser kan du redigera parametrarna i de angivna distributionsmallarna. Börja genom att ta reda på om du vill redigera mallen för grundläggande agentinstallation eller standardagentkonfigurationsmallen.

Grundläggande installation

Den här konfigurationen är kompatibel med OpenAI-assistenter och hanterar agenttillstånd med hjälp av plattformens inbyggda lagring. Den innehåller samma verktyg och funktioner som Assistants API, med utökat stöd för icke-OpenAI-modeller och verktyg som Azure AI Search och Bing.

Standardkonfiguration

Innehåller allt i den grundläggande konfigurationen och detaljerad kontroll över dina data genom att låta dig använda dina egna Azure-resurser. Alla kunddata – inklusive filer, trådar och vektorlager lagras i dina egna Azure-resurser, vilket ger dig fullständig ägarskap och kontroll.

Grundläggande agentkonfiguration: Använd en befintlig Azure OpenAI-resurs

Ersätt parametervärdet för i existingAoaiResourceId med det fullständiga armresurs-ID:t för den Azure OpenAI-resurs som du vill använda.

1. Om du vill hämta resurs-ID:t för Azure OpenAI-kontot loggar du in på Azure CLI och väljer prenumerationen med ditt AI Services-konto:

   az login
   

2. Ersätt <your-resource-group> med resursgruppen som innehåller resursen och your-azure-openai-resource-name med namnet på din AI Service-resurs och kör:

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

   Värdet som returneras är det existingAoaiResourceId du behöver använda i mallen.

3. I mallfilen basic agent ersätter du följande platshållare:

   existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   

Standardagentkonfiguration: Använd befintliga tjänstresurser och lagringskonton

Använd ett befintligt Azure OpenAI-, Azure Storage-konto, Azure Cosmos DB för NoSQL-konto och/eller Azure AI Search-resurs genom att ange det fullständiga ARM-resurs-ID:t i standardagentmallfilen.

Använda en befintlig Azure OpenAI-resurs

1. Följ stegen i grundläggande agentkonfiguration för att hämta resurs-ID:t för AI Services-kontot.

2. Ersätt följande platshållare i standardagentmallfilen:

   existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
   
   

Använda ett befintligt Azure Storage-konto för att lagra filer

1. Om du vill hämta ditt lagringskontos resurs-ID loggar du in på Azure CLI och väljer prenumerationen med ditt lagringskonto:

   az login

2. Kör sedan kommandot:

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

   Utdata är de aiStorageAccountResourceID du behöver använda i mallen.

3. Ersätt följande platshållare i standardagentmallfilen:

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

Använda ett befintligt Azure Cosmos DB för NoSQL-konto för trådlagring

Ett Azure Cosmos DB för NoSQL-konto skapas för varje Foundry-konto.

För varje projekt under ett Foundry-konto distribueras tre containrar inom samma Cosmos DB-konto. Varje container kräver minst 1 000 RU/s.

Om två projekt till exempel distribueras under samma Foundry-konto måste Cosmos DB-kontot konfigureras med minst 6 000 RU/s (3 containrar × 1 000 RU/s × 2 projekt) för att säkerställa tillräckligt dataflöde.

Både etablerat dataflöde och serverlösa lägen stöds.

1. Om du vill hämta ditt Azure Cosmos DB-kontoresurs-ID loggar du in på Azure CLI och väljer prenumerationen med ditt konto:

   az login
   

2. Kör sedan kommandot:

   az cosmosdb show --resource-group  <your-resource-group> --name <your-comosdb-account>  --query "id" --output tsv
   

   Utdata är de cosmosDBResourceId du behöver använda i mallen.

3. Ersätt följande platshållare i standardagentmallfilen:

   cosmosDBResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosDbAccountName}

Använda en befintlig Azure AI Search-resurs

1. Om du vill hämta resurs-ID:t för Azure AI Search loggar du in på Azure CLI och väljer prenumerationen med din sökresurs:

   az login

2. Kör sedan kommandot:

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

3. Ersätt följande platshållare i standardagentmallfilen:

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

Se även

• Lär dig mer om de olika verktyg som agenter kan använda.