Python用のSelect AI

select_aiクライアント・ライブラリを使用して、PythonアプリケーションからAutonomous AI DatabaseのDBMS_CLOUD_AI機能にアクセスします。

Select AI for Pythonは、自然言語プロンプトからSQLを生成し、生成されたSQLを実行および説明し、コンテキストの会話を維持し、コンテンツを要約および翻訳し、合成データを生成し、Retrieval-Augmented Generation (RAG)ワークフローを構築します。

Select AI for Pythonでは、ストリーム・テキスト・レスポンス、同期および非同期プログラミング、外部ホスト・ネットワーク・アクセス管理、接続プーリングおよびオプションのコマンドライン・インタフェースもサポートされます。

サポートされているプラットフォーム

Select AI for Pythonは、Autonomous AI Database 26aiおよび19cで認定されています。その他のプラットフォームはライブラリで動作する可能性がありますが、動作保証されていません。

python-select-ai GitHubリポジトリで製品の問題を報告します。

Python用のSelect AIのインストール

pipを使用してSelect AI for Pythonパッケージをインストールします:

python3 -m pip install select_ai

オプションのコマンド行インタフェース依存関係をインストールするには、次を使用します。

python3 -m pip install 'select_ai[cli]'

Select AI for Pythonは、Python 3.11、3.12、3.13および3.14をサポートしています。

データベース権限およびネットワーク・アクセスの管理

Select AI for Pythonは、データベース・パッケージ権限、HTTPアクセスおよび外部ホスト・ネットワーク・アクセスを分離します。

データベース・パッケージ権限

次のAPIを使用して、データベース・パッケージ権限を付与または取り消します。

select_ai.grant_privileges(...)
select_ai.revoke_privileges(...)

これらのAPIは、次のデータベース・パッケージ権限をサポートしています。

• DBMS_CLOUD
• DBMS_CLOUD_AI
• DBMS_CLOUD_AI_AGENT
• DBMS_CLOUD_PIPELINE

HTTPアクセス

HTTPアクセスを管理するには、次のAPIを使用します。

select_ai.grant_http_access(...)
select_ai.revoke_http_access(...)

外部ホストネットワークアクセス

ネットワーク・アクセスAPIを使用して、外部ホストのホスト・アクセス制御リスト・エントリを管理します。ホスト、必要な権限およびオプションのポート範囲を指定します。

同期API:

select_ai.grant_network_access(...)
select_ai.revoke_network_access(...)

非同期API:

await select_ai.async_grant_network_access(...)
await select_ai.async_revoke_network_access(...)

実行可能な操作

次の表に、Select AI for Pythonの主な機能をまとめます。

サポートされているクラス

次の表に、Pythonクラスの主要なSelect AIの概要を示します。

プロバイダ・クラス

Select AI for Pythonには、次のプロバイダ・クラスが含まれています。

• OpenAIProvider
• AzureProvider
• OCIGenAIProvider
• AWSProvider
• GoogleProvider
• AnthropicProvider
• CohereProvider
• HuggingFaceProvider

プロバイダ固有の属性およびサポートされるパラメータについては、Select AI for Python APIリファレンスを参照してください。

AIプロファイルの操作

AIプロファイルは、PythonアプリケーションをAIプロバイダに接続し、Select AIがプロンプトを処理する方法を定義します。プロファイルには、プロバイダ情報、資格証明、モデル設定、データベース・オブジェクトおよびベクトル索引を含めることができます。

Select AI for Pythonでは、同期プロファイル・クラスと非同期プロファイル・クラスが提供されます。

一度に1つの操作を処理するアプリケーションで同期プロファイルを使用します。コンカレント要求を処理するアプリケーションまたはイベント・ループを使用するアプリケーションでは、非同期プロファイルを使用します。

次の表に、一般的に使用されるプロファイル関数を示します。

メソッドおよびパラメータの完全なリストは、Select AI for Python APIリファレンスを参照してください。

Select AIアクションの詳細は、AIキーワードを使用したプロンプトの入力も参照してください。

ストリーム・プロファイル応答

完全なCLOBレスポンスを待たずに、アプリケーションで生成されたテキストが使用可能になったときに処理する必要がある場合、ストリーミングを使用します。

ProfileクラスおよびAsyncProfileクラスは、次のパラメータによるストリーミングをサポートしています。

ストリーミングは、次のプロファイル・メソッドでサポートされています。

run_sql()メソッドはデータベース結果を返し、ストリーミングをサポートしません。

