microsoft / microsoft/Agent365-python
Python sample Playground debugging uses Windows-only paths and PowerShell command on macOS
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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