Topik ini mencantumkan versi Python, komponen pihak ketiga, dan framework yang didukung oleh agen Python.
Versi Python yang didukung
Versi Protobuf yang didukung
Agen Python menggunakan Protobuf untuk pengkodean dan pelaporan data. Hal ini dapat berkonflik dengan versi Protobuf yang digunakan oleh aplikasi Anda. Agen Python kompatibel dengan versi Protobuf berikut:
"protobuf>=3.20.0, < 7.0"Integrasi agen dapat mengubah versi beberapa dependensi Anda, seperti Protobuf. Untuk mencegah error tak terduga akibat perubahan versi dependensi, gunakan salah satu metode berikut:
Jika Anda telah menginstal dependensi seperti Protobuf, jalankan perintah berikut untuk meningkatkan prioritasnya:
# Lihat path instalasi paket
python3 -m site
# Outputnya mirip dengan berikut
sys.path = [
'/app',
'/usr/local/lib/python3.9',
'/usr/local/lib/python3.9/site-packages'
]
# Atur variabel lingkungan PYTHONPATH agar memprioritaskan versi dependensi Anda
# Gunakan tanda titik dua (:) untuk memisahkan path yang berbeda
export PYTHONPATH=/app:/usr/local/lib/python3.9:/usr/local/lib/python3.9/site-packagesJika Metode 1 tidak menyelesaikan masalah, instal agen Python secara manual. Setelah mengintegrasikan agen, jalankan perintah berikut untuk memaksa penggunaan versi dependensi tertentu:
pip3 install xx==${your_original_dependency_version} --force-reinstall
Versi OpenTelemetry API yang didukung
Agen Python diimplementasikan berdasarkan spesifikasi OpenTelemetry API. Karena versi OpenTelemetry API yang berbeda mungkin memiliki perbedaan kecil, agen Python mendukung rentang versi OpenTelemetry API berikut:
"opentelemetry-api <= 1.40.0"Kompatibilitas framework Python
Tinjau persyaratan khusus framework berikut sebelum melanjutkan.
uvicorn
Jika aplikasi Anda dijalankan dengan uvicorn, pilih salah satu pendekatan berikut:
Pendekatan A: Impor agen dalam kode. Tambahkan pernyataan impor berikut ke baris pertama file entri uvicorn Anda:
from aliyun.opentelemetry.instrumentation.auto_instrumentation import sitecustomizePendekatan B: Beralih ke gunicorn dengan awalan aliyun-instrument. Ganti perintah uvicorn Anda:
# Sebelum
uvicorn app:app --workers 4 --port=9090 --host 0.0.0.0
# Sesudah
aliyun-instrument gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:appAwalan aliyun-instrument menangani inisialisasi dan instrumentasi non-intrusif dari agen Python ARMS.
uWSGI
Jika aplikasi Anda dijalankan dengan uWSGI, lihat Instal agen Python untuk proyek Django atau Flask yang dijalankan dengan uWSGI.
gevent
Jika Anda menggunakan korutin gevent, atur variabel lingkungan GEVENT_ENABLE ke true.
Sebagai contoh, jika kode Anda berisi:
from gevent import monkey
monkey.patch_all()Atur variabel lingkungan berikut dalam penerapan Anda:
GEVENT_ENABLE=trueKerangka kerja database
Versi Plugin yang Didukung
Aplikasi LLM (large language model)
Komponen | Alamat repositori PyPI/GitHub | Versi minimum | Versi selanjutnya |
AgentScope | v1.0 | v1.0.10 | |
Anthropic SDK | v0.16.0 | v0.111.0 | |
Claude Agent SDK | v0.1.0 | Tidak ada batasan | |
CrewAI | v0.1.0 | v1.7.2 | |
Dashscope | v1.0.0 | v1.2.1 | |
Dify | v0.12.8 | v1.11.2 | |
Dify Plugin | Tidak ada batasan | Tidak ada batasan | |
Dify React | v0.1.0 | v0.1.0 | |
Google ADK | v1.2.1 | v1.21.0 | |
Hermes Agent | v0.12.0 | v0.16.0 | |
LangChain | v0.1.0 | v1.2.0 | |
LangGraph | Tidak ada batasan | v1.0.5 | |
LiteLLM | v1.0.0 | v1.79.0 | |
Llama-index | v0.10.5 | v0.10.43 | |
MCP | v1.3.0 | v1.25.0 | |
OpenAI | v1.0.0 | v2.14.0 | |
OpenAI Agent | v0.3.3 | v0.6.6 | |
Qwen-Agent | v0.0.20 | v0.0.34 | |
QwenPaw | v1.1.0 | v1.1.11 | |
RagFlow | v0.14.0 | v0.21.1 |
Layanan LLM (large language model)
Komponen | Alamat repositori PyPI/GitHub | Versi sebelumnya | Versi selanjutnya |
SGLang | v0.4.6 | v0.4.9.post6 | |
vLLM V0 | v0.5.0 | v0.8.4 | |
vLLM V1 | V0.8.2 | V0.16.0 |
Framework HTTP/RPC
Komponen | Alamat repositori PyPI/GitHub | Versi sebelumnya | Versi selanjutnya |
aiohttp | v3.0 | Tidak ada batasan | |
asgiref | v3.0 | Tidak ada batasan | |
BlackSheep | v1.2.0 | Tidak ada batasan | |
Click | v8.1.3 | < 9.0.0 | |
Django | v1.10 | Tidak ada batasan | |
Falcon | v1.4.1 | < 5.0.0 | |
FastAPI | v0.92 | Tidak ada batasan | |
Flask | v1.0 | Tidak ada batasan | |
gRPC | v1.42.0 | Tidak ada batasan | |
HTTPX | v0.18.0 | Tidak ada batasan | |
Jinja2 | v2.7 | < 4.0 | |
Pyramid | v1.7 | Tidak ada batasan | |
Requests | v2.0 | Tidak ada batasan | |
Starlette | v0.13 | Tidak ada batasan | |
Tornado | v5.1.1 | Tidak ada batasan | |
urllib | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |
urllib3 | v1.0.0 | < 3.0.0 | |
WSGI | Tidak ada | Tidak ada batasan | Tidak ada batasan |
Database vektor
Komponen | Alamat repositori PyPI/GitHub | Versi minimum | Versi selanjutnya |
milvus | v2.4.1 | Tidak ada batasan |
Framework memori
Komponen | Alamat repositori PyPI/GitHub | Versi minimum | Versi selanjutnya |
mem0 | v1.0.0 | v1.0.2 |
Framework database
Komponen | Alamat repositori PyPI/GitHub | Versi sebelumnya | Versi selanjutnya |
aiopg | v0.13.0 | < 2.0.0 | |
AsyncPG | v0.12.0 | Tidak ada batasan | |
DBAPI | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |
MySQL | v8.0 | < 10.0 | |
MySQLClient | Tidak ada persyaratan versi khusus | < 3 | |
psycopg | v3.1.0 | Tidak ada batasan | |
psycopg2 | v2.7.3.1 | Tidak ada batasan | |
Pydantic | v1.10.2 | Tidak ada batasan | |
PyMongo | v3.1 | < 5.0 | |
PyMSSQL | v2.1.5 | < 3 | |
PyMySQL | Tidak ada persyaratan versi khusus | < 2 | |
SQLAlchemy | v1.0.0 | < 2.1.0 | |
SQLite3 | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |
TortoiseORM | v0.17.0 | Tidak ada batasan |
Plugin cache
Komponen | Alamat repositori PyPI/GitHub | Versi lama | Versi selanjutnya |
Cassandra | v3.25 | Tidak ada batasan | |
Elasticsearch | v6.0 | Tidak ada batasan | |
PyMemcache | v1.3.5 | < 5 | |
Redis | v2.6 | Tidak ada batasan | |
Scylla | v3.25 | Tidak ada batasan |
Plugin Antrian Pesan
Komponen | Alamat repositori PyPI/GitHub | Versi lama | Versi selanjutnya |
aio-pika | Tidak ada persyaratan versi khusus | Tidak ada batasan | |
aiokafka | Tidak ada persyaratan versi khusus | Tidak ada batasan | |
Celery | v4.0 | < 6.0 | |
Confluent Kafka | v1.8.2 | v2.7.0 | |
Kafka Python | Tidak ada persyaratan versi khusus | Tidak ada batasan | |
Pika | Tidak ada persyaratan versi khusus | Tidak ada batasan | |
Remoulade | v0.50 | Tidak ada batasan |
Plugin lainnya
Komponen | Alamat repositori PyPI/GitHub | Versi sebelumnya | Versi selanjutnya |
asyncio | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |
Logging | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |
Loguru | v0.5.0 | v1.0 | |
Threading | Tidak ada dependensi khusus | Tidak ada persyaratan versi khusus | Tidak ada batasan |