Rychlý start: Nastavení prostředků Microsoft Foundry

V tomto rychlém startu vytvoříte Microsoft Foundry project a nasadíte model. Pokud spravujete tým, udělíte také access členům týmu. Po dokončení těchto kroků můžete vy nebo váš tým začít vytvářet aplikace AI pomocí nasazeného modelu.

Návod

V tomto rychlém startu se dozvíte, jak vytvořit prostředky pro sestavení agenta se základním nastavením. Pokročilejší scénáře, které používají vlastní prostředky, najdete v tématu Nastavení prostředí pro vývoj agentů.

Předpoklady

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.
• Pokud vytváříte project pro sebe:
  • Přístup k roli, která umožňuje vytvořit prostředek Foundry, například vlastníkovi AI účtu Azure nebo vlastníkovi Azure AI v rámci předplatného nebo skupiny prostředků. Další informace o oprávněních viz Řízení přístupu na základě rolí pro Microsoft Foundry.
• Pokud vytváříte project pro tým:
  • Přístup k roli, jež umožňuje dokončit přiřazení rolí, například Owner. Další informace o oprávněních viz Řízení přístupu na základě rolí pro Microsoft Foundry.
  • Seznam e-mailových adres uživatelů nebo ID skupin zabezpečení Microsoft Entra pro členy týmu, kteří potřebují access.

Vyberte upřednostňovanou metodu pomocí následujících karet:

Azure CLI

• Nainstalujte Azure CLI verze 2.67.0 nebo novější (zkontrolujte az version).

• Přihlaste se k Azure:

  az login
  

Portál Foundry

• Access k portálu Microsoft Foundry.

Vytvořit projekt

Vytvořte project Foundry pro uspořádání práce. Project obsahuje modely, agenty a další prostředky, které váš tým používá.

Azure CLI

1. Vytvořte skupinu prostředků nebo použijte existující. Například vytvořte my-foundry-rg v eastus:

   az group create --name my-foundry-rg --location eastus
   

2. Vytvořte zdroj Foundry. Vytvořte například my-foundry-resource ve my-foundry-rg skupině prostředků:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   Příznak --allow-project-management umožňuje vytváření project v rámci tohoto prostředku.

3. Vytvořte pro prostředek vlastní subdoménu. Název custom domain musí být globálně jedinečný. Pokud se my-foundry-resource používá, zkuste jedinečnější název.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Vytvořte project. Například v my-foundry-project vytvořte my-foundry-resource:

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

5. Ověřte, že projekt byl vytvořen.

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project
   

   Výstup zobrazí vlastnosti projektu, včetně ID prostředku.

Referenční informace: účet az cognitiveservices

Portál Foundry

1. Přihlaste se k Microsoft Foundry. Ujistěte se, že je zapnutý přepínač New Foundry . Tyto kroky odkazují na Foundry (nové).

   

2. Vytvořte projekt.

   • Pokud se jedná o první použití Foundry, zobrazí se výzva k vytvoření nebo vyhledání projektu, aby pokračoval. V rozevíracím seznamu vyberte Vytvořit nový projekt .
   • Pokud už máte projekt načtený, vyberte jeho název v levém horním rohu a pak vyberte Vytvořit nový projekt.

3. Zadejte název project, například my-foundry-project.

4. Vyberte upřesněné možnosti pro konfiguraci skupiny prostředků a umístění:

   • Skupina prostředků: Vytvořte novou skupinu prostředků nebo vyberte existující. Pokud vytvoříte novou skupinu prostředků, můžete snadněji spravovat project a všechny její prostředky společně.
   • Umístění: Vyberte oblast, která je nejblíže vašemu týmu.

5. Vyberte Vytvořit projekt.

   Počkejte na vytvoření projektu. Jakmile se zobrazí stránka s přehledem projektu, váš projekt je připraven.

Nasazení modelu

Nasaďte model, který můžete použít. Tento příklad používá gpt-4.1-mini, ale můžete zvolit libovolný dostupný model.

Azure CLI

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Ověřte, že nasazení proběhlo úspěšně:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini

Jakmile je nasazení připravené, zobrazí se "provisioningState": "Succeeded".

Referenční informace: nasazení účtu az cognitiveservices

Portál Foundry

1. Ve vašem projektu vyberte v pravém horním navigačním panelu možnost Objevit.
2. Vyberte Modely.
3. Vyhledejte gpt-4.1-mini.
4. Vyberte Deploy>Default settings a přidejte ho do svého project.
5. Poznamenejte si název nasazení (například gpt-4.1-mini). K použití modelu potřebuje váš tým tento název.

Získejte podrobnosti o připojení projektu

K připojení z kódu potřebujete koncový bod projektu. Pokud tento projekt spravujete pro ostatní, pošlete jim tento koncový bod spolu s názvem nasazení.

1. Přihlaste se k Microsoft Foundry pomocí svého účtu Azure.
2. Vyberte project.
3. Najděte koncový bod svého projektu na úvodní obrazovce projektu.
4. Zkopírujte hodnotu koncového bodu. Tuto hodnotu použijete v dalších rychlých startech a kurzech.

Pro administrátory – udělení přístupu

Pokud spravujete tým, přiřaďte roli uživatel Azure AI členům týmu, aby mohli využívat projekt a nasazené modely. Tato role poskytuje minimální oprávnění potřebná k sestavení a testování aplikací AI. Další role, které možná budete muset přiřadit, najdete v části Řízení přístupu na základě rolí pro Microsoft Foundry

Azure CLI

1. Získejte ID zdroje projektu:

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. Přiřaďte roli uživatele Azure AI členu týmu:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

   Přidání skupiny zabezpečení místo jednotlivých uživatelů:

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Ověřte přiřazení role:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Referenční informace: přiřazení role az

Portál Foundry

1. Na portálu Foundry vyberte v pravém horním navigačním panelu pracovat .
2. V levém podokně vyberte Správce .
3. V tabulce vyberte název projektu.
4. V pravém horním rohu vyberte Přidat uživatele .
5. Zadejte e-mailovou adresu člena týmu.
6. Vyberte Přidat.

Tento postup opakujte pro každého člena týmu nebo skupinu zabezpečení.

Návod

Pokud chcete přidat více uživatelů najednou, použijte místo jednotlivých e-mailových adres skupinu zabezpečení Microsoft Entra.

Ověření přístupu člena týmu

Požádejte člena týmu, aby ověřil svůj access přihlášením k Microsoft Foundry, výběrem project ze seznamu project a potvrzením zobrazení nasazeného modelu v části Build>Models

Pokud člen týmu nemůže získat přístup k projektu, ověřte, že přiřazení role bylo úspěšně dokončeno. Zkontrolujte, jestli jste použili správnou e-mailovou adresu nebo ID skupiny zabezpečení. Ujistěte se, že účet člena týmu Azure je ve stejném tenantovi Microsoft Entra.

Vyčistěte zdroje

Pokud už tuto project nechcete, odstraňte skupinu prostředků a odstraňte všechny prostředky, které jsou k ní přidružené.

Azure CLI

az group delete --name my-foundry-rg --yes --no-wait

Portál Foundry

V Azure portal vyhledejte a vyberte skupinu prostředků. Vyberte Odstranit a potvrďte odstranění skupiny prostředků a všech přidružených prostředků.

Další krok

Rychlý průvodce pro Microsoft Foundry