Gehostete Agent-Infrastruktur mit der Azure Developer CLI

Important

Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Wenn Sie azd ai agent init --infra oder azd ai agent init --infra=bicep ausführen, legt die Azure Developer CLI (azd) in Ihrem Projekt ein infra/-Verzeichnis an, das Bicep-Vorlagen enthält. Diese Vorlagen definieren die Azure Ressourcen, die Ihr gehosteter Agent von den in azure.yamldeklarierten Diensten benötigt. Durch das Ausführen von azd provision werden die Vorlagen bereitgestellt, mit denen die Infrastruktur erstellt wird. In diesem Artikel wird erläutert, was diese Vorlagen bereitstellen und wie sie angepasst werden.

Was bereitgestellt wird

Standardmäßig erstellt azd ai agent init keine Infrastructure-as-Code-Dateien. Verwenden Sie --infra oder --infra=bicep, um Bicep-Infrastruktur hinzuzufügen. Verwenden Sie --infra=terraform, um Terraform-Infrastruktur hinzuzufügen und infra.provider: terraform festzulegen.

Wenn Sie Bicep Infrastruktur hinzufügen, basieren die Vorlagen auf dem azd-ai-starter-basic-Repository und erstellen die folgenden Azure Ressourcen:

Resource Purpose
Ressourcengruppe Organisiert alle Ressourcen. Der Name lautet rg-<agent-name>.
AI Services-Konto Das Microsoft Foundry-Konto.
Gießereiprojekt Beherbergt den Agenten und die KI-Funktionen.
Modellimplementierungen Die Modelle, die der Agent verwendet, z. B. gpt-4.1-mini.
Azure Container Registry (Registrierungsdienst für Container von Azure) Speichert die Agent-Container-Images.
Application Insights Agent-Leistungsüberwachung und Telemetrie.
Log Analytics-Arbeitsbereich Zentralisierte Protokollsammlung.
Verwaltete Identität Die vom System zugewiesene Identität des Projekts, die die Agent-Identitätsblaupause bei Microsoft Entra ID authentifiziert und Plattformrollenzuweisungen enthält.

Die Vorlagen erstellen abhängig von den in azure.yaml deklarierten Diensten und Abhängigkeiten weitere Ressourcen:

  • Funktionshost: Unterstützt die Bereitstellung gehosteter Agents im Foundry-Projekt. Erstellt, wenn Sie benutzerdefinierten Speicher von Unterhaltungen benötigen.
  • Grounding with Bing oder Grounding with Bing Custom Search: Für das Websuchtool.
  • Azure KI-Suche – zur Suchfundierung.
  • Azure Storage – für Dateivorgänge.

Projektstruktur

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)

Wie Parameter fließen

Die main.parameters.json-Datei ordnet azd Umgebungsvariablen Bicep-Parametern zu:

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

Während azd provision löst azd diese ${VAR}-Verweise aus der Umgebung (.azure/<env>/.env) auf und übergibt sie an die Bicep-Bereitstellung. Ausgaben aus der Bereitstellung, z. B. der Foundry-Projektendpunkt, der Modellbereitstellungsname und der Containerregistrierungsendpunkt, werden zur Verwendung durch azd deploy, azd ai agent run und die azd ai-Ressourcenbefehle in die Umgebung zurückgeschrieben.

Vorhandene Ressourcen

Die Bicep-Vorlagen unterstützen das Herstellen einer Verbindung mit vorhandenen Azure Ressourcen, anstatt neue zu erstellen. Dies ist nützlich, wenn Ihr Team bereits über eine gemeinsame Infrastruktur verfügt.

Vorhandene Ressource Festzulegende Umgebungsvariablen
AI Services-Konto AZURE_AI_ACCOUNT_NAME
Container Registry AZURE_CONTAINER_REGISTRY_RESOURCE_ID und AZURE_CONTAINER_REGISTRY_ENDPOINT
Application Insights APPLICATIONINSIGHTS_CONNECTION_STRING und APPLICATIONINSIGHTS_RESOURCE_ID

Legen Sie diese Variablen mit azd env set fest, bevor Sie azd provision ausführen.

Anpassen der Infrastruktur

Das Verzeichnis infra/ ist Teil der standardmäßigen azd-Infrastruktur, sodass Sie die volle Kontrolle darüber haben. So fügen Sie Ressourcen hinzu oder ändern sie:

  1. Bearbeiten infra/main.bicep oder Hinzufügen neuer Module unter infra/core/.
  2. Fügen Sie main.parameters.json neue Parameter mit ${VAR}-Bindungen hinzu.
  3. Legen Sie die entsprechenden azd Umgebungsvariablen mit azd env set fest.
  4. Führen Sie azd provision aus, um die Änderungen anzuwenden.

Änderungen an den Bicep-Dateien bleiben über Bereitstellungen hinweg erhalten.

Regionseinschränkungen

Die Vorlage main.bicep beschränkt location auf Regionen, in denen gehostete Agenten unterstützt werden. Wenn Sie in einer Region bereitstellen müssen, die nicht in der Liste der zulässigen Regionen enthalten ist, aktualisieren Sie den @allowed-Decorator in main.bicep.

Verwandte Inhalte

  • Last updated on