Wdróż modele Claude'a w Microsoft Foundry za pomocą Bicep lub Terraform

Zestaw startowy Claude on Foundry ułatwia wdrażanie modeli Anthropic Claude w usłudze Microsoft Foundry przy użyciu interfejsu wiersza polecenia dewelopera Azure (azd). Ułatwia również konfigurowanie uwierzytelniania lokalnego i wywoływanie wdrożonego modelu z poziomu programu Claude Code lub Python.

W tym artykule dowiesz się, jak:

  • Wdróż Claude Sonnet w usłudze Microsoft Foundry, używając wariantu Bicep zestawu startowego.
  • Skonfiguruj wymagane wartości poświadczenia dostawcy modelu Anthropic.
  • Skonfiguruj kod Claude'a, aby używał modelu hostowanego w programie Foundry.
  • Wywołaj wdrożony model Claude'a z Python przy użyciu Microsoft Entra ID.
  • Dostosuj wdrożenie dla Terraform pod kątem większej liczby rodzin modeli, innych regionów lub innej wydajności.

Ważna

Uruchomienie azd up przy użyciu tego zestawu startowego oznacza akceptację warunków Anthropic Marketplace i wysyłanie wartości poświadczenia CLAUDE_ORGANIZATION_NAME, CLAUDE_COUNTRY_CODE i CLAUDE_INDUSTRY w żądaniach. Ustaw wartości opisujące rzeczywistą organizację przy użyciu modelu. Aby uzyskać szczegółowe informacje, zobacz Warunki użytkowania.

Szybki start

Ta "szczęśliwa ścieżka" wdraża Claude'a Sonneta przy użyciu Bicep w eastus2 pojemności 25 (25 000 tokenów na minutę). Najpierw użyj tego, aby uzyskać działające wdrożenie, a następnie przejdź do Dostosowywanie wdrożenia, jeśli potrzebujesz Terraform, wielu rodzin modeli, innego regionu lub innej wydajności.

Potrzebujesz subskrypcji platformy Azure uprawniającej do korzystania z Anthropic Claude w Microsoft Foundry, uprawnień do tworzenia zasobów docelowych, narzędzi Azure CLI, Azure Developer CLI i Git oraz języka Python 3.10 lub nowszego. Jeśli Twoje konto może tworzyć przypisania ról, przewodnik Szybki start przyznaje również użytkownikowi dostęp do wywoływania modelu, dzięki czemu przykłady można uruchomić od razu.

Klonowanie, konfigurowanie i wdrażanie

Jeśli Twoja subskrypcja uprawniająca do korzystania z Claude znajduje się w dzierżawie innej niż domyślna, dodaj identyfikator dzierżawy do obu poleceń logowania.

git clone https://github.com/Azure-Samples/claude.git
cd claude\infra-bicep

az login
azd auth login

azd env new my-claude
azd env set CLAUDE_ORGANIZATION_NAME "Contoso"
azd env set CLAUDE_COUNTRY_CODE "US"
azd env set CLAUDE_INDUSTRY "technology"
azd env set AZURE_LOCATION "eastus2"
azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"
azd env set CLAUDE_SONNET_CAPACITY 25
azd env set ASSIGN_RBAC true

azd up

Zastąp Contoso, US i technology wartościami dla rzeczywistej organizacji za pomocą Claude. Jeśli Twoje konto nie może tworzyć przypisań ról, pomiń ASSIGN_RBAC i przed uruchomieniem przykładów poproś administratora o nadanie uprawnień dostępu do wywoływania modelu.

Weryfikowanie i uruchamianie programu Claude Code

W katalogu głównym repozytorium sprawdź wygenerowaną konfigurację i stan wdrożenia. Flaga pomijania pozwala uniknąć połączenia na żywo Claude'a podczas weryfikacji.

cd ..
pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall -WaitForDeployment

. .\claude-code.env.ps1
claude

Uruchamianie przykładu Python

azd Zapisz wyniki do pliku .env.local, zainstaluj zależności i uruchom przykład jednorazowego uruchomienia z usługą Microsoft Entra ID.

cd infra-bicep
azd env get-values | Out-File -Encoding utf8 ..\.env.local
cd ..
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python src\hello_claude.py

Jak zestaw startowy pomaga

