[Agent Extension] Add file operations for hosted agent sessions by trangevi · Pull Request #7141 · Azure/azure-dev

trangevi · 2026-03-13T22:17:51Z

Add 'azd ai agent files' command group with upload, download, list, and remove subcommands for managing session-scoped files on hosted agent sandboxes. This enables debugging, seeding data, and agent setup.

New commands:

files upload --path
files download [-o ]
files list [remote-path] [--output json|table]
files remove [--recursive]

All commands require --name, --version, and --session flags. Uses the vnext API version (2025-11-15-preview) for session-scoped endpoints.

fixes #7132

Add 'azd ai agent files' command group with upload, download, list, and remove subcommands for managing session-scoped files on hosted agent sandboxes. This enables debugging, seeding data, and agent setup. New commands: - files upload <remote-path> --path <local-path> - files download <remote-path> [-o <output-path>] - files list [remote-path] [--output json|table] - files remove <remote-path> [--recursive] All commands require --name, --version, and --session flags. Uses the vnext API version (2025-11-15-preview) for session-scoped endpoints. Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Adds a new azd ai agent files command group to the azure.ai.agents extension to manage session-scoped files on hosted agent sandboxes, backed by new session file API operations and models.

Changes:

Introduces files command group with upload, download, list, and remove subcommands (plus basic command/formatting tests).
Adds session file API operations (upload/download/list/remove) to the agent API client.
Adds session file listing models and new extension error codes for file-related failures.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
cli/azd/extensions/azure.ai.agents/internal/pkg/agents/agent_api/operations.go	Adds client operations for session file upload/download/list/remove.
cli/azd/extensions/azure.ai.agents/internal/pkg/agents/agent_api/models.go	Adds models for representing session file listings.
cli/azd/extensions/azure.ai.agents/internal/exterrors/codes.go	Introduces new error codes for file operation scenarios.
cli/azd/extensions/azure.ai.agents/internal/cmd/root.go	Registers the new `files` command group on the extension root command.
cli/azd/extensions/azure.ai.agents/internal/cmd/files.go	Implements the `files` command group and subcommands (CLI UX + printing).
cli/azd/extensions/azure.ai.agents/internal/cmd/files_test.go	Adds tests for subcommand presence, required flags, and output helpers.

You can also share your feedback on Copilot code review. Take the survey.

Signed-off-by: trangevi <[email protected]>

Co-authored-by: Copilot Autofix powered by AI <[email protected]>

Signed-off-by: trangevi <[email protected]>

…ure/azure-dev into trangevi/agent-files-handling

Signed-off-by: trangevi <[email protected]>

…7181) Co-authored-by: rajeshkamal5050 <[email protected]>

* Initial plan * Prepare azure.ai.agents 0.1.16-preview patch release (#7141, #7175, #7181) Co-authored-by: rajeshkamal5050 <[email protected]> * Remove registry.json changes - to be updated after builds are generated Co-authored-by: rajeshkamal5050 <[email protected]> * Add Breaking Changes section in CHANGELOG.md and move #7181 under it Co-authored-by: rajeshkamal5050 <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: rajeshkamal5050 <[email protected]>

- Add 1.24.0-beta.1 unreleased section to cli/azd/CHANGELOG.md with entries for configurable deploy timeout (Azure#7045), git dirty check and workflow consent for azd init agent mode (Azure#7162), cobra command tree fix (Azure#7171), and input validation improvements (Azure#7175) - Bump cli/version.txt to 1.24.0-beta.1 - Add 0.1.16-preview section to agents CHANGELOG with entries for file operations (Azure#7141), input validation (Azure#7175), and breaking change for show/monitor commands (Azure#7181) - Bump agents version.txt and extension.yaml to 0.1.16-preview Co-authored-by: Copilot <[email protected]>

* Initial plan * Prepare azure.ai.agents 0.1.16-preview patch release (Azure#7141, Azure#7175, Azure#7181) Co-authored-by: rajeshkamal5050 <[email protected]> * Remove registry.json changes - to be updated after builds are generated Co-authored-by: rajeshkamal5050 <[email protected]> * Add Breaking Changes section in CHANGELOG.md and move Azure#7181 under it Co-authored-by: rajeshkamal5050 <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: rajeshkamal5050 <[email protected]>

…e#7141) * Add file operations for hosted agent sessions (Azure#7132) Add 'azd ai agent files' command group with upload, download, list, and remove subcommands for managing session-scoped files on hosted agent sandboxes. This enables debugging, seeding data, and agent setup. New commands: - files upload <remote-path> --path <local-path> - files download <remote-path> [-o <output-path>] - files list [remote-path] [--output json|table] - files remove <remote-path> [--recursive] All commands require --name, --version, and --session flags. Uses the vnext API version (2025-11-15-preview) for session-scoped endpoints. Co-authored-by: Copilot <[email protected]> * PR comments Signed-off-by: trangevi <[email protected]> * Copilot suggestion Co-authored-by: Copilot Autofix powered by AI <[email protected]> * Modify files commands to not take name and version Signed-off-by: trangevi <[email protected]> * List fixes. Header fixes Signed-off-by: trangevi <[email protected]> * Add mkdir command. clean up parameters Signed-off-by: trangevi <[email protected]> * Linter Signed-off-by: trangevi <[email protected]> * Add stat command Signed-off-by: trangevi <[email protected]> * PR comment Signed-off-by: trangevi <[email protected]> --------- Signed-off-by: trangevi <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Copilot Autofix powered by AI <[email protected]>