When a hosted AI agent crashes, azd now shows you the status and streams live logs—right from the CLI.

What’s new?

The azure.ai.agents extension adds two commands: azd ai agent show displays your agent’s container status, health, and error details, while azd ai agent monitor streams container logs in real time.

Why it matters

When a hosted AI agent fails to start, debugging means hunting through portals and APIs for error messages buried across multiple surfaces. These commands bring that information to your terminal. You see container health, replica state, and crash details in one place—no context-switching required.

How to use it

To check container status and health, run azd ai agent show. To stream logs, run azd ai agent monitor. Both commands accept --name and --version flags.

azd ai agent show --name my-agent --version 1          # View status, health, and errors
azd ai agent monitor --name my-agent --version 1       # Fetch recent logs
azd ai agent monitor --name my-agent --version 1 -f    # Follow logs in real time
azd ai agent monitor --name my-agent --version 1 --type system  # System logs

Try it out

These commands are available starting with the azure.ai.agents extension v0.1.12-preview, included in azd 1.23.7 and later. If you already use azd, upgrade the extension to the latest version:

azd extension upgrade azure.ai.agents

New to azd? Install it and run azd ai agent init to get started with hosted AI agents.

Feedback

Have questions or ideas? File an issue or start a discussion on GitHub. Want to help shape the future of azd? Sign up for user research.

This feature was introduced in PR #6895.