Przewodnik rozwiązywania problemów z programem Agent 365

Skorzystaj z tego przewodnika, aby diagnozować i rozwiązywać problemy na całym cyklu życia rozwoju Agent 365. Użyj tego artykułu jako punktu wyjścia do rozwiązywania problemów, a następnie przejdź do konkretnych sekcji, aby uzyskać szczegółowe rozwiązania.

Kroki rozwiązywania problemów

Każdy z linków w tej tabeli zawiera kroki rozwiązywania problemów dla konkretnych obszarów. Zawartość jest grupowana według etapu Cyklu życiu zestawu SDK Agent 365.

Etap Zawartość rozwiązywania problemów
Budowanie i uruchamianie agenta Agent 365 CLI
Rejestracja niestandardowej aplikacji klienckiej dla Agent 365 CLI
Serwer symulujący oprzyrządowanie
Możliwość monitorowania agentów
Testowanie agentów
Testowanie agentów za pomocą tuneli dev
Dodawanie i zarządzanie narzędziami
Konfiguracja konspektu agenta Konfiguracja konspektu agenta
Wdrażaj Wdrażanie agenta na platformie Azure
Wdróż agenta na Amazon Web Services (AWS)
Wdróż agenta na Google Cloud Platform (GCP)
Opublikuj agenta w Centrum administracyjnym Microsoft 365 Opublikuj agenta w centrum administracyjnym Microsoft
Utwórz wystąpienia agentów Utwórz wystąpienia agentów

Referencja poleceń diagnostycznych

Zanim zaczniesz rozwiązywać konkretne problemy, użyj tych poleceń, aby sprawdzić bieżący stan środowiska Agent 365.

Sprawdź interfejs wiersza polecenia i konfigurację

Użyj tych poleceń, aby zweryfikować interfejs wiersza polecenia i konfigurację.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Weryfikowanie zasobów platformy Azure

Użyj tych poleceń, aby sprawdzić zasoby Azure i status aplikacji.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Weryfikuj konspekt agenta

Upewnij się, że konspekt agenta istnieje i jest poprawnie skonfigurowany.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Weryfikacja konspektu w Microsoft Entra

  1. Przejdź do https://entra.microsoft.com>Rejestracje aplikacji>Wszystkie aplikacje.
  2. Wyszukaj agentBlueprintId.

Najlepsze praktyki zapobiegawcze

Skorzystaj z tych zaleceń, aby uniknąć typowych problemów i usprawnić rozwiązywanie problemów.

Przed rozpoczęciem

Sprawdzanie wstępnie wymaganych składników:

✅ .NET 8.0, zestaw SDK jest zainstalowany
✅ interfejs wiersza polecenia Azure zainstalowany i uwierzytelniony
✅ Wymagane uprawnienia Entra przypisane
✅ Niestandardowa aplikacja kliencka utworzona i skonfigurowana
✅ Dzierżawca aktywowany dla Microsoft Agent 365 Frontier

Polecenia walidacji:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Podczas rozwoju

Zapisz konfiguracje potoku:

  • Zachowaj kopie zapasowe plików konfiguracyjnych.
  • Dokumentuj swoje wybory dotyczące konfiguracji.
  • Zapisz wygenerowane identyfikatory, takie jak identyfikator konspektu i identyfikator zarządzanej tożsamości.

Aktualizuj interfejs wiersza polecenia na bieżąco:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Testuj stopniowo:

  • Testuj po każdym ważnym kroku.
  • Zweryfikuj powodzenie przed przejściem do następnego kroku.
  • Zachowaj działające konfiguracje.

Przed wdrożeniem

Lista kontrolna przed wdrożeniem:

✅ Agent działa lokalnie ze środowiskiem testowym agentów.
✅ Wszystkie zmienne środowiskowe są udokumentowane.
✅ Pliki konfiguracji zatwierdzone do systemu kontroli wersji.
✅ Serwery MCP skonfigurowane i przetestowane.
✅ Obserwowalność włączona i zweryfikowana.

Uzyskaj dodatkową pomoc

Aby przeglądać przykładowy kod, zgłaszać problemy lub przeszukiwać istniejące problemy, korzystaj z następujących repozytoriów:

  • Last updated on