カスタム AI アクション - Read Frog 内に独自の読み取りツールを構築

カスタム AI アクションで Read Frog を独自の AI ワークスペースに変える

翻訳は読書の一部にすぎません。記事をより簡単な言葉で書き直したい場合があります。簡単な要約、語彙リスト、または他の場所にコピーできる構造化された回答が必要な場合があります。

カスタム AI アクションはまさにそれです。

カスタム AI アクションを使用すると、Read Frog 内で独自のプロンプトを定義し、選択ツールバーから直接実行できます。任意のページ上のテキストを選択し、アクションをトリガーすると、実際に関心のあるタスクに合わせた結果が得られます。

構築できるもの

カスタム AI アクションは、迅速なユーティリティと反復可能なワークフローの両方に十分な柔軟性を備えています。

• 長い段落を 3 つの箇条書きで要約する
• 難しい文を平易な英語で説明する
• テキストをより自然なトーンで書き直す
• 重要な用語と定義を抽出する
• メモを JSON のような構造化された出力に変える
• 選択したテキストから学習カード、アウトライン、またはアクションアイテムを作成します

すでにさまざまなジョブにさまざまなモデルを使用している場合、この機能によりワークフローが大幅に高速化されます。

どこで設定するか

現在の拡張コードでは、カスタム AI アクションは独自の設定ページに存在します。

1. Read Frog オプション ページを開きます。
2. 左側のサイドバーで、カスタム AI アクションを開きます。
3. 少なくとも 1 つの LLM プロバイダー がすでに有効になっていることを確認してください。

最後のステップが重要です。この機能は構造化 AI 出力に依存しているため、有効な LLM プロバイダーがない場合、設定 UI は作成をブロックします。

現在どのようなテンプレートが存在するか

アクションの追加ダイアログには現在 3 つのテンプレートが付属しています。

• 辞書: 用語を検索し、用語、音声、品詞、定義、段落、段落翻訳、CEFR 難易度などのフィールドを返します。
• ライティングの改善: 文法と表現の問題を分析し、エラー分析と改善されたバージョンを返します。
• 空白: 単一のデフォルトの結果フィールドを使用して最初から開始します。

拡張機能の構成には、組み込みのデフォルト アクションもあります。Dictionary は DEFAULT_CONFIG.selectionToolbar.customActions で事前に作成されます。

したがって、この機能をインストールし、手動で何も追加しない場合、製品はすでに辞書検索を最初のカスタム AI アクションとして扱います。

実際に設定する内容

カスタム AI アクション エディターは現在、次のフィールドを公開しています。

• 名前
• アイコン (アイコン化)
• プロバイダ: 構造化出力をサポートする有効な LLM プロバイダである必要があります
• システムプロンプト
• プロンプト
• 出力スキーマ

出力スキーマは最も重要な部分です。スキーマの各フィールドには次のものがあります。

• フィールド名
• フィールド タイプ: 現在 string または number
• 説明
• 会話を有効にする

少なくとも 1 つの出力フィールドが必要で、フィールド名は一意である必要があります。

使用できるプロンプト トークン

コードは現在、システム プロンプトとプロンプトの両方で 4 つの挿入可能なトークンをサポートしています。

• {{selection}}: 選択された正確なテキスト
• {{paragraphs}}: 空白行で結合された交差する段落テキスト
• {{targetLanguage}}: ユーザーの現在のターゲット言語
• {{webTitle}}: ページのタイトル

ソースからの便利な実装詳細の 1 つ: {{paragraphs}} は、カスタム アクション リクエストに送信される前に最初の 2000 文字に切り詰められます。

結果はどのようになるか

カスタム AI アクションは、緩いチャット BLOB を返しません。この拡張機能は、スキーマから構造化された出力コントラクトを構築し、モデルに JSON オブジェクトを 1 つだけ返すように要求します。

次に、Read Frog はそのオブジェクトを選択ツールバーの結果パネル内のフィールド行にレンダリングします。

• 文字列フィールドと数値フィールドはタイプ別に表示されます
• 各行はフィールド名をラベルとして使用します
• フィールドで発言を有効にすると、そのフィールドには発言ボタンが表示されます

これは、一般的なプロンプト ボックスよりも機能を再利用しやすくする部分です。

最初のアクションを作成するための実践的な方法

適切な最初のカスタム アクションが必要な場合は、空白 を使用して次のように入力します。

名前

Reading Summary

システムプロンプト

You are a concise reading assistant.
Summarize the selected content using the required structured output.
Prefer concrete wording over vague abstraction.

プロンプト

Selection: {{selection}}

Paragraphs: {{paragraphs}}

Target language: {{targetLanguage}}

Webpage title: {{webTitle}}

出力スキーマ

• summary -> string
• keywords -> string
• nextSteps -> string

これにより、同じプロンプトを毎回書き直すことなく、記事、ドキュメント、チュートリアルで動作する繰り返し可能な読み取りヘルパーが得られます。

ソースベースの推奨事項

この機能を初めて使用する場合は、大規模なワークフローを考案することから始めないでください。

付属のテンプレートの 1 つから始めます。

• 別の言語で読んで語彙のヘルプが必要な場合は、辞書 を選択してください
• 自分のテキストを頻繁に編集する場合は、文章の改善を選択してください
• 返したい正確な構造がすでにわかっている場合は、空白 を選択してください

これは、カスタム AI アクションを空の AI サンドボックスのように扱うよりも、現在の製品設計にはるかによく一致します。この拡張機能は、選択ツールバーから直接実行される、小規模で反復可能な構造化されたアクション向けに明らかに最適化されています。