Rychlý start: Nastavení prvního prostředku Foundry

V tomto rychlém spuštění vytvoříte prostředek Microsoft Foundry a ověříte přístup.

Naučte se vytvářet a spravovat prostředek Foundry. Jedná se o primární typ prostředku Azure pro sestavování, nasazování a správu modelů a aplikací generativní umělé inteligence, včetně agentů.

K používání a správě služeb v Azure se vyžaduje Azure prostředek. Definuje rozsah pro konfiguraci přístupu a zabezpečení, jako jsou sítě, fakturace a monitorování.

Nástroj Foundry je nástupnická verze a přejmenování bývalého "Foundry Tools". Poskytuje aplikační prostředí pro hostování agentů, nasazení modelů, vyhodnocení a dalších.

Zdroj Foundry může uspořádat práci pro více případů použití a obvykle se sdílí mezi týmem vývojářů, kteří pracují na případech použití v podobné obchodní nebo datové doméně. Projekty fungují jako složky pro seskupování související práce.

Diagram znázorňující prostředek Foundry obsahující více projektů, z nichž každý obsahuje nasazení a připojení

Hledáte konfiguraci Foundry s pokročilým nastavením zabezpečení? Zobrazit pokročilé možnosti vytváření Foundry

Vytvořte svůj první prostředek

Pokud chcete vytvořit první prostředek se základním nastavením Azure, postupujte podle následujících kroků pomocí Azure portal, Azure CLI nebo PowerShellu.

Požadavky

  • Platné předplatné Azure – Kreate si ho zdarma.
  • RBAC role Azure pro vytváření prostředků. Potřebujete jednu z následujících rolí přiřazených k vašemu Azure předplatnému nebo skupině prostředků:
    • Přispěvatel
    • Vlastník
    • Vlastní role s oprávněním Microsoft.CognitiveServices/accounts/write

Vytvoření nového prostředku Microsoft Foundry

Pokud vaše organizace vyžaduje přizpůsobené konfigurace Azure, jako jsou alternativní názvy, kontrolní mechanismy zabezpečení nebo značky nákladů, možná budete muset použít Azure portal nebo možnosti šablony, abyste vyhověli dodržení zásad Azure Policy vaší organizace.

Prostředek Foundry je uvedený v části Foundry>Foundry v Azure portal. Druh rozhraní API je AIServices. Podívejte se na logo, jak je znázorněno tady:

Screenshot prostředku Foundry v portálu Azure.

Návod

portál Foundry nabízí způsob, jak vytvořit nový prostředek Foundry se základním výchozím nastavením.

Pokud chcete vytvořit prostředek Foundry v Azure portal postupujte podle těchto pokynů:

  1. Vyberte tento odkaz na prostředek Foundry: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. Na stránce Vytvořit zadejte následující informace:

    Podrobnosti o projektu Popis
    Předplatné Vyberte jedno z dostupných Azure předplatných.
    Skupina prostředků Skupina prostředků Azure, která bude obsahovat váš prostředek Foundry. Můžete vytvořit novou skupinu nebo ji přidat do existující skupiny.
    Oblast Umístění instance nástroje Foundry. Různá umístění mohou způsobit zpoždění (latenci), ale nemají žádný vliv na dostupnost v době běhu vašeho prostředku.
    Název Popisný název pro váš zdroj ve Foundry. Například MyAIServicesResource.

  3. Podle potřeby nakonfigurujte další nastavení pro váš prostředek, přečtěte si a přijměte podmínky (podle potřeby) a pak vyberte Zkontrolovat a vytvořit.

Návod

Pokud vám vaše předplatné neumožňuje vytvořit prostředek Foundry, Možná budete muset povolit oprávnění poskytovatele prostředků Azure pomocí příkazu Azure portalPowerShell nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte někoho s rolí vlastníka nebo správce, aby dokončil registraci za vás nebo požádal o udělení oprávnění /register/action vašemu účtu.

Vyčištění prostředků

