Azure-Samples / Azure-Samples/rag-data-openai-python-promptflow

Document required Python 3.11.9 version

Đang mở
#31 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
Python
Star
290
Fork
152
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

> Please provide us with the following information:
> ---------------------------------------------------------------

### This issue is for a: (mark with an `x`)
```
- [x] bug report -> please search issues before submitting
- [ ] feature request
- [x] documentation issue or request
- [ ] regression (a behavior that used to work and stopped in a new release)
```

### Minimal steps to reproduce
> I had the newest version Python 3.12 installed on my machine and build the example.
Building runs fine (pip etc) but running the example fails with obscure errors.
I found out that the "az" tool seems not to be supported with Python 3.12

So I searched the docs from the rag-data-openai-python-promptflow example, and found hints about Python 3.10
However this did not run either..."az" gave a kind of error message that 3.11.9 is needed.

Finally I installed Python 3.11.9 and the example can be build and run successfully.
I would recommend to add this information into the docs as it can save some frustration.
I now noticed that the Windows AppStore has also Python 3.11.9 as default (which can avoid the problem if you install from there) but there are also other installation ways or OS, so giving a hint that Python 3.11.9 is required would be fine.

There are also ways to enforce the python version technically (e.g. via pipenv) but this would be a separate discussion.

### Any log messages given by the failure
> I can add the error messages with Python 3.12 and Python 3.10 if you need them

### Expected/desired behavior
> I would like the required Python version 3.11.9 to be documented clearly.

### OS and Version?
> Windows 7, 8 or 10. Linux (which distribution). macOS (Yosemite? El Capitan? Sierra?)
Windows
### Versions
>10

### Mention any other details that might be useful

> ---------------------------------------------------------------
> Thanks! We'll be in touch soon.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Hướng nghiên cứu

Bắt đầu bằng cách tìm tài liệu cho ví dụ rag-data-openai-python-promptflow và kiểm tra cách các yêu cầu về Python hiện được mô tả. Cập nhật hướng dẫn thiết lập liên quan để nêu rõ phiên bản Python bắt buộc là 3.11.9, sau đó xác minh rằng các hướng dẫn được ghi trong tài liệu rõ ràng đối với Windows và các môi trường được hỗ trợ khác.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.