Projekt létrehozása Microsoft Foundryhez

Ebből a cikkből létrehozhat egy Foundry-projektet, és ellenőrizheti, hogy a környezet készen áll-e az ügynökök, értékelések és fájlok létrehozása előtt.

Ez a cikk azt ismerteti, hogyan hozhat létre Foundry-projektet Microsoft Foundry. A projektek segítségével rendszerezheti a munkáját – például ügynököket, értékeléseket és fájlokat –, miközben állapotalapú alkalmazásokat készít, és új ötleteket fedez fel.

Ha a szervezet egyéni Azure konfigurációkat, például alternatív neveket, biztonsági vezérlőket vagy költségcímkéket igényel, előfordulhat, hogy a Azure portált vagy template-beállításokat kell használnia a szervezet Azure Policy követelményeinek való megfeleléshez.

Előfeltételek

• Aktív előfizetéssel rendelkező Azure fiók. Ha nem rendelkezik ilyen fiókkal, hozzon létre egy free Azure fiókot, amely ingyenes próbaverziós előfizetést tartalmaz.

• Ha saját maga hozza létre a projektet:

  • Hozzáférés egy olyan szerepkörhöz, amely lehetővé teszi egy Öntödei erőforrás létrehozását, például az Öntödei fiók tulajdonosa vagy az Öntöde tulajdonosa az előfizetésben vagy az erőforráscsoportban. További információ az engedélyekről a Microsoft Foundry szerepkör-alapú hozzáférés-vezérlésének keretében található.

    Fontos

    Az Foundry RBAC-szerepköröket nemrég átnevezték. Foundry user, Foundry Owner, Foundry-fióktulajdonos és Foundry Project Manager korábban Azure AI-felhasználónak, Azure AI-tulajdonosnak, Azure AI-fióktulajdonosnak és Azure AI-Project-kezelőnek hívták. Előfordulhat, hogy egyes helyeken továbbra is a korábbi elnevezések jelennek meg, amíg az átnevezés fokozatosan bevezetésre kerül. A szerepkör-azonosítók és az alapvető jogosultságok az átnevezés ellenére változatlanok maradnak.

• Ha egy csapat számára hozza létre a projektet:

  • Hozzáférés egy szerepkörhöz, amely lehetővé teszi a szerepkör-hozzárendelések( például tulajdonos) elvégzését. További információ az engedélyekről a Microsoft Foundry szerepkör-alapú hozzáférés-vezérlésének keretében található.
  • A hozzáférésre szoruló csoporttagok felhasználói e-mail-címeinek vagy Microsoft Entra biztonságicsoport-azonosítóinak listája.

Az alábbi lapok segítségével válassza ki azt a metódust, amelyet egy Foundry-projekt létrehozásához szeretne használni:

Öntödei portál

• A portál használatakor nincs szükség további előfeltételekre.

Python SDK

• Állítsa be a fejlesztési környezetet.

• Futtassa a az login vagy az login --use-device-code elemet a környezetében, mielőtt a kódot futtatná.

• Csomagok telepítése: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Ha jegyzetfüzetcellában van, használja %pip install helyette.

• A 13.7-es vagy újabb verzió ellenőrzésére használható pip show azure-mgmt-cognitiveservices .

• Gyors ellenőrzés: A projekt létrehozása előtt ellenőrizze az SDK-t és a hitelesítést az ügyfél tesztelésével:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• Indítsa el a szkriptet a következő kóddal a client jelen cikkben használt kapcsolat és változók létrehozásához. Ez a példa az USA keleti régiójában hozza létre a projektet:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (Nem kötelező) Ha több fiókkal rendelkezik, adja hozzá a használni kívánt Microsoft Entra ID bérlőazonosítóját a DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

Azure parancssori felület

• Telepítse a Azure CLI.
• Állítsa be az alapértelmezett értéket a következőhöz subscription: .

# Set your default subscription
az account set --subscription "{subscription-name}"

