メインコンテンツまでスキップ
バージョン: 26.2 Preview

Agent Fawkes を使用する

iBeta

この機能はPhoenixAIサポートによって有効化される必要があります。ご利用を希望される場合は、サポートケースを開いてください。

ベータ機能の使用に関するアドバイス

Agent Fawkes は、データのプライバシーとセキュリティを確保しながら、データ管理体験を向上させるために設計された AI アシスタントです。SQL の生成、メタデータの確認、リアルタイムのタスク監視などの機能を提供し、ユーザーのデータ所在や同意ポリシーを厳格に遵守します。

本ガイドでは、Agent Fawkes の使用方法について説明します。Agent Fawkes のアーキテクチャおよびデータセキュリティポリシーの詳細については、AI Assistant 概要 を参照してください。

AI Assistant を有効化する​

important

Account admin の役割を持つコンソールユーザーのみが、AI Assistant 機能を有効にできます。

PhoenixAI Cloud アカウント内のすべてのコンソールユーザーに対して AI Assistant を有効化するには、次の手順を実行します。

  1. PhoenixAI Cloud コンソール にサインインします。
  2. 左側のナビゲーションペインで Account > Account settings を選択します。
  3. Account settings ページの Advanced settings タブで、AI Assistant スイッチをオンにします。
  4. 表示されるダイアログで Accept & Enable をクリックします。

AI Assistant を有効化すると、アカウント内の任意のクラスターの PhoenixAI Studio から利用できるようになります。

Agent Fawkes と対話する​

  1. PhoenixAI Cloud コンソール にサインインします。
  2. 左側のナビゲーションペインで Clusters を選択します。
  3. Clusters ページで、開きたいクラスターをクリックします。
  4. クラスターの詳細ページで、Open cluster をクリックします。
  5. Connect to your Cluster ページで、クラスターにアクセスするための Username と Password を入力し、Sign in をクリックして PhoenixAI Studio を開きます。
  6. PhoenixAI Studio の SQL editor タブで Agent Fawkes をクリックし、Agent Fawkes とのチャットを開始します。

Agent Fawkes

Agent Fawkes とのチャットを通じて、以下の操作を実行できます。

  • Agent Fawkes にクラスターのメタデータの確認を依頼する。
  • Agent Fawkes にクエリ、DDL、DML 操作用の SQL 文の生成を依頼する。
  • Agent Fawkes に SQL 文の修正、書き換え、最適化、説明を依頼する。
  • Agent Fawkes にドキュメントに基づいたデータベース利用に関する質問をする。
  • Agent Fawkes に、特定のクエリの実行状況を分析依頼する。

クラスターのメタデータを確認する​

Agent Fawkes との対話により、データベーススキーマ、テーブルの DDL、パーティション情報、ロードタスクのステータスなど（これらに限りません）、クラスターのメタデータを確認できます。たとえば、「データベース xxx 内のすべてのロード処理のステータスをまとめてください」と Agent Fawkes に依頼できます。

Agent Fawkes はまず対象メタデータへのアクセス許可をリクエストし、リクエストが承認されると、要求された情報を返します。

Monitor Load Task Status

注記

クラスターのメタデータ（データベーススキーマやタスクステータス）は、ユーザーの同意を得て読み取られます。一度のみ許可またはこのセッションのみ許可を選ぶことができます。この選択はスレッド単位で記憶されます。

SQL を生成する​

自然言語で要件を記述し、Agent Fawkes に SQL 文の生成を依頼できます。たとえば、「整数型の user_id 列、文字列型の city 列、日付型の register_date 列を持つ主キーテーブルを作成する SQL を生成してください」といった指示が可能です。

Agent Fawkes は要求に応じた SQL 文を返します。Run SQL をクリックして直接実行するか、Insert to Editor をクリックして SQL エディタに挿入し、編集することもできます。

Generate SQL

SQL の修正・書き換え・最適化・説明​

エラーで失敗した SQL 文の修正、パフォーマンス向上のための書き換えや最適化、または自然言語での説明を Agent Fawkes に依頼できます。

Explain SQL

注記
  • Agent Fawkes とのチャットに加え、SQL 実行が失敗した後、SQL エディタの結果エリアで Help me fix をクリックすることで、Agent Fawkes に SQL の修正を依頼することもできます。
  • Agent Fawkes とのチャットに加え、SQL エディタで対象の SQL 文を選択し、文の横にある Explain をクリックすることで、Agent Fawkes に SQL の説明を依頼することもできます。

データベースの利用方法に関する質問にお答えする​

特定機能の使い方について Agent Fawkes に質問できます。たとえば、「特定のテーブルで Flat JSON を有効化する方法は？」といった質問が可能です。

Agent Fawkes は、説明、例、および該当機能のドキュメントへの URL リンクを提示します。

Ask Questions

クエリのパフォーマンスを分析する​

Agent Fawkes に、クエリ ID に基づいて特定のクエリのパフォーマンスを分析するよう依頼できます。たとえば、「クエリ <query_id> のパフォーマンスを分析してください」と Agent Fawkes に指示することができます。

Agent Fawkes は、クラスタ内の VM 上で、そのクエリのテーブル DDL、SQL 文、実行プランを収集し、クエリのパフォーマンスレポートを生成します。レポートは、「症状」、「メカニズム」、「プロファイルの概要」、「調査結果」、「最適化の提案」の 5 つのセクションで構成されています。「調査結果」および「最適化の提案」の項目は表形式で一覧表示され、重大度または優先度ごとに分類されています。

Analyze Performance

注記
  • Agent Fawkes とのチャットに加え、Query insights タブに移動し、分析したいクエリを選択して、Help me analyze をクリックすることで、Agent Fawkes にクエリのパフォーマンス分析を依頼することもできます。
  • パフォーマンスレポートには、元のSQL文は含まれません。
  • 実行中のクエリの分析はサポートされていません。

クエリ結果に基づくチャートの生成​

クエリ実行後、SQL エディタの結果エリアで Create BI Plot をクリックすることで、クエリ結果に基づいたチャート（棒グラフ、円グラフ、ドーナツチャート）を Agent Fawkes に生成させることができます。

Generate Charts

AI Assistant を無効化する​

AI Assistant を無効化するには、次の手順を実行します。

  1. PhoenixAI Cloud コンソール にサインインします。
  2. 左側のナビゲーションペインで Account > Account settings を選択します。
  3. Account settings ページの Advanced settings タブで、AI Assistant スイッチをオフにします。
  4. 表示されるダイアログで Disable & Delete Data をクリックします。
important

AI Assistant を無効化すると、アカウント全体のすべての AI チャットセッションデータが完全に削除されます。この操作は元に戻せません。