microsoft / microsoft/Agent365-python
Python sample Playground debugging uses Windows-only paths and PowerShell command on macOS
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- Python
- Star
- 41
- Fork
- 23
- Merge trung bình
- 7 giờ 43 phút
- Pull request đã merge (30 ngày)
- 3
Mô tả
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.
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Hướng nghiên cứu
Trong cấu hình VS Code của sample-agent, trước tiên hãy kiểm tra settings.json, launch.json và tasks.json. So sánh các cài đặt cho trình thông dịch Python, Playground PATH và lệnh token-refresh với quy trình macOS được tài liệu hóa, sau đó chạy các bước kiểm tra cấu hình VS Code. Được xem là hoàn tất khi quy trình debug Playground hoạt động trên macOS đồng thời giữ nguyên các giá trị mặc định của Windows.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- powershell, python, vscode
- Lĩnh vực
- developer-experience, tooling
- Loại issue
- Lỗi
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức độ hoạt động
- Sôi nổi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức phù hợp với người mới
- 78/100