Pokud chcete vyčistit a odebrat prostředek Foundry, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

  1. V Azure portálu rozbalte nabídku na levé straně, otevřete menu služeb a zvolte Skupiny prostředků, abyste zobrazili seznam vašich skupin prostředků.
  2. Vyhledejte skupinu prostředků obsahující prostředek, který se má odstranit.
  3. Pokud chcete odstranit celou skupinu prostředků, vyberte název skupiny prostředků. Na další stránce vyberte Odstranit skupinu prostředků a potvrďte ji.
  4. Pokud chcete odstranit pouze prostředek Foundry, vyberte skupinu prostředků a zobrazte všechny prostředky v ní. Na další stránce vyberte prostředek, který chcete odstranit, klikněte na nabídku se třemi tečkami u tohoto řádku a vyberte Odstranit.

Pomocí tohoto rychlého startu vytvoříte prostředek Foundry pomocí příkazů Azure Command-Line Interface (CLI).

Požadavky

  • Platné předplatné Azure – Kreate si jedno zdarma.
  • Azure CLI verze 2.0 nebo novější.
  • RBAC role Azure pro vytváření prostředků. Potřebujete jednu z následujících rolí přiřazených k vašemu Azure předplatnému nebo skupině prostředků:
    • Přispěvatel
    • Vlastník
    • Vlastní role s oprávněním Microsoft.CognitiveServices/accounts/write

Instalace Azure CLI a přihlášení

Nainstalujte Azure CLI. Pokud se chcete přihlásit k místní instalaci rozhraní příkazového řádku, spusťte příkaz az login:

az login

Vytvoření nové skupiny prostředků

Než vytvoříte prostředek Foundry, musíte mít Azure skupinu prostředků, která prostředek obsahuje. Když vytvoříte nový prostředek, můžete buď vytvořit novou skupinu prostředků, nebo použít existující. Tento článek ukazuje, jak vytvořit novou skupinu prostředků.

K vytvoření prostředku budete potřebovat jednu z lokalit Azure dostupných pro vaše předplatné. Seznam dostupných umístění můžete načíst pomocí příkazu az account list-locations. Většina nástrojů Foundry je přístupná z několika míst. Vyberte umístění, která jsou k vám nejblíže, nebo zjistěte, která umístění jsou pro službu dostupná.

Důležité

  • Vzpomeňte si Azure umístění, protože ho budete potřebovat při volání prostředků Microsoft Foundry.
  • Dostupnost některých nástrojů Foundry se může lišit v jednotlivých oblastech. Další informace najdete v tématu Azure products by region.
az account list-locations --query "[].{Region:name}" --out table

Jakmile budete mít umístění Azure, vytvořte v Azure CLI novou skupinu prostředků pomocí příkazu az group create. V následujícím příkladu nahraďte umístění Azure westus2 jedním z umístění Azure dostupných pro vaše předplatné.

az group create --name ai-services-resource-group --location westus2

Vytvoření prostředku Foundry

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku Foundry, použijte příkaz az cognitiveservices account create. Tento příkaz přidá nový fakturovatelný prostředek do skupiny prostředků, kterou jste vytvořili dříve. Při vytváření nového prostředku budete muset znát druh služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou) a Azure umístěním.

Důležité

Azure poskytuje různé zdroje pro nástroje Foundry. Nezapomeňte vytvořit jednu s kind z AIServices.

Prostředek Foundry s názvem foundry-multi-service-resource můžete vytvořit pomocí následujícího příkazu.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Návod

Pokud vám vaše předplatné neumožňuje vytvořit prostředek Foundry, Možná budete muset povolit oprávnění poskytovatele prostředků Azure pomocí příkazu Azure portalPowerShell nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte někoho s rolí vlastníka nebo správce, aby dokončil registraci za vás nebo požádal o udělení oprávnění /register/action vašemu účtu.

Získat aktuální využití kvóty pro váš prostředek

K získání využití vašeho prostředku použijte příkaz az cognitiveservices account list-usage.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Vyčištění prostředků

Pokud chcete vyčistit a odebrat prostředek Foundry, můžete odstranit buď jednotlivý prostředek, nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

