Azure-Samples / Azure-Samples/rag-data-openai-python-promptflow
Document required Python 3.11.9 version
- 主要语言
- Python
- 星标
- 290
- 派生
- 152
- PR 合并指标
- 30 天内没有已合并 PR
描述
> 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.
贡献指南
这个仓库没有索引到贡献指南
调研方向
首先找到 rag-data-openai-python-promptflow 示例的文档,并检查其中当前如何描述 Python 要求。更新相关的设置指南,说明所需的 Python 版本为 3.11.9,然后确认文档中的说明对于 Windows 和其他受支持的环境都清晰明确。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- python
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 活跃度
- 停滞
- 描述清晰度
- 基本清楚
- 新手友好度
- 35/100