このトピックでは、Python エージェントがサポートする Python のバージョン、サードパーティコンポーネント、およびフレームワークを一覧で示します。
サポートされている Python バージョン
サポート対象の Protobuf バージョン
Python エージェントは、データのエンコーディングとレポートに Protobuf を使用します。このため、お使いのアプリケーションで使用されている Protobuf バージョンと競合する可能性があります。Python エージェントは、次の Protobuf バージョンと互換性があります。
"protobuf>=3.20.0, < 7.0"エージェントを統合すると、Protobuf など、一部の依存関係のバージョンが変更される場合があります。依存関係のバージョン変更による予期しないエラーを防ぐため、次のいずれかの方法を実行してください。
Protobuf などの依存関係をすでにインストールしている場合は、次のコマンドを実行して、その依存関係が優先されるようにしてください。
# パッケージのインストールパスを表示します
python3 -m site
# 出力は次のようになります
sys.path = [
'/app',
'/usr/local/lib/python3.9',
'/usr/local/lib/python3.9/site-packages'
]
# 依存関係のバージョンを優先させるため、PYTHONPATH 環境変数を設定します
# 異なるパスはコロン (:) で区切ります
export PYTHONPATH=/app:/usr/local/lib/python3.9:/usr/local/lib/python3.9/site-packages方法 1 で問題が解決しない場合は、Python エージェントを手動でインストールしてください。エージェントを統合した後、次のコマンドを実行して、特定のバージョンの依存関係を強制的に再インストールしてください。
pip3 install xx==${your_original_dependency_version} --force-reinstall
OpenTelemetry API の対応バージョン
Python エージェントは、OpenTelemetry API 仕様に基づいて実装されています。OpenTelemetry API はバージョンによってわずかな違いが生じることがあるため、Python エージェントは以下の範囲の OpenTelemetry API バージョンに対応しています。
"opentelemetry-api <= 1.40.0"Python フレームワークの互換性
作業を進める前に、以下のフレームワーク固有の要件を確認してください。
uvicorn
アプリケーションが uvicorn で起動する場合、次のいずれかの方法を選択してください：
方法 A：コード内でエージェントをインポートする。 uvicorn のエントリーファイルの先頭行に次の import 文を追加します：
from aliyun.opentelemetry.instrumentation.auto_instrumentation import sitecustomize方法 B: aliyun-instrument プレフィックスを付けて gunicorn に切り替えます。 uvicorn コマンドを置き換えます:
# 変更前：
uvicorn app:app --workers 4 --port=9090 --host 0.0.0.0
# 変更後：
aliyun-instrument gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:appaliyun-instrument プレフィックスは、ARMS Python エージェントの初期化と非侵入型インストルメンテーションを担当します。
uWSGI
アプリケーションが uWSGI で起動する場合は、「uWSGI で起動する Django または Flask プロジェクトへの Python エージェントのインストール」をご参照ください。
gevent
gevent コルーチンを使用する場合、GEVENT_ENABLE 環境変数を true に設定します。
たとえば、コードに次の内容が含まれている場合：
from gevent import monkey
monkey.patch_all()デプロイメントで次の環境変数を設定してください：
GEVENT_ENABLE=trueデータベースフレームワーク
サポート対象のプラグインバージョン
LLM (大規模言語モデル) アプリケーション
コンポーネント | PyPI/GitHub リポジトリアドレス | 最小バージョン | 上位バージョン |
AgentScope | v1.0.0 | v2.0.5 | |
Anthropic SDK | v0.16.0 | v0.111.0 | |
AutoGen | v0.7.0 | v0.8.0 | |
Claude Agent SDK | v0.1.0 | 制限なし | |
CrewAI | v0.1.0 | v1.7.2 | |
Dashscope | v1.0.0 | v1.2.1 | |
DeepAgents | v0.6.0 | v0.7.0 | |
Dify | v0.12.8 | v1.11.2 | |
Dify プラグイン | 制限なし | 制限なし | |
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 | 制限なし | 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 | |
Microsoft Agent Framework (MAF) | v1.0.0 | v1.13.0 | |
OpenAI | v1.0.0 | v2.14.0 | |
OpenAI エージェント | 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 |
LLM (大規模言語モデル) サービス
コンポーネント | PyPI / GitHub リポジトリ アドレス | 以前のバージョン | 以降のバージョン |
SGLang | v0.4.6 | v0.5.20 | |
vLLM V0 | v0.5.0 | v0.8.1 | |
vLLM V1 | v0.8.2 | v0.29.0 |
HTTP/RPC フレームワーク
コンポーネント | PyPI/GitHub リポジトリアドレス | 下限バージョン | 上限バージョン |
aiohttp | v3.0 | 制限なし | |
asgiref | v3.0 | 制限なし | |
BlackSheep | v1.2.0 | 制限なし | |
Click | v8.1.3 | < 9.0.0 | |
Django | v1.10 | 制限なし | |
Falcon | v1.4.1 | < 5.0.0 | |
FastAPI | v0.92 | 制限なし | |
Flask | v1.0 | 制限なし | |
gRPC | v1.42.0 | 制限なし | |
HTTPX | v0.18.0 | 制限なし | |
Jinja2 | v2.7 | < 4.0 | |
Pyramid | v1.7 | 制限なし | |
Requests | v2.0 | 制限なし | |
Starlette | v0.13 | 制限なし | |
Tornado | v5.1.1 | 制限なし | |
urllib | Python 標準ライブラリ | 特定のバージョン要件なし | 制限なし |
urllib3 | v1.0.0 | < 3.0.0 | |
WSGI | なし | 制限なし | 制限なし |
ベクトルデータベース
コンポーネント | PyPI/GitHub リポジトリのアドレス | 最小バージョン | 以降のバージョン |
Milvus | v2.4.1 | 制限なし |
メモリフレームワーク
コンポーネント | PyPI/GitHub リポジトリアドレス | 最小バージョン | 以降のバージョン |
mem0 | v1.0.0 | v1.0.2 |
データベースフレームワーク
コンポーネント | PyPI/GitHub リポジトリアドレス | 下限バージョン | 上限バージョン |
aiopg | v0.13.0 | < 2.0.0 | |
AsyncPG | v0.12.0 | 制限なし | |
DBAPI | 特定の依存関係なし | 特定のバージョン要件なし | 制限なし |
MySQL | v8.0 | < 10.0 | |
MySQLClient | 特定のバージョン要件なし | < 3 | |
psycopg | v3.1.0 | 制限なし | |
psycopg2 | v2.7.3.1 | 制限なし | |
Pydantic | v1.10.2 | 制限なし | |
PyMongo | v3.1 | < 5.0 | |
PyMSSQL | v2.1.5 | < 3 | |
PyMySQL | 特定のバージョン要件なし | < 2 | |
SQLAlchemy | v1.0.0 | < 2.1.0 | |
SQLite3 | 特定の依存関係なし | 特定のバージョン要件なし | 制限なし |
TortoiseORM | v0.17.0 | 制限なし |
キャッシュプラグイン
コンポーネント | PyPI/GitHub リポジトリアドレス | 旧バージョン | 以降のバージョン |
Cassandra | v3.25 | 制限なし | |
Elasticsearch | v6.0 | 制限なし | |
PyMemcache | v1.3.5 | < 5 | |
Redis | v2.6 | 制限なし | |
Scylla | v3.25 | 制限なし |
メッセージキュープラグイン
コンポーネント | PyPI/GitHub リポジトリ アドレス | 下限バージョン | 上限バージョン |
aio-pika | バージョン指定なし | 制限なし | |
aiokafka | バージョン指定なし | 制限なし | |
Celery | v4.0 | < 6.0 | |
Confluent Kafka | v1.8.2 | v2.7.0 | |
Kafka Python | バージョン指定なし | 制限なし | |
Pika | バージョン指定なし | 制限なし | |
Remoulade | v0.50 | 制限なし |
その他のプラグイン
コンポーネント | PyPI/GitHub リポジトリアドレス | 以前のバージョン | 以降のバージョン |
asyncio | 依存関係なし | バージョン要件なし | 制限なし |
Logging | 依存関係なし | バージョン要件なし | 制限なし |
Loguru | v0.5.0 | v1.0 | |
Threading | 依存関係なし | バージョン要件なし | 制限なし |