Diagnostisera ett projekt med agentläkare

Viktigt

Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

azd ai agent doctorkör en serie lokala och fjärrbaserade kontroller mot ditt aktuella Microsoft Foundry azd-projekt och rapporterar resultaten. Använd den för att återställa efter att ha förlorat terminalkontexten, stött på ett förvirrande fel eller plockat upp ett projekt igen efter en paus.

Förutsättningar

Välj när Doctor ska köras

Kör doctor när:

  • Du kom tillbaka till ett projekt efter några dagar och glömde var du slutade.
  • Ett kommando misslyckades och gav ett förvirrande felmeddelande, och du vill ha en strukturerad vy över vad som är konfigurerat respektive vad som saknas.
  • Du vill kontrollera att azd, slutpunkten för ditt Foundry-projekt, dina rolltilldelningar och din distribuerade agent alla är i gott skick innan du startar en långvarig åtgärd som eval, optimera eller distribuera.

doctor ändrar inte något tillstånd. Den läser bara.

Granska markerade områden

Varje anrop kör en uppsättning kontroller, inklusive men inte begränsat till:

  • Lokal: azd-version; azure.yaml finns och kan tolkas; azure.yaml definierar en azure.ai.agent-tjänst; .env för den aktiva azd-miljön har de förväntade nycklarna; förutsättningarna för containerbygge finns för containerdriftsättning; startpunkt och körningsmiljö är giltiga för koddriftsättning.
  • Fjärr: slutpunkten för Foundry-projektet kan matchas upp och nås; nödvändiga rolltilldelningar finns på projektet; den driftsatta agenten, om en sådan finns, finns och kan anropas; modelldistributionen som anges av azure.yaml finns.

Varje kontroll rapporterar pass, faileller skip. När varje utförd kontroll godkänns föreslår rapporten även nästa kommando som ska köras, till exempel azd ai agent eval generate.

Tolka utgångskoder

Slutkod Meaning
0 Minst en kontroll har godkänts och inga kontroller misslyckades.
1 Minst en kontroll misslyckades.
2 Alla kontroller hoppades över, till exempel när förhandsvillkoren inte uppfylls.

Dessa slutkoder är tillräckligt stabila för att användas i CI. Ett doctor steg före azd up kan misslyckas direkt om runnern saknar rolltilldelningar eller miljövariabler.

Välj användbara flaggor

Flag Description
--local-only Hoppa över fjärrkontroller som är nätverksberoende. Använd när du är offline, bakom en proxy eller för en snabb lokal sortering.
--unredacted Visa råa huvud-ID:n, scope-ARN:er och UPN:er i rapporten. Som standard redigeras känsliga identifierare i konsolutdata.

Kör diagnostik

  1. Kör den fullständiga diagnostiken, lokalt plus fjärranslutning:

    azd ai agent doctor

  2. Gör en snabb grovsortering när du är offline genom att hoppa över kontroller på distans:

    azd ai agent doctor --local-only

  3. Visa råa identifierare i rapporten när du delar med supporten:

    azd ai agent doctor --unredacted

Åtgärda fel

Använd den här vanliga loopen när något är fel:

  1. Kör azd ai agent doctor och läs de kontroller som misslyckades.
  2. Åtgärda den första misslyckade kontrollen, till exempel genom att lägga till en saknad rolltilldelning, ange en saknad miljövariabel eller köra azd auth login igen.
  3. Kör om azd ai agent doctor tills allt går igenom.
  4. Följ förslaget "nästa steg" längst ned i rapporten.

Relaterat innehåll

  • Last updated on