# アシスタントと作業する

草稿の推敲、ビルドの修復、文献探しを行い、プロジェクト内でアシスタントの作業を追えます。

必要な結果を伝えてください。アシスタントは同じワークスペース内で、ファイルの読み取り、編集、論文のコンパイル、出力の確認を行えます。

> この論文をコンパイルし、エラーを読んでビルドを直してください。もう一度コンパイルして結果を確認してください。

アシスタントパネルを開き、接続済みのモデルか [CLI エージェント](/docs/cli-agents/)を選びます。どちらの方法も [AI のセットアップ](/docs/ai-setup/)で説明しています。

![アシスタント、そのスキル、入力欄のコントロールを横に並べた LaTeX エディタ](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png)

## 適切なコンテキストを渡す

質問する前に、`@` でファイルやフォルダをメンションする、参考資料を添付する、または該当箇所を選択します。ファイルをメンションするとファイルの内容が渡され、フォルダをメンションすると、アシスタントが必要な資料を見つけられるよう一覧が渡されます。

内蔵アシスタントは、開いているファイル、選択範囲、構成、コンパイルの状態といったプロジェクトのコンテキストを持った状態で始まります。さらに必要な情報はツールで読み取れます。[リンクしたフォルダ](/docs/linked-folders/)を使うと、原稿フォルダの外にあるデータや PDF を参照できます。

## ウェブとほかのアプリ

入力欄で**ウェブ**をオンにすると、アシスタントがウェブを検索し、ページを読めるようになります。Anthropic の最近の Claude モデルと OpenAI の最近のモデルは、それぞれのプロバイダ独自の検索を使います。そのほかのモデルはページを直接読み、設定で追加した検索用のキーで検索します。回答には使ったアドレスが残るので確認でき、アシスタントはページのテキストを読む材料として扱い、指示としては扱いません。

学術誌の投稿フォームや統計ソフトなど、ウェブサイトやコンピュータ上のプログラムをエージェントに操作させるには、**設定 → 連携**で**デスクトップアプリ**を設定します。これは Cua Driver を実行するもので、Cua Driver は自分でインストールします。使ってよいアプリとウェブサイトを選び、クリックやキー入力のたびに確認が入ります。Oleafly のリンクは、既定のブラウザで開きます。

## 作業を追う

返信には、テキスト、ツールの動作、提案された変更、進捗が順に表示されます。ツールカードを展開すると出力を読めます。コンパイル結果からはログや PDF へ、文献の検索結果からは論文へ移動できます。

| 依頼の例 | アシスタントが扱えるもの |
| --- | --- |
| セクションを改善する | プロジェクトのファイル、選択したテキスト、あなたの指示、編集できる差分 |
| ビルドを直す | コンパイラ、診断、ログ、PDF のテキスト |
| 裏付けとなる文献を加える | OpenAlex の検索、メタデータの照会、あなたの参考文献 |
| 図を描く | LaTeX の TikZ や PGFPlots、Typst の CeTZ や fletcher、図単体のプレビュー、図の挿入 |
| 論文をレビューする | 原稿、参考文献、リサーチノート、[レビュー用のスキル](/docs/workflows/review-and-submit/) |

利用できるツールは、ドキュメントエンジンと選択したランタイムによって変わります。ツールのコントロールで、使うグループを選べます。図のツールは LaTeX と Typst のプロジェクトで使え、Markdown では使えません。