Foundry-projekt létrehozása

Használja az alábbi módszerek egyikét.

Öntödei portál

Ezekkel a lépésekkel létrehozhat egy új Azure erőforrást alapszintű alapértelmezett beállításokkal.

Foundry-projekt létrehozásához kövesse az alábbi lépéseket:

1. Jelentkezzen be Microsoft Foundry. Győződjön meg arról, hogy a New Foundry kapcsoló be van kapcsolva. Ezek a lépések a Foundryre (új) vonatkoznak.

   

2. A projekt, amelyen dolgozik, a bal felső sarokban jelenik meg.

3. Új projekt létrehozásához jelölje ki a projekt nevét, majd válassza az Új projekt létrehozása lehetőséget.

4. Adjon nevet a projektnek, és válassza a Projekt létrehozása lehetőséget. A speciális beállításokat a következő szakaszban találja.

Speciális beállítások

1. Létrehoz egy Foundry-projektet egy Foundry erőforráson. A portál automatikusan létrehozza ezt az erőforrást a projekt létrehozásakor. Válasszon ki egy használni kívánt meglévő erőforráscsoportot , vagy hagyja meg az alapértelmezett értéket egy új erőforráscsoport létrehozásához.

   Tipp

   Különösen az első lépésekhez hozzon létre egy új erőforráscsoportot a projekthez. Az erőforráscsoport megkönnyíti a projekt és az összes erőforrás együttes kezelését.

2. Válasszon ki egy helyet , vagy használja az alapértelmezett beállítást. A hely az a régió, ahol a projekterőforrások üzemelnek.

3. Válassza a Létrehozás lehetőséget. Láthatja az erőforrás-létrehozás előrehaladását. A projekt a folyamat befejezésekor jön létre.

Python SDK

Foundry-projekt létrehozása:

• Adja hozzá az alábbi kódot egy Foundry-projekt létrehozásához az előfeltételek szakasz változóinak és client kapcsolatának használatával.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Hivatkozások: CognitiveServicesManagementClient.

Azure parancssori felület

1. Hozzon létre egy erőforráscsoportot, vagy használjon egy meglévőt. Például hozzon létre my-foundry-rg a következőben eastus:

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

2. Hozza létre az Foundry-erőforrást. Hozzon létre my-foundry-resource például az my-foundry-rg erőforráscsoportban:

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

   A --allow-project-management jelölő lehetővé teszi a projekt létrehozását ezen az erőforráson belül.

3. Hozzon létre egy egyéni altartományt az erőforráshoz. Az egyéni tartománynévnek globálisan egyedinek kell lennie. Ha my-foundry-resource foglalt, próbáljon egy egyedibb nevet.

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

4. Hozza létre a projektet. Hozzon létre my-foundry-project például a my-foundry-resourcekövetkezőben:

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

5. Ellenőrizze, hogy a projekt létrejött-e:

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

   A kimenet megjeleníti a projekt tulajdonságait, beleértve az erőforrás-azonosítóját is.

Referencia: az cognitiveservices account

Több projekt létrehozása ugyanazon az erőforráson

Hozzon létre több Foundry-projektet egy meglévő Foundry erőforráson, hogy lehetővé tegye a csapatmunkát és a megosztott erőforrás-hozzáférést, beleértve a biztonságot, az üzembe helyezéseket és a csatlakoztatott eszközöket. Ez a beállítás olyan korlátozott Azure előfizetésekben ideális, ahol a fejlesztőknek önkiszolgáló feltárási képességre van szükségük egy előre konfigurált környezet beállításán belül.

Előfordulhat, hogy az öntödei projektek Azure gyermekerőforrásként saját hozzáférés-vezérlést kapnak, de közös beállításokat, például hálózati biztonságot, üzembe helyezéseket és Azure eszközintegrációt osztanak meg a szülőerőforrásból.