Pakiet startowy automatyzuje wdrażanie Claude'a za pomocą Bicep lub Terraform. Konfiguruje uwierzytelnianie lokalne dla Microsoft Entra ID i udostępnia działające przykłady Claude Code i Python. Obejmuje również kontrole wstępne pod kątem typowych problemów z usługą Marketplace, regionem i limitami przydziału, dzięki czemu można usunąć blokery przed rozpoczęciem aprowizacji. Aby uzyskać więcej informacji, zobacz Co tworzy wdrożenie i dostosowywanie wdrożenia.

Prerequisites

  • Subskrypcja Azure, która kwalifikuje się do wdrażania modeli Anthropic Claude w usłudze Microsoft Foundry. Dostępność modelu Claude'a zależy od typu subskrypcji, stanu rozliczeń, regionu i Anthropic obsługiwanych regionów.
  • Uprawnienia do tworzenia zasobów Azure docelowych i zarządzania nimi. Zazwyczaj potrzebujesz Contributor lub Owner w subskrypcji lub docelowej grupie zasobów.
  • Dostęp do Azure Marketplace dla ofert modeli partnerskich.
  • Azure CLI.
  • Azure Developer CLI
  • Git.
  • Python 3.10 lub nowszy dla przykładów Python.
  • Terraform 1.6 lub nowszy, jeśli wybierzesz wariant Terraform.

Tip

Repozytorium obsługuje również GitHub Codespaces i VS Code Dev Containers. Te środowiska zawierają wymagane narzędzia deweloperskie, więc są dobrym wyborem, jeśli nie chcesz instalować lokalnie az, azd i języka Python.

Co tworzy wdrożenie

Zestaw startowy tworzy te zasoby i lokalne pliki konfiguracji:

  • Grupa zasobów Azure dla azd środowiska.
  • Konto Microsoft Foundry.
  • Projekt Microsoft Foundry.
  • Co najmniej jeden wdrożony model Claude na koncie Foundry.
  • Opcjonalne przypisanie roli dla wywołania modelu.
  • Lokalne skrypty aktywujące Claude Code w katalogu głównym repozytorium.
  • Konfiguracja obszaru roboczego Claude, która przypisuje Claude Code do wdrożonej rodziny modeli.
  • Opcjonalne ustawienia rozszerzenia VS Code przy ustawianiu CLAUDE_WRITE_VSCODE_SETTINGS=true.
  • azd wartości wyjściowe środowiska, w tym nazwa konta Foundry, podstawowy adres URL, punkt końcowy projektu i nazwy wdrożeń.

Dostosowywanie wdrożenia

Użyj tej sekcji, jeśli chcesz zmienić ścieżkę szybkiego startu, na przykład przy użyciu narzędzia Terraform, wybrać inny region, wdrożyć wiele rodzin Claude'a lub zmienić pojemność. Jeśli masz już za sobą przewodnik Szybki start, możesz przejść od razu do sekcji Korzystanie z Claude Code z wdrożonym modelem lub Wywoływanie Claude z poziomu języka Python.

Klonowanie zestawu startowego

Sklonuj zestaw startowy i przejdź do repozytorium:

git clone https://github.com/Azure-Samples/claude.git
cd claude

Opcjonalnie sprawdź katalog modeli Claude na żywo, zanim wybierzesz identyfikatory modeli. To narzędzie pomocnicze w pakiecie startowym jest dostępne wyłącznie dla programu PowerShell.

pwsh -File .\Get-ClaudeCatalog.ps1 -Latest

Wykaz zmienia się w czasie. Użyj danych wyjściowych skryptu, aby potwierdzić, które identyfikatory modeli Claude'a są dostępne w regionie, w którym planujesz wdrożyć.

Wybieranie wariantu infrastruktury

Zestaw startowy zawiera dwa równoważne warianty infrastruktury:

Variant Folder Użyj, gdy
Bicep infra-bicep Preferujesz natywną dla platformy Azure infrastrukturę definiowaną jako kod.
Terraform infra-terraform Wolisz program Terraform i już używasz przepływów pracy programu Terraform.

Zmień na jeden z folderów wariantów:

cd infra-bicep

Lub:

cd infra-terraform

Pozostałe polecenia w tym artykule są uruchamiane z wybranego folderu wariantu.

Zaloguj się do Azure

Zaloguj się przy użyciu zarówno interfejsu wiersza polecenia platformy Azure (Azure CLI), jak i interfejsu wiersza polecenia dewelopera platformy Azure (Azure Developer CLI):

az login
azd auth login

Jeśli Twoja subskrypcja uprawniająca do korzystania z Claude znajduje się w dzierżawie innej niż domyślna, podaj dzierżawę:

az login --tenant <tenant-id>
azd auth login --tenant-id <tenant-id>

Utwórz środowisko azd

azd Utwórz środowisko do przechowywania konfiguracji wdrożenia:

azd env new my-claude

Jeśli środowisko zostało już utworzone, wybierz je zamiast tego:

azd env select my-claude

Konfigurowanie wymaganych wartości wdrożenia

Ustaw wartości organizacji używane do poświadczenia dostawcy modelu Claude:

azd env set CLAUDE_ORGANIZATION_NAME "Contoso"
azd env set CLAUDE_COUNTRY_CODE "US"
azd env set CLAUDE_INDUSTRY "technology"

Zastąp przykładowe wartości nazwą jednostki prawnej organizacji, dwuliterowym kodem kraju i branżą. Pakiet startowy zawiera domyślne wartości kraju i branży, ale zastąp je, chyba że US i technology dokładnie opisują organizację korzystającą z Claude’a.

Wartość branżowa musi mieć małe litery. Obsługiwane wartości to:

  • technology
  • finance
  • healthcare
  • education
  • retail
  • manufacturing
  • government
  • media
  • other

Ustaw region Azure:

azd env set AZURE_LOCATION "eastus2"

Zestaw startowy obsługuje regiony, w których są dostępne wybrane modele Claude'a. Przewodnik Szybki start używa elementu eastus2. W przypadku typowego wdrożenia całej rodziny eastus2 i swedencentral obsługują obecnie Haiku, Sonnet i Opus. westus2 obsługuje Sonnet i Opus. Dostępność może ulec zmianie, więc użyj skryptu wykazu na żywo, jeśli nie masz pewności, które rodziny modeli są dostępne w twoim regionie docelowym.

Wdróż więcej rodzin modeli lub zmień wydajność

W przypadku pierwszego, prostego wdrożenia wdróż tylko Sonnet, używając preferowanej zmiennej dla danej rodziny:

azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"

Aby wdrożyć wiele rodzin modeli na tym samym koncie usługi Foundry, ustaw co najmniej jedną zmienną rodzinną:

azd env set CLAUDE_HAIKU_MODEL "claude-haiku-4-5"
azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"
azd env set CLAUDE_OPUS_MODEL "<opus-model-id-from-catalog>"

Każda niepusta zmienna rodzinna tworzy oddzielne wdrożenie. Pozostaw rodzinę niezastawioną, aby ją pominąć. Starsze CLAUDE_MODEL_NAME ustawienie to starsza wersja rezerwowa pojedynczego wdrożenia i jest używana tylko wtedy, gdy CLAUDE_HAIKU_MODEL, CLAUDE_SONNET_MODELi CLAUDE_OPUS_MODEL są puste.

Przewodnik QuickStart ustawia przepustowość Sonnet na 25. Aby zastąpić pojemność dla dowolnej wdrożonej rodziny, ustaw zgodną zmienną pojemności:

azd env set CLAUDE_SONNET_CAPACITY 25

Wartości pojemności są mierzone w tysiącach tokenów na minutę. Na przykład 25 wymaga 25 000 TPM.

Konfigurowanie dostępu do wywołania modelu

Aby przykłady usługi Microsoft Entra ID działały natychmiast po wdrożeniu, ustaw ASSIGN_RBAC=true przed azd up. Szablon przypisuje rolę o najniższych uprawnieniach Cognitive Services User na koncie usługi Foundry do głównego identyfikatora, który azd dostarcza za pośrednictwem AZURE_PRINCIPAL_IDmetody , więc zwykle nie trzeba szukać własnego identyfikatora obiektu.

azd env set ASSIGN_RBAC true

Ustaw AZURE_PRINCIPAL_ID ręcznie tylko wtedy, gdy musisz udzielić dostępu do innego użytkownika lub jednostki usługi:

azd env set AZURE_PRINCIPAL_ID "<object-id>"
azd env set ASSIGN_RBAC true

Jeśli nie włączysz tej opcji, nadal możesz wdrożyć zasoby. Jednak przed tym, jak przykłady Microsoft Entra ID będą mogły wywołać model, Ty lub administrator musicie nadać uprawnienia do wywoływania modelu.

Zestaw startowy przypisuje Cognitive Services User, ponieważ jest to rola z najmniejszym zakresem uprawnień do bezkluczowego wywoływania modelu. Jeśli planujesz później dodać szersze funkcje projektu Foundry, takie jak agenci lub ewaluatorzy, możesz udzielić szerszych ról płaszczyzny danych, takich jak Foundry User lub Azure AI Developer oddzielnie.