会話の操作

会話を使用して、関連するプロンプト間のコンテキストを保守します。会話にはプロンプト履歴が格納されるため、後のリクエストは以前のリクエストからの情報を参照できます。

Select AI for Pythonでは、同期および非同期の会話クラスが提供されます。

ConversationAttributesを使用して、会話設定を定義します。

アプリケーションでコンテキスト・チャットまたは一連の関連する自然言語リクエストが必要な場合に会話を使用します。各リクエストが独立している場合は、プロファイルを直接使用します。

ベクトル索引の使用

ベクトル索引を使用して、Retrieval-Augmented Generationをサポートします。ベクトル索引は、関連するコンテンツを取得し、生成AIモデルがレスポンスを生成する前にそのコンテンツをプロンプトに追加します。

Select AI for Pythonには、次のベクトル索引クラスが用意されています。

ベクトル索引構成を定義するには、VectorIndexAttributesを使用します。

VectorIndex.create()メソッドは、wait_for_completionパラメータをサポートします。ベクトル索引の作成が終了するまでメソッドが待機してから戻すかどうかを制御するには、このパラメータを設定します。

vector_index.get_next_refresh_timestamp()を使用して、次にスケジュールされたリフレッシュのUTCタイムスタンプを取得します。

データベース側の詳細は、「CREATE_VECTOR_INDEXプロシージャ」を参照してください。

合成データの生成

generate_synthetic_data()を使用して、指定された属性に基づいて合成データを生成します。

SyntheticDataAttributesを使用して、合成データ設定を定義します。これらの設定では、生成するデータおよび生成AIモデルで使用されるパラメータについて説明します。

合成データは、本番レコードを使用せずに代表的なデータを必要とする開発、デモンストレーションおよびその他のシナリオをサポートできます。

既存のオブジェクトの取得および更新

Select AI for Pythonは、データベース・バックアップ・プロキシ・オブジェクトを取得および更新するための一貫したメソッドを提供します。

これらのメソッドは、プロファイル、会話、ベクトル索引およびその他のサポートされているプロキシ・オブジェクトを操作するための一貫した方法を提供します。

クラス・メソッドを使用したオブジェクトの削除

アプリケーションが最初にプロキシ・オブジェクトを作成またはフェッチせずにオブジェクトを削除する必要がある場合は、クラスレベルのdeleteメソッドを使用します。

Profile.delete_profile(profile_name)
VectorIndex.delete_index(index_name)

同期および非同期APIの使用

Select AI for Pythonは、プライマリ操作に同期および非同期APIを提供します。

次の表は、同期クラスと操作を、対応する非同期クラスにマップしています。

次のようなアプリケーションでの非同期APIの使用:

• 複数のプロンプトを同時に処理します。
• イベント・ループを使用します。
• 非同期Pythonフレームワークと統合します。
• データベース操作の待機中にブロックを回避する必要があります。

select_ai.create_pool_async()を使用して、非同期ワークフロー用の共有接続プールを作成します。

AsyncProfileは、Profileと同じサポートされているテキスト・メソッドからのストリーミングをサポートしています。stream=Trueを設定し、必要に応じてchunk_sizeを指定します。

完全な非同期APIリファレンスは、Select AI for Python APIリファレンスを参照してください。

接続プールの管理

アプリケーションが繰返しまたは同時データベース・リクエストを処理する場合は、接続プールを使用します。

Select AI for Pythonには、次のプール作成関数が用意されています。

共有プールは、すべてのリクエストに対して新しいデータベース接続を作成する必要性を低減し、同時アプリケーション・ワークロードをサポートします。

コマンドライン・インタフェースの使用

オプションのselect-aiコマンドライン・インタフェースは、一般的なSelect AI操作への端末アクセスを提供します。

CLI依存関係をインストールします。

python3 -m pip install 'select_ai[cli]'

コマンドライン・インタフェースを実行します。

select-ai

次の表に、サポートされているコマンドの概要を示します。

コマンド・オプションとしてデータベース接続値を指定するか、次の環境変数を定義します。

Python用のSelect AI Agent

Select AI Agent固有のクラス、ツール操作、instructionパラメータおよびクラスレベルの削除メソッドについては、Select AI Agent for Pythonを参照してください。

関連資源

• Python用のSelect AI Agent
• Python APIリファレンス用のSelect AI
• AIキーワードを使用したプロンプトの入力
• Select AI GitHubリポジトリ
• 問題の報告