microsoft / microsoft/Agent365-python

Python sample Playground debugging uses Windows-only paths and PowerShell command on macOS

Open
#271 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
41
Forks
23
Avg merge
7h 43m
Merged PRs (30d)
3

Description

Description:

Summary

The README includes macOS environment setup, but the sample’s VS Code F5 configuration contains Windows-specific interpreter paths, a Windows PATH separator, and a PowerShell executable name unavailable on Mac.

Sample: https://github.com/microsoft/Agent365-Samples/tree/main/python/agent-framework/sample-agent

Environment

macOS on Apple Silicon, Python 3.11.15, PowerShell 7.6.0 installed as pwsh.

Steps to Reproduce

Create the documented virtual environment on macOS, install PowerShell, and select Debug in Microsoft 365 Agents Playground in VS Code. The configuration references these incompatible values:

Location Configured Value macOS Equivalent
settings.json .venv/Scripts/python.exe python
launch.json, Python launch .venv/Scripts/python.exe python
launch.json, Playground PATH ; separator : separator
tasks.json, token refresh powershell pwsh
Expected Behavior

The documented Playground debug workflow should resolve the correct interpreter and executables on macOS without manual configuration changes.

Suggested Resolution

Use portable interpreter discovery and platform-specific overrides for the Python launch, Playground PATH, and token-refresh task. I applied macOS overrides locally while retaining the Windows defaults; VS Code configuration checks pass.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

In the sample-agent VS Code configuration, inspect settings.json, launch.json, and tasks.json first. Compare the Python interpreter, Playground PATH, and token-refresh command settings with the documented macOS workflow, then run the VS Code configuration checks. Done means the Playground debug workflow works on macOS while retaining the Windows defaults.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell, python, vscode
Domain
developer-experience, tooling
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.