Bár még nem minden Foundry-képesség támogatja a projektekben végzett munka rendszerezését, az erőforrás első "alapértelmezett" projektje hatékonyabb. A UX élményekben az "alapértelmezett" címkével, és a kódbeállítások használatakor az "is_default" erőforrástulajdonsággal azonosíthatja.

Funkció	Alapértelmezett projekt	Egyéb projektek
Modellkövetkeztetés	✅	✅
Játszóterek	✅	✅
Ügynökök	✅	✅
Értékelés	✅	✅
Nyomkövetés	✅	✅
Adatkészletek	✅	✅
Indexek	✅	✅
Foundry SDK és API	✅	✅
Tartalomértelmezés	✅	✅
OpenAI SDK és API	✅	Válaszok, fájlok, beszélgetések
OpenAI Batch, Finomhangolás, Tárolt befejezések	✅	-
Nyelv finomhangolása	✅	✅
Beszéd finomhangolása	✅	-
Kapcsolatok	✅	✅

• Projekt hozzáadása egy Foundry-erőforráshoz:

  Öntödei portál

  1. A jobb felső navigációs sávon válassza a Működés lehetőséget.
  2. A bal oldali panelen válassza a Rendszergazda lehetőséget.
  3. Válassza ki azt a szülőerőforrást, amelyhez projektet szeretne hozzáadni.
  4. Válassza a Projekt hozzáadása lehetőséget.

  Python SDK

  Adja hozzá ezt a kódot a szkripthez, hogy új projektet hozzon létre a meglévő erőforráson:

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Azure parancssori felület

  Új projekt hozzáadása a következőhöz my-foundry-resource:

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

• Ha törli az Foundry-erőforrás alapértelmezett projektjét, a következő létrehozott projekt lesz az alapértelmezett projekt.

Projektbeállítások megtekintése

Öntödei portál

A kezdőlapon megjelenik a projekt projektvégpontja és API-kulcsa. Nincs szüksége az API-kulcsra, ha Microsoft Entra ID hitelesítést használ.

Python SDK

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Hivatkozások: CognitiveServicesManagementClient.

Azure parancssori felület

A projekt beállításainak megtekintéséhez használja a az cognitiveservices account project show parancsot. Például:

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

Hozzáférés biztosítása a csapattagok számára

Ha a projektet egy csapat számára hozta létre, adja a csapattagoknak a Foundry User szerepkört, hogy használni tudják a projektet és annak erőforrásait. Ez a szerepkör biztosítja az AI-alkalmazások létrehozásához és teszteléséhez szükséges minimális engedélyeket. A hozzárendelni kívánt egyéb szerepkörökről a Microsoft Foundry Role-alapú hozzáférés-vezérlése című témakörben olvashat.

Fontos

Az Foundry RBAC-szerepköröket nemrég átnevezték. Foundry user, Foundry Owner, Foundry-fióktulajdonos és Foundry Project Manager korábban Azure AI-felhasználónak, Azure AI-tulajdonosnak, Azure AI-fióktulajdonosnak és Azure AI-Project-kezelőnek hívták. Előfordulhat, hogy egyes helyeken továbbra is a korábbi elnevezések jelennek meg, amíg az átnevezés fokozatosan bevezetésre kerül. A szerepkör-azonosítók és az alapvető jogosultságok az átnevezés ellenére változatlanok maradnak.

Fontos

A szerepkör-hozzárendelések elvégzéséhez olyan szerepkörre van szüksége, mint a Tulajdonos a projektben. További információ: Role alapú hozzáférésvezérlés a Microsoft Foundry számára.

Öntödei portál

1. Az Foundry portálon válassza az Üzemeltetés lehetőséget a jobb felső navigációs sávon.
2. A bal oldali panelen válassza a Rendszergazda lehetőséget.
3. Válassza ki a projekt nevét a táblában.
4. Válassza a felhasználó hozzáadása lehetőséget a jobb felső sarokban.
5. Adja meg a csapattag e-mail-címét.
6. Válassza a Hozzáadás lehetőséget.

