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

Document required Python 3.11.9 version

Aperta
#31 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
Python
Stelle
290
Fork
152
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

> 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.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

Inizia individuando la documentazione dell'esempio rag-data-openai-python-promptflow e verifica come sono attualmente descritti i requisiti Python. Aggiorna le istruzioni di configurazione pertinenti per indicare che è richiesta la versione 3.11.9 di Python, quindi verifica che le istruzioni documentate siano chiare per Windows e per gli altri ambienti supportati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.