AIエージェント¶
AI エージェントは、自然な言葉を理解し、タスクを実行し、Odooのさまざまな機能を使ってユーザをサポートするスマートアシスタントです。OdooのAI 機能を構成する中心的な要素であり、各エージェントには、目的やプロンプト、そして動作を決めるトピックやツールがあらかじめ設定されています。
エージェントは、主に トピック と ソース の 2 つの要素で構成されています。
トピック はエージェントがどんなタスクを実行すべきかを示す指示や役割です。 ツール はトピックに割り当てられ、エージェントがタスクを実際に実行するために利用できる機能です。
ソース はエージェントがタスクを実行するために必要な情報を提供します。
重要
多くのAI機能は AI アプリを使用しなくても Odoo で利用できますが、エージェントの作成やカスタマイズには AI アプリのインストールが必要です。
OdooのAIプロンプト¶
AIエージェントを使用する前に、AIプロンプトに関する基本的な概念を理解しておくことが重要です。
AIプロンプトとは、AIモデルに対して「どのように応答すべきか」「どのような役割を担うべきか」を指示するために与える文章(指示や状況説明)のことです。プロンプトでは次のような内容を定義できます:
AIモデルの口調、文体、ペルソナ
モデルが実行できる範囲
リクエストに対して期待される出力のタイプ
Odoo では、各AIエージェントに システムプロンプト が割り当てられており、エージェントの役割・目的・基本的な振る舞いを定義します。これはエージェントの「中核となる指針」のようなもので、すべてのやり取りの基盤となります。
各 トピック には、インストラクション と呼ばれる独自のプロンプト的な要素も含まれています。インストラクションは、特定の状況やワークフローにおいてエージェントがどのように振る舞い、Odooの仕組みとどのように連携するかを細かく調整するためのガイドラインです。
インスラクションには通常以下が含まれています：
目的、またはそのトピックが扱う内容
このトピックが割り当てられた際にエージェントが従うべきルールや制約
Step-by-step workflows for how to complete a specific action
アクションを実行するために必要な技術的な詳細情報
エージェントの構造¶
トピック¶
Topics are a collection of instructions and tools that define how an agent behaves within a specific context. Essentially, the topics define what an agent can do within the database. Topics guide conversations, telling the agent what it can do, how it can do it, and when it should do it.
重要
エージェントにトピックが割り当てられていない場合、情報を提供することしかできず、タスクの実行やデータベースの変更は行えません。
Within each topic includes a detailed prompt, which provides the agent with more in-depth instructions on how to perform the tasks associated with that topic, define the boundaries of its behavior, and determine how it should interpret user intent. These prompts ensure that the agent follows a consistent reasoning pattern and uses the appropriate tools to generate accurate, context-aware responses.
AI アプリには、次のトピックがあらかじめ設定されています：
自然言語検索: ユーザの検索クエリを解釈し、検索に必要なツールを使って適切なOdooビューを開くのをサポートします。
情報取得: モデルに関する情報を取得するためのツールのセットです。
リードを作成: リードの自動作成をサポートするツールのセットです。このトピックは、CRM アプリがインストールされている場合に のみ 利用できます。
各トピックには、やり取りの流れを定義するプロンプトとして機能する インストラクション と、エージェントが実行できる機能を示す 1 つ以上の AI ツール が含まれています。
ツール¶
ツール とは、エージェントが Odoo内で実行できる機能のことです。リードの作成やビューの表示などの操作が含まれます。ツールは、エージェントが会話だけでなく実際の処理を行えるようにする役割を持っています。利用できるツールは、データベースにインストールされているアプリによって異なります。1 つのトピックに複数の AIツール を割り当てることもできます。
応募元¶
ソースとは、エージェントが応答を生成したりタスクを実行したりする際に参照できるデータのことです。ソースはインデックス化されており、ユーザが質問したときに、エージェントが関連情報をすばやく取得できるようになっています。
Example
カスタマーサポートの質問に回答するためのエージェントには、FAQ などを含む ナレッジ 記事がソースとして設定されています。
ソースは以下のフォーマットが可能です:
ウェブリンク
ドキュメント ( ドキュメント アプリ内にアップロード済のもの)
ナレッジ アプリ記事
重要
エージェントで ソースに限定 オプションが有効になっている場合、エージェントはアップロード済みでアクティブなソースのみを利用できます。
新しいエージェントを作成¶
新しいエージェントを作成するには :menuselection:`AIアプリ --> 新規`に移動します。 :guilabel:`エージェント名`を入力して必要であれば簡単な説明を追加します。
ちなみに
新しいエージェントを作成する前に、まず明確なユースケースを想定しておくことを推奨します。そうすることで、 システムプロンプト`の作成や、:guilabel:`トピック や :guilabel:`AI ツール`の割り当てをスムーズに行えます。
ドロップダウンメニューから LLMモデル を選択します。
重要
Odooは、ChatGPTとGeminiの複数バージョンに対応しています。
次に、応答スタイル を選択します。これは、エージェントが問い合わせに応答する際の全体的な口調を管理します。次のいずれかを選択できます：
分析的: より数学的で、同じ質問に対して同じ回答を返す可能性が高くなります。正確さが丁寧さより重要な場面で推奨されるスタイルです。
バランス: 分析的 と クリエイティブ の中間的なスタイルです。正確さ と 丁寧さの両方が求められる、外部顧客対応などの場面に最適です。
クリエイティブ: より人間的なアプローチで質問に応答し、会話に合わせて毎回異なる回答を返します。状況によって解決策が変わることが多い場面に最適です。
ソースに制限 のチェックボックスをオンにすると、エージェントは提供されたリソース のみ に基づいて応答するようになります。
次に、エージェントに 1 つ以上の トピック を選択します。前述のとおり、 トピック には、ユーザがタスクを完了するためにエージェントを導く指示とツールが含まれています。
エージェントの役割や責任を詳しく指示する システムプロンプト を入力します。
ちなみに
システムプロンプト の具体性や長さは、エージェントのユースケースによって異なります。あらかじめ用意されているエージェントを参考に、どのような情報を含められるかを確認してください。
エージェントに ソース が必要な場合は、 ソース タブまでスクロールし、ソースを追加 をクリックします。
フォーマットを選択:
PDF: エクスプローラウィンドウから適切なファイルを選択し、開く をクリックします
Weblinks: paste the URL. Multiple links can be added at once, paste one link per line. Click Save.
Documents (uploaded in the Documents application): Tick the checkbox next to one or more documents, then click Select.
Knowledge app articles: Tick the checkbox next to one or more articles, then click Select.
Once a source is added, the Status field updates to reflect its current status. The source is ready when the status changes from Processing to Indexed. Slide the Active toggle to activate the source.
重要
If a source fails to upload, it could be the result of a conflict with the selected LLM model.
Click the Test button to open a conversation window and test the new agent.