Pokud chcete odebrat skupinu prostředků a její přidružené prostředky, použijte příkaz az group delete command.

az group delete --name ai-services-resource-group

Pomocí tohoto rychlého startu můžete vytvořit prostředek Foundry pomocí příkazů Azure PowerShell.

Požadavky

  • Platné předplatné Azure – Kreate si jedno zdarma.
  • Azure PowerShell verze 5.0 nebo novější.
  • RBAC role Azure pro vytváření prostředků. Potřebujete jednu z následujících rolí přiřazených k vašemu Azure předplatnému nebo skupině prostředků:
    • Přispěvatel
    • Vlastník
    • Vlastní role s oprávněním Microsoft.CognitiveServices/accounts/write

Instalace Azure PowerShell a přihlášení

Nainstalujte Azure PowerShell. Pokud se chcete přihlásit, spusťte příkaz Connect-AzAccount :

Connect-AzAccount

Vytvoření nové skupiny prostředků Microsoft Foundry

Než vytvoříte prostředek Foundry, musíte mít Azure skupinu prostředků, která prostředek obsahuje. Když vytvoříte nový prostředek, můžete buď vytvořit novou skupinu prostředků, nebo použít existující. Tento článek ukazuje, jak vytvořit novou skupinu prostředků.

K vytvoření prostředku budete potřebovat jednu z lokalit Azure dostupných pro vaše předplatné. Seznam dostupných umístění můžete načíst pomocí příkazu Get-AzLocation . Většina nástrojů Foundry je přístupná z několika míst. Vyberte umístění, která jsou k vám nejblíže, nebo zjistěte, která umístění jsou pro službu dostupná.

Důležité

  • Zapamatujte si Azure umístění, protože ho budete potřebovat při volání prostředků Foundry.
  • Dostupnost některých nástrojů Foundry se může lišit v jednotlivých oblastech. Další informace najdete v tématu Azure products by region.
Get-AzLocation | Select-Object -Property Location, DisplayName

Jakmile budete mít svou lokaci Azure, vytvořte v Azure PowerShell novou skupinu prostředků pomocí příkazu New-AzResourceGroup. V následujícím příkladu nahraďte umístění Azure westus2 jedním z umístění Azure dostupných pro vaše předplatné.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Vytvoření prostředku Foundry

K vytvoření a přihlášení k odběru nového prostředku Foundry použijte příkaz New-AzCognitiveServicesAccount . Tento příkaz přidá nový fakturovatelný prostředek do skupiny prostředků, kterou jste vytvořili dříve. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a Azure umístěním:

Důležité

Azure poskytuje různé zdroje pro nástroje Foundry. Nezapomeňte vytvořit jednu s Type (typem) AIServices.

Prostředek Foundry s názvem foundry-multi-service-resource můžete vytvořit pomocí následujícího příkazu.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Návod

Pokud vám vaše předplatné neumožňuje vytvořit prostředek Foundry, Možná budete muset povolit oprávnění poskytovatele prostředků Azure pomocí příkazu Azure portalPowerShell nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte někoho s rolí vlastníka nebo správce, aby dokončil registraci za vás nebo požádal o udělení oprávnění /register/action vašemu účtu.

Získat aktuální využití kvóty pro váš prostředek

Pomocí příkazu Get-AzCognitiveServicesAccountUsage získejte využití vašeho prostředku.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Vyčištění prostředků

Pokud chcete vyčistit a odebrat prostředek Foundry, můžete odstranit buď jednotlivý prostředek, nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

Pokud chcete odebrat skupinu prostředků a její přidružené prostředky, použijte příkaz Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Přístup ke zdroji

Po vytvoření prvního prostředku k němu můžete přistupovat prostřednictvím portálu Foundry pro vytváření prototypů uživatelského rozhraní, Foundry SDK pro vývoj nebo prostřednictvím Azure portálu pro správu.

Ověření nastavení