Ismételje meg ezeket a lépéseket az egyes csapattagok vagy biztonsági csoportok esetében.

Tipp

Ha egyszerre több felhasználót szeretne hozzáadni, használjon Microsoft Entra biztonsági csoportot az egyes e-mail-címek helyett.

Python SDK

A szerepkör-hozzárendelések kezeléséhez használja az Azure CLI vagy a Foundry portált. A Python SDK nem támogatja a szerepkör-hozzárendelési műveleteket.

Azure parancssori felület

1. A projekt erőforrás-azonosítójának lekérése:

   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. Rendelje hozzá a Foundry User szerepkört egy csapattaghoz:

   Fontos

   Az Foundry RBAC-szerepköröket nemrég átnevezték. Foundry user, Foundry Owner, Foundry-fióktulajdonos és Foundry Project Manager korábban Azure AI-felhasználónak, Azure AI-tulajdonosnak, Azure AI-fióktulajdonosnak és Azure AI-Project-kezelőnek hívták. Előfordulhat, hogy egyes helyeken továbbra is a korábbi elnevezések jelennek meg, amíg az átnevezés fokozatosan bevezetésre kerül. A szerepkör-azonosítók és az alapvető jogosultságok az átnevezés ellenére változatlanok maradnak.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

Note

Mivel az Foundry RBAC-szerepköröket nemrég átnevezték, a kódban szereplő szerepkörnév helyett használja a szerepkördefiníció azonosítóját (GUID) az átnevezés során felmerülő problémák elkerülése érdekében:

• Öntödei felhasználó: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• Öntödei tulajdonos: c883944f-8b7b-4483-af10-35834be79c4a
• Foundry-fiók tulajdonosa: e47c6f54-e4a2-4754-9501-8e0985b135e1
• Foundry Project Manager: eadc314b-1a2d-4efa-be10-5d325db5065e

Biztonsági csoport hozzáadása egyéni felhasználó helyett:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Ellenőrizze a szerepkör-hozzárendelést:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Referencia: az szerepkiosztás

Csoporttagok hozzáférésének ellenőrzése

Kérje meg a csapattagot, hogy ellenőrizze a hozzáférését a Microsoft Foundry bejelentkezéssel, és válassza ki a projektet a projektlistából.

Ha a csapattag nem fér hozzá a projekthez, ellenőrizze, hogy a szerepkör-hozzárendelés sikeresen befejeződött-e. Ellenőrizze, hogy a megfelelő e-mail-címet vagy biztonsági csoportazonosítót használta-e. Győződjön meg arról, hogy a csapattag Azure fiókja ugyanabban a Microsoft Entra bérlőben van.

Projektek törlése

Öntödei portál

1. Jelentkezzen be Microsoft Foundry. Győződjön meg arról, hogy a New Foundry kapcsoló be van kapcsolva. Ezek a lépések a Foundryre (új) vonatkoznak.
2. A jobb felső navigációs sávon válassza a Működés lehetőséget.
3. A bal oldali panelen válassza a Rendszergazda lehetőséget.
4. Válassza ki a projektet.
5. A jobb felső sarokban válassza a kuka ikont a projekt törléséhez.

Python SDK

Ez a kód az előfeltételek változóit és client kapcsolatát használja. Egyetlen projekt törlése:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Hivatkozások: CognitiveServicesManagementClient.

Egy Foundry-erőforrás és az összes projekt törlése:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Hivatkozások: CognitiveServicesManagementClient.

Azure parancssori felület

Futtassa a következő parancsot:

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

Hivatkozások: az cognitiveservices account project delete.

Fontos

Óvatosan használja. A projekt törlése után nem állítható helyre.

Az első kapcsolat létrehozása

Kapcsolódó tartalom

• Microsoft Foundry gyorsindítás
• Mi az a Foundry?
• Erőforrások létrehozása Bicep sablonnal