Wdrażanie za pomocą polecenia azd up

Uruchom wdrożenie:

azd up

Polecenie azd up wykonuje następujące zadania:

  1. Uruchamia kontrolę wstępną wymaganych ustawień, dostępności katalogu Marketplace oraz dostępnego zapasu limitu przydziału.
  2. Tworzy grupę zasobów Azure.
  3. Tworzy konto i projekt Microsoft Foundry.
  4. Wdraża wybrane rodziny modeli Claude'a.
  5. Opcjonalnie przypisuje rolę wywołania modelu.
  6. Zapisuje wartości wyjściowe, takie jak CLAUDE_BASE_URL, CLAUDE_DEPLOYMENT_NAME i nazwy wdrożeń dla każdej rodziny.
  7. Uruchamia hak postprovision, aby skonfigurować pliki aktywatora Claude Code.

Wdrożenie może potrwać kilka minut. Wdrożenia modelu mogą również kontynuować aprowizację po powrocie limitu czasu operacji wdrażania usługi ARM. W takim przypadku użyj skryptu weryfikacyjnego w następnej sekcji, aby sprawdzić rzeczywisty stan wdrożenia przed ponownym uruchomieniem polecenia azd up.

Weryfikowanie wdrożenia

W katalogu głównym repozytorium uruchom skrypt weryfikacyjny:

cd ..
pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall

Aby poczekać na wdrożenia modeli, które są nadal aprowizowane, dodaj flagę wait:

pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall -WaitForDeployment

Aby uwzględnić pełny przebieg Claude Code na żywo, pomiń flagę --skip:

pwsh -File .\scripts\verify-claude-code.ps1

Skrypt weryfikacyjny sprawdza wygenerowany aktywator, oczekiwane zmienne środowiskowe, logowanie do Azure CLI, widoczny zasób usługi Foundry, stany wdrożeń modeli oraz dostępność narzędzia wiersza polecenia Claude Code.

Używanie programu Claude Code z wdrożonym modelem

Korzystanie z interfejsu wiersza polecenia programu Claude Code

Domyślnie pakiet startowy zapisuje skrypty aktywacyjne dla projektu oraz konfigurację przestrzeni roboczej Claude w katalogu głównym repozytorium:

  • claude-code.env.ps1 dla programu PowerShell.
  • claude-code.env.sh dla powłoki Bash, macOS, Linux, Git Bash lub WSL.
  • Konfiguracja obszaru roboczego Claude'a w celu przypinania kodu Claude'a do wdrożonej rodziny modeli.
. .\claude-code.env.ps1
claude

Aktywator konfiguruje program Claude Code do używania Microsoft Foundry i ustawia nazwy wdrożeń dla wdrożonych rodzin modeli. Dla każdej wdrożonej rodziny hook postprovision zapisuje wartość ANTHROPIC_DEFAULT_<FAMILY>_MODEL do aktywatora, aby Claude Code mógł kierować żądania do Haiku, Sonnet lub Opus, gdy takie wdrożenia są dostępne. Konfiguracja obszaru roboczego Claude przypina domyślne ustawienie obszaru roboczego do wdrożonej rodziny, dlatego claude wskazuje model, który istnieje na Twoim koncie Foundry.

Jeśli polecenie claude nie jest zainstalowane, hak postprovision wyświetla polecenie instalacji dla Twojej platformy. Aby zestaw startowy automatycznie zainstalował Claude Code podczas aprowizacji, ustaw tę wartość przed uruchomieniem polecenia azd up:

azd env set CLAUDE_CODE_AUTO_INSTALL true

Opcjonalne: konfigurowanie rozszerzenia programu VS Code

Zestaw startowy nie zapisuje .vscode/settings.json domyślnie. Jeśli używasz rozszerzenia Claude Code do VS Code i chcesz, aby pakiet startowy je skonfigurował, zdecyduj się na to przed azd up:

azd env set CLAUDE_WRITE_VSCODE_SETTINGS true

Po włączeniu tej opcji hak postprovision zapisuje lub scala elementy claudeCode.environmentVariables i claudeCode.disableLoginPrompt w .vscode/settings.json, tak aby rozszerzenie używało wdrożenia Foundry zamiast wyświetlać monit o zalogowanie do konta Anthropic.

Zadzwoń do Claude'a z Python

Repozytorium zawiera przykłady Python w obszarze src. Użyj ich do testowania dostępu typu aplikacyjnego za pomocą zestawu SDK Anthropic i usługi Microsoft Entra ID.