Pomocí sady SDK pro Azure AI můžete ověřit, zda je váš prostředek správně nastavený tím, že se připojíte a vypíšete projekty. Tento minimální příklad potvrzuje ověřování a přístup.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Očekávaný výstup: Successfully connected. Found X projects. kde X je počet projektů ve vašem zdroji.

Odkazy:

Udělení nebo získání oprávnění pro vývojáře

Řízení přístupu na základě rolí Azure (RBAC) rozlišuje oprávnění mezi správními a vývojovými úkony. Aby bylo možné sestavovat pomocí Foundry, musí mít váš uživatelský účet přiřazená oprávnění pro vývojáře ("akce dat"). Můžete použít některou z předdefinovaných rolí RBAC nebo použít vlastní roli RBAC.

Mezi předdefinované Azure role pro vývojáře RBAC pro Foundry patří:

Role Popis
Azure AI Projektový manažer Uděluje oprávnění pro vývoj a oprávnění pro správu projektů. Může pozvat ostatní uživatele, aby spolupracovali na project jako uživatel Azure AI.
Uživatel Azure AI Uděluje oprávnění pro vývoj.
vlastník účtu AI Azure Uděluje úplný přístup ke správě projektů a účtů AI. Může pozvat ostatní uživatele, aby spolupracovali na project jako uživatel Azure AI.
Azure AI Správce Uděluje úplný přístup ke spravovaným projektům a účtům AI a umožňuje budovat a vyvíjet projekty.

Poznámka:

Role vlastníka Azure AI bude brzy dostupná pro přiřazení na portálu Azure a Foundry.

Diagram předdefinovaných rolí v Foundry

Pro větší podniky s přísnými požadavky na access na základě rolí doporučujeme využít roli uživatele Azure AI s nejnižšími oprávněními pro vývojáře. Pro menší podniky, které chtějí, aby vývojáři v rámci organizace byli samoobslužní, doporučujeme využít roli vlastníka AI Azure pro oprávnění vývojáře a také oprávnění k vytváření prostředků.

Pouze autorizovaní uživatelé, obvykle vlastník Azure předplatného nebo skupiny zdrojů, mohou přiřadit roli buď prostřednictvím [Azure portal](odkaz na Azure portal), nebo [Foundry portálu pomocí administrátora](odkaz na portál Foundry). Zjistěte více o řízení přístupu založeném na rolích.

Důležité

Azure role Vlastník a Přispěvatel zahrnují jenom oprávnění pro správu, nikoli oprávnění pro vývoj. K vývoji se všemi funkcemi v Foundry se vyžadují oprávnění k vývojovým činnostem.

Začněte budovat svůj první projekt

S nastavenými oprávněními teď můžete začít vytvářet Foundry. Na portálu Foundry otevřete nebo vytvořte svůj první projekt. Projekty organizují vaši práci s přizpůsobením agenta a modelu v Foundry, a můžete vytvořit více pod stejným zdrojem.

Prozkoumejte některé služby, které jsou součástí vašeho prostředku:

Služba Popis
Ikona FoundryFoundry iconSlužba Agenta Foundry Zkombinujte výkon generovaných modelů AI s nástroji, které umožňují agentům access a interakci se skutečnými zdroji dat.
ikona FoundryAzure Odvození modelu Provádí odvozování modelů pro vlajkové modely v katalogu modelů Foundry.
Ikona Azure OpenAI Foundry Models Azure OpenAI Proveďte širokou škálu úloh přirozeného jazyka.
Ikona zabezpečení obsahu Zabezpečení obsahu Nástroj Foundry, který detekuje nežádoucí obsah.
ikona Document IntelligenceDocument Intelligence Převést dokumenty na inteligentní řešení založená na datech.
IkonaLanguage Language Vytvářejte aplikace s špičkovými přirozenými language understanding funkcemi.
Ikona řeči Řeč Rozpoznávání řeči na text, převod textu na řeč, překlad a rozpoznávání mluvčího.
Ikona TranslatorTranslator Pomocí technologie překladu založené na umělé inteligenci můžete překládat více než 100 používaných jazyků a dialektů s riziky a ohrožených jazyků.

Další kroky

  • Last updated on