AIエージェント

AI エージェントは、自然な言葉を理解し、タスクを実行し、Odooのさまざまな機能を使ってユーザをサポートするスマートアシスタントです。OdooのAI 機能を構成する中心的な要素であり、各エージェントには、目的やプロンプト、そして動作を決めるトピックやツールがあらかじめ設定されています。

エージェントは、主に トピックソース の 2 つの要素で構成されています。

  • トピック はエージェントがどんなタスクを実行すべきかを示す指示や役割です。 ツール はトピックに割り当てられ、エージェントがタスクを実際に実行するために利用できる機能です。

  • ソース はエージェントがタスクを実行するために必要な情報を提供します。

重要

多くのAI機能は AI アプリを使用しなくても Odoo で利用できますが、エージェントの作成やカスタマイズには AI アプリのインストールが必要です。

OdooのAIプロンプト

AIエージェントを使用する前に、AIプロンプトに関する基本的な概念を理解しておくことが重要です。

AIプロンプトとは、AIモデルに対して「どのように応答すべきか」「どのような役割を担うべきか」を指示するために与える文章(指示や状況説明)のことです。プロンプトでは次のような内容を定義できます:

  • AIモデルの口調、文体、ペルソナ

  • モデルが実行できる範囲

  • リクエストに対して期待される出力のタイプ

Odoo では、各AIエージェントに システムプロンプト が割り当てられており、エージェントの役割・目的・基本的な振る舞いを定義します。これはエージェントの「中核となる指針」のようなもので、すべてのやり取りの基盤となります。

トピック には、インストラクション と呼ばれる独自のプロンプト的な要素も含まれています。インストラクションは、特定の状況やワークフローにおいてエージェントがどのように振る舞い、Odooの仕組みとどのように連携するかを細かく調整するためのガイドラインです。

インスラクションには通常以下が含まれています:

  • 目的、またはそのトピックが扱う内容

  • このトピックが割り当てられた際にエージェントが従うべきルールや制約

  • 特定のアクションを完了する方法に関する段階的なワークフロー

  • アクションを実行するために必要な技術的な詳細情報

エージェントの構造

トピック

トピックは、特定のコンテキスト内でエージェントがどのように動作するかを定義する一連の指示とツールです。基本的に、トピックはエージェントがデータベース内で何ができるかを定義します。トピックは会話を導き、エージェントが何ができるか、どのようにそれを行うか、いつそれを行うべきかを伝えます。

重要

エージェントにトピックが割り当てられていない場合、情報を提供することしかできず、タスクの実行やデータベースの変更は行えません。

各トピック内には詳細なプロンプトが含まれており、そのトピックに関連するタスクの実行方法に関するより詳細な指示をエージェントに提供し、その動作の境界を定義し、ユーザーの意図をどのように解釈すべきかを決定します。これらのプロンプトにより、エージェントが一貫した推論パターンに従い、正確でコンテキストを認識した応答を生成するために適切なツールを使用することが保証されます。

AI アプリには、次のトピックがあらかじめ設定されています:

  • 自然言語検索: ユーザの検索クエリを解釈し、検索に必要なツールを使って適切なOdooビューを開くのをサポートします。

  • 情報取得: モデルに関する情報を取得するためのツールのセットです。

  • リードを作成: リードの自動作成をサポートするツールのセットです。このトピックは、CRM アプリがインストールされている場合に のみ 利用できます。

各トピックには、やり取りの流れを定義するプロンプトとして機能する インストラクション と、エージェントが実行できる機能を示す 1 つ以上の AI ツール が含まれています。

ツール

ツール とは、エージェントが Odoo内で実行できる機能のことです。リードの作成やビューの表示などの操作が含まれます。ツールは、エージェントが会話だけでなく実際の処理を行えるようにする役割を持っています。利用できるツールは、データベースにインストールされているアプリによって異なります。1 つのトピックに複数の AIツール を割り当てることもできます。

応募元

ソースとは、エージェントが応答を生成したりタスクを実行したりする際に参照できるデータのことです。ソースはインデックス化されており、ユーザが質問したときに、エージェントが関連情報をすばやく取得できるようになっています。

Example

カスタマーサポートの質問に回答するためのエージェントには、FAQ などを含む ナレッジ 記事がソースとして設定されています。

ソースは以下のフォーマットが可能です:

  • PDF

  • ウェブリンク

  • ドキュメント ( ドキュメント アプリ内にアップロード済のもの)

  • ナレッジ アプリ記事

重要

エージェントで ソースに限定 オプションが有効になっている場合、エージェントはアップロード済みでアクティブなソースのみを利用できます。

新しいエージェントを作成

新しいエージェントを作成するには :menuselection:`AIアプリ --> 新規`に移動します。 :guilabel:`エージェント名`を入力して必要であれば簡単な説明を追加します。

ちなみに

新しいエージェントを作成する前に、まず明確なユースケースを想定しておくことを推奨します。そうすることで、 システムプロンプト`の作成や、:guilabel:`トピック や :guilabel:`AI ツール`の割り当てをスムーズに行えます。

ドロップダウンメニューから LLMモデル を選択します。

重要

Odooは、ChatGPTとGeminiの複数バージョンに対応しています。

次に、応答スタイル を選択します。これは、エージェントが問い合わせに応答する際の全体的な口調を管理します。次のいずれかを選択できます:

  • 分析的: より数学的で、同じ質問に対して同じ回答を返す可能性が高くなります。正確さが丁寧さより重要な場面で推奨されるスタイルです。

  • バランス: 分析的クリエイティブ の中間的なスタイルです。正確さ と 丁寧さの両方が求められる、外部顧客対応などの場面に最適です。

  • クリエイティブ: より人間的なアプローチで質問に応答し、会話に合わせて毎回異なる回答を返します。状況によって解決策が変わることが多い場面に最適です。

ソースに制限 のチェックボックスをオンにすると、エージェントは提供されたリソース のみ に基づいて応答するようになります。

次に、エージェントに 1 つ以上の トピック を選択します。前述のとおり、 トピック には、ユーザがタスクを完了するためにエージェントを導く指示とツールが含まれています。

エージェントの役割や責任を詳しく指示する システムプロンプト を入力します。

ちなみに

システムプロンプト の具体性や長さは、エージェントのユースケースによって異なります。あらかじめ用意されているエージェントを参考に、どのような情報を含められるかを確認してください。

必要な情報が入力された新規エージェントのフォーム。

エージェントに ソース が必要な場合は、 ソース タブまでスクロールし、ソースを追加 をクリックします。

フォーマットを選択:

  • PDF: エクスプローラウィンドウから適切なファイルを選択し、開く をクリックします

  • ウェブリンク: URLを貼り付けます。複数のリンクを一度に追加できます。1行に1つのリンクを貼り付けます。保存をクリックします。

  • ドキュメント (**ドキュメント**アプリケーションにアップロード): 1つ以上のドキュメントの横にあるチェックボックスをオンにし、選択をクリックします。

  • **ナレッジ**アプリの記事: 1つ以上の記事の横にあるチェックボックスをオンにし、選択をクリックします。

ソースが追加されると、ステータスフィールドが更新され、現在のステータスが反映されます。ステータスが*処理中*から*インデックス済み*に変わると、ソースの準備が完了します。稼働中トグルをスライドしてソースを有効にします。

エージェントのソースのリスト(各形式で表示)。

重要

ソースのアップロードに失敗した場合は、選択したLLMモデルとの競合が原因である可能性があります。

テストボタンをクリックすると、会話ウィンドウが開き、新しいエージェントをテストできます。