Infrastruktura hostovaného agenta pomocí rozhraní příkazového řádku pro vývojáře Azure

Important

Položky označené (Preview) v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Při spuštění azd ai agent init --infra nebo azd ai agent init --infra=bicep nástroj Azure Developer CLI (azd) vygeneruje ve vašem projektu adresář infra/, který obsahuje šablony Bicep. Tyto šablony definují Azure prostředky, které hostovaný agent potřebuje ze služeb deklarovaných v azure.yaml. Spuštěním azd provision se nasadí šablony pro vytvoření infrastruktury. Tento článek vysvětluje, co tyto šablony nasazují a jak je přizpůsobit.

Co se zřídí

Ve výchozím nastavení azd ai agent init nevytvoří soubory infrastruktury jako kódu. Použijte --infra nebo --infra=bicep k přidání infrastruktury Bicep. Pomocí --infra=terraform přidejte infrastrukturu Terraform a nastavte infra.provider: terraform.

Když přidáte infrastrukturu Bicep, šablony jsou založené na úložišti azd-ai-starter-basic a vytvoří následující prostředky Azure:

Resource Purpose
Skupina zdrojů Uspořádá všechny prostředky. Pojmenovaný rg-<agent-name>.
Účet AI Services Účet Microsoft Foundry.
Projekt slévárny Zajišťuje hostování agenta a funkcí umělé inteligence.
Nasazení modelů Modely, které agent používá, například gpt-4.1-mini.
Azure Container Registry Ukládá obrazy kontejneru agenta.
Application Insights Monitorování výkonu agenta a telemetrie
pracovní prostor služby Log Analytics Centralizované shromažďování protokolů.
Spravovaná identita Systémem přiřazená identita projektu, která ověřuje plán identity agenta u Microsoft Entra ID a uchovává přiřazení rolí platformy.

Šablony vytvářejí více prostředků podmíněně na základě služeb a závislostí deklarovaných v azure.yaml:

  • Hostitel schopností – podporuje nasazení hostovaného agenta v projektu Foundry. Vytvořeno, když potřebujete vlastní úložiště konverzací.
  • Ukotvení pomocí Bingu nebo ukotvení pomocí vlastního vyhledávání Bing – pro nástroj webového vyhledávání.
  • Azure AI Vyhledávač – pro ukotvení vyhledávání.
  • Azure Storage – pro operace se soubory.

Struktura projektu

infra/
|-- main.bicep                 # Main deployment template (subscription-scoped)
|-- main.parameters.json       # Parameter bindings to azd environment variables
|-- abbreviations.json         # Naming convention abbreviations
\-- core/
    |-- ai/                    # Foundry account, project, and connections
    |-- host/                  # Container registry
    |-- monitor/               # Application Insights and Log Analytics
    |-- search/                # Azure AI Search (conditional)
    \-- storage/               # Azure Storage (conditional)

Jak tok parametrů

Soubor main.parameters.json mapuje azd proměnné prostředí na parametry Bicep:

{
  "environmentName": { "value": "${AZURE_ENV_NAME}" },
  "location": { "value": "${AZURE_LOCATION}" },
  "aiFoundryResourceName": { "value": "${AZURE_AI_ACCOUNT_NAME}" },
  "aiProjectDeploymentsJson": { "value": "${AI_PROJECT_DEPLOYMENTS=[]}" }
}

Během azd provisiontéto azd operace azd vyhodnocuje tyto .azure/<env>/.env odkazy z prostředí () a předává je nasazení Bicep. Výstupy z nasazení, jako jsou koncový bod projektu Foundry, název nasazení modelu a koncový bod registru kontejnerů, se zapisují zpět do prostředí, aby je bylo možné použít pomocí příkazů prostředku azd deploy, azd ai agent run a azd ai.

Existující prostředky

Šablony Bicep podporují připojení k existujícím prostředkům Azure místo vytváření nových prostředků. To je užitečné, když už má váš tým sdílenou infrastrukturu.

Existující prostředek Proměnné prostředí, které se mají nastavit
Účet AI Services AZURE_AI_ACCOUNT_NAME
Container Registry AZURE_CONTAINER_REGISTRY_RESOURCE_ID a AZURE_CONTAINER_REGISTRY_ENDPOINT
Application Insights APPLICATIONINSIGHTS_CONNECTION_STRING a APPLICATIONINSIGHTS_RESOURCE_ID

Nastavte tyto proměnné pomocí azd env set před spuštěním azd provision.

Přizpůsobení infrastruktury

Adresář infra/ je standardní azd infrastruktura, takže nad ním máte úplnou kontrolu. Přidání nebo změna prostředků:

  1. Upravte infra/main.bicep nebo přidejte nové moduly v části infra/core/.
  2. Přidejte nové parametry do main.parameters.json pomocí vazeb ${VAR}.
  3. Nastavte odpovídající azd proměnné prostředí pomocí azd env set.
  4. Spusťte azd provision , aby se změny použily.

Změny v souborech Bicep se zachovají mezi jednotlivými nasazeními.

Omezení oblastí

Šablona main.bicep omezuje location oblasti, ve kterých se podporují hostovaní agenti. Pokud potřebujete nasadit do regionu, který není v seznamu povolených regionů, aktualizujte dekorátor @allowed v souboru main.bicep.

Související obsah

  • Last updated on