Z katalogu głównego repozytorium przejdź z powrotem do folderu wariantu infrastruktury i zapisz dane wyjściowe azd do .env.local w katalogu głównym repozytorium:

cd infra-bicep # or: cd infra-terraform
azd env get-values | Out-File -Encoding utf8 ..\.env.local

Następnie utwórz środowisko wirtualne i zainstaluj zależności:

cd ..
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Uruchom przykład jednorazowy:

python src\hello_claude.py

Przykład ładuje CLAUDE_BASE_URL i CLAUDE_DEPLOYMENT_NAME, pobiera token Microsoft Entra ID dla https://ai.azure.com/.default, tworzy klienta Anthropic przy użyciu bazowego adresu URL usługi Foundry i wysyła żądanie do interfejsu Messages API.

Możesz również wypróbować warianty przesyłania strumieniowego i długotrwałego.

python src\chat_stream.py
python src\hello_claude_token_refresh.py

Użyj przykładu odświeżania tokenu dla usług, demonów, notatników lub innych procesów, które mogą działać dłużej niż okres ważności pojedynczego tokenu Microsoft Entra ID.

Zaawansowane: testowanie przy użyciu klucza interfejsu API

Użyj Microsoft Entra ID w normalnych scenariuszach tworzenia i produkcji. Do szybkich testów lokalnych repozytorium zawiera także przykład użycia klucza API.

Z głównego katalogu repozytorium przejdź do katalogu wariantu infrastruktury i pobierz nazwę konta Foundry oraz nazwę grupy zasobów:

cd infra-bicep # or: cd infra-terraform
azd env get-values

Użyj wartości FOUNDRY_ACCOUNT_NAME i AZURE_RESOURCE_GROUP z danych wyjściowych, aby ustawić CLAUDE_API_KEY. Następnie uruchom przykład API-key z katalogu głównego repozytorium:

