Nastavte standardní zdroje agenta

Nastavení standardního agenta používá prostředky Azure spravované zákazníkem v prostředí jednoho tenantu k ukládání stavu agenta a udržuje všechna data agenta pod vaší kontrolou. Standardní nastavení použijte, když potřebujete úplnou suverenitu dat, dodržování zásad zabezpečení podniku nebo izolaci na úrovni projektu.

V tomto nastavení:

  • Stavy agentů (konverzace, odpovědi) jsou uložené ve vašich vlastních Azure prostředcích.
  • Máte úplnou kontrolu nad umístěním a přístupem k datům.

Tip

Jednodušší nastavení, které používá prostředky spravované Microsoft, najdete v tématu Environment setup a zvolte možnost základního nastavení agenta.

Požadavky

Přehled prostředků

Důležité

Standardní nastavení vyžadují, abyste si přinesli vlastní prostředky (BYO), aby všechna data agenta zůstala ve vašem Azure tenantu:

Zdroj Co to ukládá
Azure Storage (BYO Úložiště souborů) Soubory nahrané vývojáři a koncovými uživateli
Azure AI Vyhledávač (vyhledávání BYO) Vektorová úložiště vytvořená agentem
Azure Cosmos DB (byo Thread Storage) Zprávy, historie konverzací a metadata agenta

Všechna data zpracovávaná službou Foundry Agent Service se v těchto prostředcích automaticky ukládají v klidovém stavu, což vám pomůže splnit požadavky na dodržování předpisů a standardy zabezpečení podniku.

Požadavky na propustnost služby Cosmos DB

Váš Azure Cosmos DB pro účet NoSQL musí mít limit celkové propustnosti alespoň 3000 RU/s. Podporují se zřízené režimy propustnosti i bez serveru .

Standardní nastavení zřídí pět kontejnerů, z nichž každý vyžaduje 1000 RU/s:

Kontejner Účel
thread-message-store Konverzace koncových uživatelů
system-thread-message-store Interní systémové zprávy
agent-entity-store Metadata agenta (pokyny, nástroje, název)
agent-definitions-v1 Metadata agenta (pokyny, nástroje, název, verze)
run-state-v1 Interní zprávy a konverzace koncových uživatelů

thread-message-store, system-thread-message-storea agent-entity-store jsou součástí standardní instalace služby Foundry Agent Service (Classic).

Foundry Agent Service (New) používá agent-definitions-v1 a run-state-v1.

Starší kontejnery patří do klasického prostředí a nejsou používány novým modulem runtime.

Výstraha

Classic a Nová runtime prostředí služby Foundry Agent Service používají různé kontejnery Cosmos DB.

izolace dat na úrovni projektu

Standardní nastavení ve výchozím nastavení vynucuje izolaci dat na úrovni projektu. Ve vašem účtu úložiště se automaticky zřídí dva kontejnery úložiště objektů blob: jeden pro soubory a druhý pro zprostředkující systémová data (bloky dat, vkládání). Ve vašem účtu Cosmos DB se zřídí tři kontejnery: jeden pro vlákna uživatelů, jeden pro systémové zprávy a jeden pro konfigurační data agenta, jako jsou pokyny, nástroje a názvy. Toto výchozí chování snižuje složitost nastavení a přitom stále vynucuje přísné hranice dat mezi projekty.

Servery poskytující funkce

Hostitelé funkcí jsou dílčími prostředky v účtu i projektu, které umožňují interakci se službou Agenta.

  • Hostitel schopností účtu: Má prázdné tělo požadavku s výjimkou parametru capabilityHostKind="Agents".
  • hostitel funkcí projektu Project: Určuje prostředky pro ukládání stavu agenta, a to buď prostředky spravované společností Microsoft v multitenantním prostředí (základní nastavení), nebo prostředky vlastněné zákazníkem a určené pro jednoho tenanta (standardní nastavení). Projektové schopnosti fungují jako nastavení projektu.