文献検索には、 **設定 → 連携 → 引用検索**に保存した OpenAlex の API キーと連絡先メールアドレスを使います。[alphaXiv に接続](/docs/integrations/research-sources/#alphaxiv)すると、アシスタントは alphaXiv 上の論文の検索と閲覧、alphaXiv ライブラリの利用もできます。alphaXiv を呼び出すたびに、事前に確認が入ります。

## 編集の前にプランを立てる

先にいくつか決めておきたい作業では、 **プラン**をオンにします。アシスタントはチェックリストを作る間、読み取りと検索ができます。編集、コンパイル、コマンドの実行は行わず、待機します。

プランが表示されたら、 **プランを承認**か**修正を依頼**を選びます。フィードバックを入力することもできます。作業中は、進捗表示に現在のステップと変更されたファイルが示されます。プランを承認しても、選択済みの編集の承認ポリシーはそのままです。

プランモードでも、プランを書かずに答えるモデルがあります。その場合、返信の下に「承認するプランはまだありません。アシスタントにプランを頼むか、プランをオフにしてください。」というメモが表示されます。修正を依頼しても同じ内容で返ってきたときは、「プランは変わっていません。」と表示されます。

## 提案された編集を確認する

変更を適用する前に確認したいときは、 **承認を求める**を選びます。差分を読んで、操作を承認または拒否します。 **自動で承認する**と**フルアクセス**では、アシスタントに任せる範囲が広がります。現在のポリシーは画面に表示されます。

どのポリシーでも、やり取りが終わったあとで変更を確認し、元に戻せます。エージェントの作業が終わってから、プロジェクトのコピー上で確認したい場合は、[調査タスク](/docs/research-tasks/)を使います。タスクでは、選んだファイルだけを適用できます。

## やり取りを確認して元に戻す

アシスタントや [CLI エージェント](/docs/cli-agents/)がファイルを変更すると、返信の下に、変更したファイル数が、追加された行数と削除された行数とともに表示されます。たとえば **3 件のファイルを変更** と表示されます。

- **レビュー**には、各ファイルが「追加」「変更」「削除」のいずれかで一覧表示されます。ファイルをクリックすると差分が表示されます。
- ファイルの**元に戻す**で、そのファイルをやり取りの前の状態に戻します。 **やり直す**で変更が戻ります。
- **すべて元に戻す**は、そのやり取りで変更されたソースファイルをまとめて元に戻します。`.aux` や `.log` などのビルド出力は、 **ビルドファイルが更新されました** の下に別に一覧表示され、元には戻されません。

やり取りのあとにもう一度変更されたファイルは、元に戻す操作の対象外になり、「このやり取りのあとに変更されました」と表示されます。 **すべて元に戻す**は、やり取りの最中にあなた自身が編集したファイルと、アシスタントが Git にコミットしたファイルも対象外にします。コミットしたファイルには、「(コミット) でコミット済み」の形で、そのコミットが表示されます。元に戻す操作とやり直す操作は、エージェントの作業が終わってから使えます。同じプロジェクトで別のエージェントが同時にファイルを変更した場合は、ファイルを 1 つずつ元に戻してください。

元に戻す操作は、Oleafly が各やり取りの前に作るプロジェクトのコピーを使います。コピーは Oleafly 専用のデータフォルダ `~/.oleafly/agent-turns` に置かれ、プロジェクト内には作られません。25 MB を超えるファイルはコピーされないため、元に戻せません。ファイルが 20,000 件、または 512 MB を超えるプロジェクトや、コピーに時間がかかりすぎるプロジェクトでは、そのやり取りのコピーは作られず、元に戻せないことが表示に示されます。Oleafly は、過去 14 日間のすべてのやり取りと、各プロジェクトの最新 100 件のやり取りについて、コピーを保持します。それより古いやり取りには「このやり取りは、もう元に戻せません。」と表示されます。

## 実行中に方向を変える

アシスタントの作業中に追加のメッセージを送り、 **今すぐ差し込む**を選ぶと、次に安全なタイミングで届けられます。例:

> 既存の記法は維持してください。修正は式 (3) の下の説明に絞ってください。

先に実行が終わった場合、そのメッセージは次のやり取りになります。 **停止**で実行中の作業を取り消せます。

## うまくいった手順を再利用する

`/` を入力して[スキル](/docs/skills/)を選ぶか、役に立った会話のあとで**スキルを記録**を使います。スキルには、複数の論文で繰り返す手順を記録できます。主張の確認、図の準備、査読への回答書の下書きなどです。

同梱のスキルのいくつかは、LaTeX だけでなく Typst にも対応しています。`oleafly-figure-prep` は CeTZ と fletcher の図を描き、`citation-management` は Hayagriva 形式の参考文献を書け、`oleafly-response-letter` は Typst の論文向けに Typst で回答書を書き、`oleafly-pre-submission` には Typst プロジェクト向けのチェックがあります。

ペルソナと常設の指示は、AI の設定にあります。綴り、文体、記法などの好みに使います。

## 履歴と使用状況

チャット履歴を開くと、以前の会話に戻れます。復元ポイントが保存されている返信には、 **この応答より前の状態にコードを戻す**が表示されます。チャットの範囲を超えたドキュメントの履歴には、[バージョン管理](/docs/checkpoints/)を使います。

使用状況カウンターを押すと[使用状況レポート](/docs/ai-usage/)が開き、プロジェクト、エージェント、モデル、日付で作業を絞り込めます。

ホスト型のモデルには、渡したコンテキストが送られます。モデルへのリクエストを自分のコンピュータ内にとどめたいときは、ローカルモデルを使います。アシスタントのヘッダーにあるピクチャ・イン・ピクチャのボタン**アシスタントを浮かせる**を押すと、パネルが[エディタ](/docs/editor/)の上に浮かびます。 **元の位置に戻す**で、サイドバーに戻ります。

## 新しいチャット

![アシスタントのツールバーには、MCP の設定、ツールの管理、設定、使用状況、新しいチャット (+)、履歴、フロート表示があります。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png#view=1439,45,479,49)

アシスタントのヘッダーで**新しいチャット**をクリックすると、別の会話が始まります。質問や章が変わるときは新しいチャットにすると、コンテキストを追いやすくなります。新しいチャットは、設定済みの既定のモデルで始まります。

## チャット履歴

**チャット履歴**をクリックすると、過去の会話を開き直せます。前の結果を修正したいときや、どうやってその結果になったかを尋ねたいときは、既存のメッセージの続きから進めます。

## ファイルを添付する

![メッセージ欄の下の + で「コンテキストを追加」が開きます。承認モード、プロンプト、ペルソナ、プランモード、モデル、送信が同じ行に並びます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png#view=1441,973,475,105)

添付メニューを開いて、補助資料を追加します。ファイルピッカーでは、画像、PDF、テキスト、LaTeX、Typst、BibTeX、Markdown のファイルを選べます。送信する前に、入力欄の上にある添付チップを確認してください。

## 添付を外す

添付チップの削除ボタンを押すと、次のメッセージから除外できます。外れるのは下書きのメッセージへの添付で、ディスク上の元のファイルは削除されません。

## ファイルやフォルダをメンションする

`@` を入力し、候補に出たプロジェクト内の項目を選びます。ファイルをメンションするとファイルの内容が渡され、フォルダをメンションすると、次に何を読むかをアシスタントが決めるための一覧が渡されます。ファイルが長い場合は、プロンプトでも該当するセクションを指定してください。

## プロンプト

**プロンプト**を開くと、用意された依頼の出だしを選べます。選ぶと入力欄に文面が入るので、送信する前に今の論文に合わせて手直しできます。セクション名や失敗したコンパイルなど、具体的な対象を含めてください。

Typst プロジェクトでは、プロンプトが LaTeX ではなく Typst を求める内容になります。 **LaTeX のエラーを直す**は**Typst のエラーを直す**に、 **TikZ の図**は**CeTZ の図**に変わり、数式、表、プレゼンテーションのプロンプトは、Typst の数式、Typst の表、Typst のスライドを作ります。

## ペルソナ

入力欄でペルソナを選ぶと、保存してある指示のプリセットが使われます。既定の指示に戻すには**なし**を選びます。ペルソナを有効にすると、既定のカスタム指示の文章の代わりにペルソナの指示が使われます。どちらの設定方法も[指示と承認](/docs/ai-instructions/)で説明しています。

## モデルの選択

設定済みのプロバイダと、有効にしたモデルを選びます。作業に必要な機能を持つモデルを選んでください。画像を扱う作業には画像対応が、複数のステップにわたるプロジェクト作業にはツールの利用が必要です。エンドポイントやモデルを変更したあとに機能の確認をやり直したいときは、 **もう一度確認**を使います。

## 推論の強度

選択したモデルまたはランタイムに推論のコントロールがある場合は、作業に合わせて強度を選びます。選べる値はモデルによって異なります。強度を上げると、応答に時間がかかり、使用量も増えることがあります。短い言い回しの修正には、原稿を詳しくレビューするときほどの強度は通常必要ありません。

回答の前に思考するローカルの Ollama や Lemonade のモデルでは、**なし**を選ぶと思考のステップを省けます。[思考のステップを省く](/docs/ollama/#skip-the-thinking-step)を参照してください。

## 送信

**送信**をクリックすると、選択した添付、モデル、ペルソナ、承認モードとともにメッセージが送られます。複数のファイルが関わる依頼は、送信する前にもう一度読み返してください。

## 停止

**停止**をクリックすると、実行中の作業を取り消せます。アシスタントに続きを頼む前に、すでに加えられた変更を確認してください。実行を止めても、完了した編集は元に戻りません。

## いちばん下へ

以前のツール出力を読んだあと、最新のメッセージに戻るには**いちばん下へ**を使います。作業が続いている間も、上にスクロールして会話を確認できます。

## 予約したメッセージ

実行中に追加のメッセージを送ると、予約されます。 **今すぐ差し込む**を選ぶと、次に安全なタイミングで指示が渡されます。届けなくてよくなった追加のメッセージは、 **予約したメッセージを取り消す**で削除できます。

## 継続するゴール

複数のやり取りで同じ成果を目指したいときは、ゴールを設定します。目標を入力して**ゴールを保存**を選びます。ゴールのチップをクリックすると編集でき、 **ゴールを消去**で削除できます。ゴールは、手法セクションとその図をレビューできる状態にする、といったように具体的にしてください。

## アシスタントの設定

ヘッダーの設定ボタンで AI の設定が開きます。プロバイダの接続、モデルの有効化、指示の編集、ペルソナやスキルの管理に使います。

## アシスタントの MCP 設定

MCP の設定ボタンでは、内蔵アシスタントが使うツール向けの外部サーバーの設定が開きます。これは、外部のアプリケーションから Oleafly を操作できるようにするサーバーとは別のものです。[MCP 接続](/docs/mcp/)をご覧ください。

## 使用状況レポート

使用状況のインジケーターか**使用状況レポート**をクリックすると、記録された作業を確認できます。レポートのフィルターで、プロジェクト、モデル、ランタイム、期間を比べられます。各項目と予算の設定は[使用状況と予算](/docs/ai-usage/)で説明しています。

## 1 つのセクションを最初から最後までレビューする

1. セクションを選択し、入力欄でそのソースファイルをメンションします。
2. 接続済みのモデルと**承認を求める**を選びます。
3. 次のように依頼します。「このセクションを、わかりやすさの観点でレビューしてください。主張、数値、ラベル、引用キーは変えないでください。まず変更を提案してください。」
4. 提案された編集とその説明を読みます。
5. 採用したい変更を承認し、アシスタントにコンパイルを頼みます。
6. 更新したセクションを PDF で確認します。参考文献や図の配置も見ます。
