Inicializace projektu 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.

Slouží azd ai agent init k vygenerování hostovaného projektu agenta se soubory, které potřebujete k sestavení, otestování a nasazení agenta AI do Microsoft Foundry. V tomto článku zvolíte výchozí bod a inicializujete projekt ze šablony, z vlastního kódu nebo proti existujícímu projektu Foundry.

Předpoklady

  • Rozšíření Azure Developer CLI Foundry byla nainstalována.
  • Autentizovaná relace Azure (azd auth login).
  • Přístup přispěvatele k vašemu předplatnému Azure

Volba výchozího bodu

Projekt můžete zahájit třemi způsoby. Vyberte cestu, která odpovídá vaší situaci.

Consideration Začínáme ze šablony Přineste si vlastní kód Připojení existujícího projektu
Nejvhodnější pro Noví agenti, seznamte se s nástroji. Existující kód agenta, který chcete hostovat v Foundry. Agenti již běží v projektu Foundry.
Command azd ai agent init v prázdném adresáři. azd ai agent init v adresáři s existujícím kódem. azd ai agent inita pak vyberte existující projekt.
Co získáte Kompletní projekt vytvořený ze šablony: jeden azure.yaml, zdrojové soubory agenta ve složce src/<agent-name>/ a soubor Dockerfile pro nasazení do kontejneru. Infrastruktura je ve výchozím nastavení bez bicep a lze ji později vysunout. Vygenerovaná azure.yaml položka služby a pro nasazení kontejneru soubor Dockerfile, který zabalí váš kód. Infrastruktura je ve výchozím nastavení bez bicep a lze ji později vysunout. azure.yaml, připojené k vašemu stávajícímu projektu Foundry. Infrastruktura je ve výchozím nastavení bez bicep a lze ji později vysunout.
Změny kódu Žádné. Připraveno ke spuštění. Možná bude potřebovat adaptér protokolu. Žádné.

Inicializovat ze šablony

Spusťte interaktivního průvodce v prázdném adresáři a vyberte Spustit nový ze šablony:

azd ai agent init

Průvodce vás provede následujícími volbami.

Výzva Description
Šablona agenta Vyberte si ze šablon uspořádaných podle architektury a jazyka (Python nebo .NET).
předplatné Azure Předplatné použité k vyhledání nebo vytvoření projektu Foundry.
Projekt slévárny Vyberte existující projekt nebo vytvořte nový. Pokud ho vytvoříte, zvolíte také oblast.
Nasazení modelu Vyberte existující nasazení modelu, nebo bude vytvořeno podle výchozí šablony.

Název agenta pochází ze šablony. CLI vytvoří prostředí azd s názvem <directory>-dev a nakonfiguruje ho pomocí údajů z vybraného projektu Foundry. Každá šablona obsahuje zdrojový kód agenta, Dockerfilesoubor a azure.yaml soubor, který funguje jako jednotný manifest projektu pro azd konfiguraci agenta a hostovaného agenta.

Inicializovat z adresy URL azure.yaml

Pokud máte konkrétní ukázku agenta, nasměrujte -m na azure.yaml dané ukázky. CLI použije tento soubor jako manifest projektu a stáhne zdrojový kód agenta uvedený v něm.

azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

Note

Manifesty agentů (agent.manifest.yaml) a samostatné definice agenta (agent.yaml) jsou zastaralé. Od verze rozšíření Foundry azd (azure.ai.agents 1.0.0-beta.1) je veškerá konfigurace hostovaného agenta uložena v jednom azure.yaml. Viz Vytvoření souboru azure.yaml pro hostované agenty.

Možnost -m stále přijímá starší verzi adresy URL manifestu agenta, ale aktuální ukázky publikují sjednocenou azure.yaml.

Určení modelu

Zvolte model v době inicializaci:

azd ai agent init --model gpt-4.1

Nebo v projektu Foundry použijte existující nasazení modelu:

azd ai agent init --model-deployment my-deployment

Volba režimu nasazení

Ve výchozím nastavení azd ai agent init využívá nasazení kódu pro projekty v Pythonu a .NET. Nasazení kódu nahraje váš zdrojový kód ve formě balíčku ZIP. Pokud chcete místo toho vygenerovat projekt založený na kontejneru, předejte --deploy-mode container:

azd ai agent init --deploy-mode container

Chcete-li nasadit předem sestavenou image kontejneru, předejte --image a --agent-name. Tato možnost přeskočí výběr šablony a jazyka, generování kódu, generování souboru Dockerfile a nastavení Azure Container Registry.

azd ai agent init --agent-name my-agent --image myregistry.azurecr.io/my-agent:v1

Procházení šablon neinteraktivně

Chcete-li katalog zkontrolovat předtím, než vygenerujete kostru, nebo ovládat azd ai agent init ze skriptu, vypište katalog:

# Everything in the catalog
azd ai agent sample list

# Just the featured Python agent samples
azd ai agent sample list --featured-only --language python --type agent

# Full azd templates only, as JSON for scripting
azd ai agent sample list --type azd --output json

Každá položka obsahuje příkaz initCommand, připravený ke spuštění, který zkopírujete a spustíte v adresáři, ve kterém chcete vygenerovat kostru projektu.

Tip

Když znovu použijete ukázku s jinou identitou agenta Foundry, předejte na --agent-name <new-name> parametr azd ai agent init, aby název zapsaný do azure.yaml nekolidoval s výchozím názvem ukázky.

Inicializace z existujícího kódu

Pokud máte existující kód agenta Python nebo .NET, spusťte azd ai agent init ho v adresáři, který už obsahuje váš kód:

cd my-agent/
azd ai agent init

CLI rozpozná existující soubory a vygeneruje kolem nich položku služby azure.yaml, aniž by přepsalo váš kód. Pro nasazení kontejneru přidá také soubor Dockerfile. Infrastruktura ve výchozím nastavení zůstává bez použití Bicepu, pokud ji později nevyvedete do podoby infrastruktury jako kódu.

Váš kód agenta musí splňovat hostovaný kontrakt modulu runtime agenta:

  • Poslouchejte na portu 8088.
  • Poskytuje kontrolu stavu na adrese GET /readiness.
  • Zpracujte jeden z podporovaných protokolů (responses nebo invocations).

Pokud váš kód ještě nepodporuje žádný z těchto protokolů, přidejte adaptér protokolu, odlehčené SDK rozhraní, které překládá mezi protokolem Foundry a logikou vašeho agenta.

Pokud chcete přidat agenta do existujícího azd projektu, init zjistí projekt a přidá do existujícího azure.yamlobjektu novou položku služby . Slouží --src k zadání podadresáře:

azd ai agent init --src src/my-agent

Připojení k existujícímu projektu Foundry

Pokud chcete spravovat existující projekt Foundry prostřednictvím azd, spusťte průvodce a vyberte možnost připojení k existujícímu projektu. Interaktivní výběr můžete také přeskočit tak, že přímo poskytnete ID zdroje Azure projektu:

azd ai agent init --project-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}

ID projektu najdete tak, že otevřete portál Foundry, přejdete na Správce provozu>, vyberete projekt Foundry a zkopírujete hodnotu ID zdroje .

Výstraha

Když inicializujete s použitím existujícího projektu pomocí --project-id, nástroj přeskočí automatická přiřazení rolí, která provádí při vytváření nového projektu. Ujistěte se, že už jsou přiřazené požadované role. Kompletní matici najdete v referenčních informacích k oprávněním hostovaného agenta.

Zkontrolujte, co se vytvoří

Po init dokončení adresář projektu obsahuje následující strukturu:

.
|-- azure.yaml                  # Unified azd project and hosted agent configuration
|-- src/
|   \-- <agent-name>/
|       |-- Dockerfile          # Container build definition
|       \-- ...                 # Agent source code
|-- .azure/                     # Environment configuration
\-- infra/                      # Optional IaC, created only after you eject infrastructure

Šablony a ukázky publikují v kořenovém adresáři projektu jednotný azure.yaml. Během inicializaci azd tento soubor přijme nebo vygeneruje. Odteď budete pracovat s azure.yaml. Infrastruktura je ve výchozím nastavení bez bicep. Infrastrukturu vysuňte jenom v případě, že potřebujete spravovat vygenerované soubory IaC přímo.

Související obsah

  • Last updated on