Omezení

  • Nelze aktualizovat hostitele funkcí poté, co byl nastaven pro projekt nebo účet.

Zřizujte prostředky krok za krokem

Ruční zřizování

Pokud chcete ručně zřídit všechny prostředky potřebné pro standardní instalaci agenta, postupujte podle těchto kroků. Na celý proces zřizování si vyhraďte přibližně 30 až 45 minut.

Fáze 1: Vytvoření závislých prostředků

  1. Vytvořte nebo znovu použijte následující zdroje informací. Můžete vytvořit nové prostředky nebo předat ID existujících prostředků:
    • Azure Cosmos DB pro účet NoSQL
    • účet Azure Storage
    • prostředek Azure AI Vyhledávač
    • prostředek Azure Key Vault (používá se ke správě tajných kódů a připojovacích řetězců pro infrastrukturu agentů)
    • [Volitelné] prostředek Aplikace Azure Insights
    • [Volitelné] Existující Foundry prostředek

Fáze 2: Vytvoření prostředků a připojení pro foundry

  1. Vytvořte prostředek Microsoft Foundry.
  2. Vytvoření připojení na úrovni účtu:
    • Vytvořte připojení účtu k prostředku Application Insights.
  3. Nasaďte model gpt-4o nebo jiný model kompatibilní s agentem.
  4. Vytvořte projekt.
  5. Vytvořit připojení projektu:
    • [Je-li k dispozici] Připojení projektu k prostředku Foundry.
    • Připojení projektu k účtu Azure Storage.
    • Připojení projektu k prostředku Azure AI Vyhledávač.
    • Připojení projektu k účtu Cosmos DB.

Fáze 3: Přiřazení rolí ke spravované identitě projektu

Spravovaná identita projektu zahrnuje spravovanou identitu přiřazenou systémem (SMI) i spravovanou identitu přiřazenou uživatelem (UMI).

  1. Přiřaďte spravovanou identitu projektu (pro SMI) následující role:
    • Operátor služby Cosmos DB na úrovni účtu pro prostředek Cosmos DB.
    • Přispěvatel účtu úložiště na úrovni účtu pro prostředek účtu úložiště.

Fáze 4: Konfigurace hostitelů schopností

  1. Nastavte hostitele funkčnosti účtu s prázdnou sekcí vlastností.
  2. Nastavte hostitele možností projektu pomocí připojení Cosmos DB, Azure Storage a AI Search.

Fáze 5: Přiřazení podrobných oprávnění k prostředkům

  1. Přiřaďte spravované identitě projektu (SMI i UMI) následující role v zadaných oborech prostředků:
    • Azure AI Vyhledávač (přiřaďte před nebo po vytvoření schopnostního hostitele):
      • Přispěvatel dat indexu vyhledávání
      • Přispěvatel vyhledávací služby
    • kontejner Azure Blob Storage: <workspaceId>-azureml-blobstore
      • Přispěvatel dat služby Blob Storage
    • kontejner Azure Blob Storage: <workspaceId>-agents-blobstore
      • Vlastník dat objektů blob služby Storage
    • Cosmos DB pro databázi NoSQL: enterprise_memory
      • Integrovaný přispěvatel dat ve službě Cosmos DB
      • Obor: Úroveň databáze pro pokrytí všech kontejnerů (není potřeba přiřazení role specifické pro jednotlivé kontejnery).

Fáze 6: Udělení přístupu pro vývojáře

  1. Přiřaďte všem vývojářům, kteří potřebují v projektu vytvářet nebo upravovat agenty, roli Foundry User v rámci projektu.

Důležité

Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

Použijte šablonu Bicep

Použijte existující účet Azure OpenAI, účet Azure Storage, účet Azure Cosmos DB pro NoSQL nebo prostředek Azure AI Vyhledávač zadáním úplného ID prostředku Azure Resource Manager (ARM) v souboru standardní šablony agenta.