$env:CLAUDE_API_KEY = (az cognitiveservices account keys list `
  --name "<foundry-account-name>" `
  --resource-group "<resource-group-name>" `
  --query key1 -o tsv)

cd ..
python src\hello_claude_apikey.py

Klucze interfejsu API są przydatne do szybkiego sprawdzania łączności, ale nie zapewniają tych samych korzyści dotyczących kontroli dostępu poszczególnych użytkowników i cyklu życia poświadczeń co Microsoft Entra ID.

Warunki użytkowania

Warianty Bicep i Terraform wysyłają blok modelProviderData przy każdym wdrożeniu Claude. Ten blok zawiera organizationName, countryCode i industry. Dostawca zasobów usługi Cognitive Services używa tych wartości, aby w Twoim imieniu zaakceptować ofertę Azure Marketplace dotyczącą usługi Anthropic Claude, dlatego podczas azd up nie jest wymagane oddzielne ręczne potwierdzenie.

Przed wdrożeniem:

  1. Zapoznaj się z dokumentami prawnymi regulującymi korzystanie z Claude za pośrednictwem Microsoft Foundry:
  2. Ustaw wartości zaświadczania, aby dokładnie opisać organizację:
    • CLAUDE_ORGANIZATION_NAME: nazwa jednostki prawnej. Ta wartość jest wymagana i nie ma wartości domyślnej.
    • CLAUDE_COUNTRY_CODE: dwuliterowy kod kraju. Domyślnym zestawem startowym jest US.
    • CLAUDE_INDUSTRY: branża organizacji. Domyślny zestaw startowy to technology.
  3. Upewnij się, że twoja subskrypcja Azure kwalifikuje się do wdrażania modeli Anthropic Claude w usłudze Microsoft Foundry.

Jeśli wartości domyślne dla kraju lub branży nie opisują dokładnie organizacji korzystającej z claude'a, przesłoń je przed wdrożeniem.

Wyświetl podgląd okna dialogowego wyświetlanego przez Foundry na ścieżce ręcznej i zaakceptuj audyt po azd up

Okno dialogowe „Zgadzam się i przechodzę dalej” w portalu Azure dla oferty SKU Claude jest generowane na podstawie aktualnych metadanych oferty w usłudze Marketplace. Ponieważ treść oferty w Marketplace może się zmieniać, użyj bieżącej oferty dla SKU, które zamierzasz wdrożyć, zamiast polegać na skopiowanej migawce.

Po azd up możesz sprawdzić metadane zaakceptowanej umowy Marketplace za pomocą interfejsu wiersza polecenia platformy Azure. Polecenie zwraca metadane, takie jak zaakceptowany stan, podpis, data i link tekstowy licencji. Nie zwraca pełnego tekstu okna dialogowego portalu.

az term show `
  --publisher anthropic `
  --product anthropic-claude-sonnet-4-6-offer `
  --plan <plan-name>

W przypadku innych kodów SKU Claude zastąp wartość --product odpowiednią ofertą w Marketplace. Użyj nazwy planu z metadanych aktywnej oferty lub z weryfikacji w katalogu pakietów startowych.

Troubleshooting

Więcej takich przypadków znajdziesz w sekcji rozwiązywania problemów z zestawem startowym.

Problem Czego spróbować?
Blokady kwalifikowalności subskrypcji lub oferty azd up Sprawdź, czy Twoja subskrypcja i konto rozliczeniowe są uprawnione do korzystania z modeli Claude'a w usłudze Microsoft Foundry. Jeśli Twoja organizacja wymaga jawnej akceptacji w Marketplace, przed ponownym uruchomieniem azd up zaakceptuj odpowiednią ofertę Anthropic.
Region nie jest dostępny dla wybranego modelu Użyj regionu, w którym jest dostępna wybrana rodzina Claude'a. QuickStart korzysta z eastus2; swedencentral również często obsługuje Haiku, Sonnet i Opus, a westus2 obsługuje Sonnet i Opus. Dostępność może ulec zmianie, więc uruchom polecenie pwsh -File .\Get-ClaudeCatalog.ps1 -Latest z katalogu głównego repozytorium, jeśli nie masz pewności.
Limit jest za niski lub wydaje się wyczerpany mimo braku aktywnych wdrożeń Obniż odpowiadającą wartość CLAUDE_*_CAPACITY, usuń nieużywane wdrożenia lub poproś o zwiększenie limitu. Konta Foundry lub AIServices usunięte nietrwale mogą rezerwować limit TPM przez maksymalnie 48 godzin; wyświetl ich listę za pomocą az cognitiveservices account list-deleted -o table i usuń trwale konta, których już nie potrzebujesz.
Terraform kończy się niejasnym błędem 715-123420 Traktuj to jako prawdopodobne niepowodzenie z powodu przekroczenia limitu przydziału, w tym limitu zajmowanego przez konta oznaczone jako usunięte. Uruchom kontrole wstępne zestawu startowego, sprawdź dostępny zapas limitu przydziału, zmniejsz pojemność lub spróbuj ponownie z wariantem Bicep, aby wyświetlić bardziej zrozumiały komunikat InsufficientQuota.
Kod Claude'a lub Python zwraca wartość 401 lub 403 Uruchom polecenie az login, upewnij się, że jesteś zalogowany(-a) do dzierżawcy będącego właścicielem zasobu Foundry, i sprawdź, czy podmiot wywołujący ma uprawnienia do wywoływania modelu, na przykład Cognitive Services User. Propagacja nowych przypisań RBAC może potrwać kilka minut.
GatewayTimeout pojawia się podczas wdrażania modelu Wdrażanie modelu może trwać nadal po przekroczeniu limitu czasu operacji ARM. Przed ponownym uruchomieniem azd up, uruchom skrypt weryfikacyjny przy użyciu -WaitForDeployment lub --wait-for-deployment, aby sprawdzić faktyczny stan wdrożenia.

Uprzątnij zasoby

Jeśli zasoby nie są już potrzebne, usuń je z azd down folderu wariantu infrastruktury:

cd infra-bicep
azd down

Lub:

cd infra-terraform
azd down

Przed potwierdzeniem przejrzyj zasoby, które azd mają zostać usunięte. Usunięcie środowiska usuwa konto Foundry, projekt i wdrożenia modeli utworzone przez zestaw startowy.

Jeśli iterujesz wdrożenia i chcesz natychmiast odzyskać zarezerwowany limit TPM dla Claude, użyj opcji czyszczenia, jeśli obsługuje ją Twoja wersja azd:

azd down --purge

Jeśli nie zostaną oczyszczone, konta Foundry lub AIServices usunięte nietrwale mogą nadal zajmować limit TPM przez okres do 48 godzin. Jeśli usunięto już środowisko bez oczyszczenia, a przydział nadal wydaje się pełny, użyj polecenia az cognitiveservices account list-deleted -o table, aby znaleźć usunięte konta i usunąć na stałe te, których już nie potrzebujesz.

Następne kroki

  • Last updated on