生成AIでのテキスト埋込みの作成

OCI生成AIのcohere.embedモデルを使用して、テキストをベクトル埋込みに変換し、アプリケーションでセマンティック検索、テキスト分類またはテキスト・クラスタリングに使用します。

• コンソール
• CLI
• API

• 1. コンソールのナビゲーション・バーで、生成AIを含むリージョン(米国中西部(シカゴ)や英国南部(ロンドン)など)を選択します。リージョンで提供されるモデルを参照してください。
  2. ナビゲーション・メニューを開き、「アナリティクスとAI」をクリックします。「AIサービス」で、「生成AI」をクリックします。
  3. 作業する権限があるコンパートメントを選択します。プレイグラウンドが表示されない場合は、管理者に生成AIリソースへのアクセス権の付与を依頼して、次のステップに戻ります。
  4. 「プレイグラウンド」をクリックします。
  5. 「埋込み」をクリックします。
  6. 次のいずれかのアクションを実行して、テキスト埋込みを作成するモデルを選択します。
     • 「モデル」リストで、モデルを選択します。
     • 「モデル詳細の表示」をクリックし、「モデルの選択」をクリックします。
  7. (オプション)「例」リストの例を使用するには、次のステップを実行します。
     1. 「例」リストから例を選択します。
     2. 「実行」をクリックして、例の埋込みを生成します。
     3. 「出力ベクトル投影」セクションで、出力の2ディメンション・バージョンを確認します。

        埋込みを使用して出力をビジュアル化するために、出力ベクトルは2つのディメンションに投影され、ポイントとしてプロットされます。近いポイントは、モデルが類似とみなすフレーズに対応します。

     4. 「クリア」をクリックしてすべての文を削除し、新しい文の埋込みの生成を開始します。
  8. 「センテンス入力」領域で、次のいずれかの方法でテキストを入力します。
     • 「1.」ボックスに文を入力し、「文の追加」をクリックしてさらに文を追加します。
     • 「ファイルのアップロード」をクリックして、追加するテキストを含むファイルを選択します。
     ノート
     
     .txt拡張子のファイルのみが許可されます。各入力文、フレーズまたは段落は、改行文字で区切る必要があります。実行ごとに最大96の入力が許可され、各入力のトークン数は512未満である必要があります。入力の最大数に達するまで、文を手動で追加するか、複数のファイルをアップロードできます。
  9. 「Truncate」パラメータでは、トークンが最大許容トークン数(512)を超えた場合に、開始トークンと終了トークンのどちらを省略するかを選択します。
     ヒント
     
     512トークンを超える入力の場合、「Truncate」パラメータを「None」に設定すると、エラー・メッセージが表示されます。埋込みモデルを実行する前に、「切捨て」パラメータに対して「開始」または「終了」を選択します。
  10. 「実行」をクリックします。
  11. 「出力ベクトル投影」セクションで、出力の2ディメンション・バージョンを確認します。
      埋込みを使用して出力を視覚化するために、出力ベクトルは2つのディメンションに投影され、ポイントとしてプロットされます。近いポイントは、モデルが類似とみなすフレーズに対応します。
  12. 結果に問題がない場合は、「JSONへの埋込みのエクスポート」をクリックして、入力ごとに1024ディメンション・ベクトルを含むJSONファイルを取得します。
  13. (オプション)「コードの表示」をクリックし、プログラミング言語を選択して「コードのコピー」をクリックし、コードをファイルに貼り付けます。ファイルが、貼り付けられたコードの形式を保持します。
      ヒント
      
      アプリケーションでコードを使用している場合は、コードを認証していることを確認してください。
  14. (オプション)「クリア」をクリックしてすべての文を削除し、新しい文の埋込みの生成を開始します。
      ノート
      
      「Clear」をクリックすると、「Truncate」パラメータはデフォルト値「None」にリセットされます。

• テキストの埋込みを作成するには、embed-text-result操作を使用します。

  次のコマンドを入力して、テキスト埋込みを作成するオプションのリストを表示します。

  oci generative-ai-inference embed-text-result embed-text -h

  OCIGenerative AI CLIコマンドのパラメータおよび値の完全なリストは、生成AI推論CLIおよび生成AI管理CLIを参照してください。

• EmbedText操作を実行して、テキスト埋込みを作成します。

  APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。