Použití existujícího prostředku Azure OpenAI

  1. Podle pokynů v nastavení prostředí získejte identifikátor zdroje účtu Foundry Tools.

  2. V souboru šablony standardního agenta nahraďte následující zástupný symbol:

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

Použití existujícího účtu Azure Storage pro úložiště souborů

  1. Přihlaste se k Azure CLI a vyberte předplatné pomocí účtu úložiště:

    az login

  2. Spuštěním následujícího příkazu získejte ID prostředku účtu úložiště:

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

    Hodnota aiStorageAccountResourceID je výstupem, který potřebujete v šabloně.

  3. V souboru šablony standardního agenta nahraďte následující zástupný symbol:

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

Použití existujícího Azure Cosmos DB pro účet NoSQL pro úložiště vláken

Pro každý účet Foundry se vytvoří Azure Cosmos DB pro účet NoSQL. Požadavky na propustnost a škálování s více projekty najdete v tématu Požadavky na propustnost služby Cosmos DB.

Poznámka

Nedostatečná kapacita RU/s v účtu Cosmos DB vede k selhání zřizování hostitelských schopností během nasazování.

  1. Přihlaste se k Azure CLI a vyberte předplatné pomocí účtu služby Cosmos DB:

    az login

  2. Spuštěním následujícího příkazu získejte ID prostředku účtu Azure Cosmos DB:

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

    Hodnota cosmosDBResourceId je výstupem, který potřebujete v šabloně.

  3. V souboru šablony standardního agenta nahraďte následující zástupný symbol:

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

Použití existujícího prostředku Azure AI Vyhledávač

  1. Přihlaste se k Azure CLI a vyberte předplatné s vaším vyhledávacím prostředkem:

    az login

  2. Spuštěním následujícího příkazu získejte ID prostředku Azure AI Vyhledávač:

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

  3. V souboru šablony standardního agenta nahraďte následující zástupný symbol:

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

Ověření nastavení

Po dokončení zřizování ověřte, že nastavení funguje správně:

  1. Na portálu Azure přejděte do projektu Foundry a ověřte, že se všechna připojení (Storage, Cosmos DB, AI Search) zobrazují v nastavení projektu.
  2. Zkontrolujte, jestli se u účtu i projektu zobrazuje stav hostitele schopností jako Úspěšný .
  3. Ověřte přiřazení rolí tak, že přejdete na stránku řízení přístupu (IAM) jednotlivých zdrojů a potvrdíte, že spravovaná identita projektu má očekávané role.
  4. Vytvořte testovacího agenta pro potvrzení kompletní funkčnosti.

Řešení běžných problémů

Příznak Příčina Rozlišení
CapabilityHostProvisioningFailed Nebo stav hostitele schopností se zobrazuje jako neúspěšný Nedostatečná propustnost služby Cosmos DB Ujistěte se, že váš účet Cosmos DB má alespoň 3 000 RU/s (1000 RU/s na kontejner × 3 kontejnery). U více projektů vynásobte počtem projektů.
403 Forbidden když agent čte nebo zapisuje soubory Chybějící přiřazení úložišťové role Ověřte, že spravovaná identita projektu má Přispěvatel dat úložiště objektů blob v kontejneru <workspaceId>-azureml-blobstore a Vlastník dat úložiště objektů blob v kontejneru <workspaceId>-agents-blobstore.
SearchIndexNotFound nebo 403 při operacích vyhledávání Chybějící role vyhledávání Ověřte, že spravovaná identita projektu má jak Search Index Data Contributor, tak Search Service Contributor na prostředku Azure AI Vyhledávač.
AuthorizationFailed při vytváření nebo úpravě agentů Chybějící role uživatele Přiřaďte vývojáři roli uživatele Foundry v oboru projektu.
Požadavek na aktualizaci hostitele funkcí vrací 400 BadRequest Aktualizace není podporována. Po vytvoření není možné aktualizovat capability hosty. Pokud jsou potřeba změny konfigurace, odstraňte projekt a vytvořte ho znovu.

Související obsah

  • Last updated on