---
title: "コンテキストに応じたOrylo Actions"
description: "適切なコンテキストで再利用可能なActionを表示し、必要な入力を組み合わせ、実行方法と結果の出力先を細かく指定できます。"
locale: "ja"
canonical: "https://orylo.io/ja/docs/actions"
product_status: "in-development"
last_reviewed: "2026-10-12"
---

# コンテキストに応じたOrylo Actions

適切なコンテキストで再利用可能なActionを表示し、必要な入力を組み合わせ、実行方法と結果の出力先を細かく指定できます。

<a id="context-aware"></a>

## 現在のコンテキストに合ったActions

OryloのActionでは、利用できるタイミング、実行する内容、結果の出力先の3つを設定します。Action Barは、現在のコンテキストを有効な各Actionのルールと照合します。あらかじめすべてを新しい会話にコピーする必要はありません。

コンテキストに応じるとは、取得したコンテキストを設定済みのルールと照合することです。画面を常時監視したり、Actionを自動実行したりすることではありません。条件に合うActionのうち、どれを実行するかは自分で選びます。

| コンテキスト | 提供される情報 |
| --- | --- |
| 選択テキスト | 選択したテキスト。書き換え、翻訳、Promptizeなどに役立ちます。 |
| ファイル、フォルダ、画像 | 設定された入力に応じた、選択中のファイルや画像、またはフォルダのパス。 |
| Webページ | 現在のページのURL。ページ本文が自動でコピーされるわけではありません。 |
| フォーカス中のウィンドウ | アプリの識別情報、取得可能なウィンドウタイトル、必要に応じて撮影するスクリーンショット。キャプチャには権限が必要です。 |
| アプリケーション | アクティブなアプリの識別情報。必要に応じて特定のアプリを条件に指定できます。 |

<a id="match-rules"></a>

## Actionを表示する条件を決める

Primary Context（主要コンテキスト）を選びます。これは必須で、主な入力を定義します。追加のコンテキストがすべて必要な場合はAll Of条件を、複数の候補のうち少なくとも1つが必要な場合はAny Of条件を追加します。AI Actionには、最初に一致した候補だけでなく、設定したコンテキストのうち実際に利用可能なものがすべて渡されます。

たとえば、Selected TextとWeb Pageを必須にすると、テキストとページURLの両方が利用可能な場合にのみActionが表示されます。特定のアプリだけでActionを使えるようにするには、Applicationを必須条件にして、そのアプリを選びます。Applicationを任意の条件にしただけでは、そのアプリだけに限定されるとは限りません。

これらのルールは利用可否を制御します。ファイルへのアクセス権や画面収録の権限を付与するものではありません。Actionが表示されない場合は、有効になっているか、必要なコンテキストがあるか、入力元のアプリは何か、キャプチャ権限があるかを確認してください。

<a id="operations"></a>

## 処理と結果の出力先を選ぶ

AIの結果は、結果パネル、クリップボード、Composer、元の選択テキストの置き換え、または自動出力なしから選べます。バックグラウンドで実行したコマンドの出力は、パネル、クリップボード、Composerに送れます。新しいTerminalで実行した場合、出力はOryloに取り込まれません。Webページを開く処理は、設定されたURLを開くだけです。

Actionの動作に加え、名前、説明、アイコン、有効・無効、表示順もカスタマイズできます。コマンドは実行前に確認してください。コマンドはMac上で実行され、Actionとして登録しただけで安全になるわけではありません。

| 処理 | カスタマイズと制約 |
| --- | --- |
| AI Action | Assistantと指示を選びます。主要コンテキストと、設定した追加コンテキストのうち利用可能なものが渡されます。Chat Assistantは提供された内容から生成し、Agent Assistantは設定済みのツールを使用できます。 |
| Open Web Page | URLテンプレートを設定します。選択テキストやページURLを、エンコードされたコンテキストとしてプレースホルダーに埋め込めます。追加条件は利用可否の判定にのみ使われ、URLには渡されません。 |
| Run Command | スクリプト、作業ディレクトリ、タイムアウト、バックグラウンド実行または新しいTerminalでの実行を設定します。データとして渡されるのは主要入力のみです。現在、アプリやウィンドウの入力からスクリプトにコンテキストのテキストは渡されません。 |

<a id="create"></a>

## Create with Chatを使う、または自分で設定する

1. **ワークフローを説明する** — Settings → Actions → 追加 → Create with Chatを開きます。主要入力、必要なコンテキスト、処理、必要に応じてAssistant、結果の出力方法を指定します。作成には、すでに動作するAgent Assistantが必要です。
2. **提案された定義を確認する** — プレビューを依頼し、一致条件、指示またはコマンド、対象のAssistant、出力先を確認します。意図した設定だけを保存してください。保存してもActionは実行されません。
3. **小さな例で試す** — 対象のアプリとコンテキストに戻り、Action Barを開いて、保存したActionを明示的に実行します。Settingsで調整するか、作成時の会話を続けてください。Create Manually（手動で作成）も利用できます。

<a id="groups"></a>

## Action Groupsで選択肢を整理する

Groupは選択肢をまとめたメニューであり、すべての子Actionを順番に実行するものではありません。たとえば、選択テキスト用のグループに、AIによる説明、Web検索、ローカルコマンドを用意できます。グループを開き、Actionを1つ選んで実行します。

子Actionはグループの入力と表示条件を共有しますが、処理や結果の出力先はそれぞれ変えられます。グループを入れ子にはできません。全体が無効になっているグループには、利用できる項目がありません。

<a id="sharing"></a>

## Action 定義の共有と高度なカスタマイズ

Action と Action Group は JSON のインポートとエクスポートに対応しています。利用前に条件、指示、コマンド、出力先を確認してください。参照先の Assistant は受け取り側の Mac で解決できる必要があり、表示名が同じだけでは不十分です。

JSON では除外条件（None Of）も指定できますが、現在のビジュアルエディタにはその設定項目がありません。固定のローカル作業ディレクトリを指定したコマンドは、現在エクスポートできません。共有用の定義に取得済みの入力、実行履歴、ローカルの並び順設定は含まれません。

<a id="run"></a>

## 実行して進行状況を確認する

1. **コンテキストを用意する** — 必要なテキスト、ファイル、フォルダ、画像を選択するか、該当するアプリやウィンドウにフォーカスを合わせます。Settingsで設定したショートカットでAction Barを開きます。
2. **条件に合うActionを選ぶ** — 実行前に何をするActionか確認してください。AI Actionは独立した実行セッションを使用し、開いている会話の履歴は使いません。以前のチャットのコンテキストを引き継ぐとは考えないでください。
3. **進行状況と出力を確認する** — 展開したAction BarからAction Executionsを開くと、実行中や最近の結果、途中の出力、エラーを確認できます。バーを非表示にしても実行はキャンセルされません。停止するには、実行の詳細画面で明示的に停止してください。

<a id="control"></a>

## 出力方法と権限を管理する

自動置き換えを利用できるのは、選択テキストを主要入力とするAI Actionだけです。利用できるかどうかは、入力元のアプリと、元の選択範囲が引き続き有効で編集可能かどうかによります。結果の出力に失敗した場合は、変更などの影響を伴う可能性のあるタスクを再実行せず、保持されている結果を確認してください。

Actionsには、対話形式で権限を承認するフローがありません。新たな承認が必要なリクエストが、黙って許可されることはありません。承認のやり取りが必要な作業には、通常の会話を使ってください。Agentに既存の権限があるかどうかも引き続き関係します。

実行記録は現在のアプリセッション内で一時的に保持されるもので、永続的な会話履歴ではありません。アプリを再起動すると失われます。残したい結果はコピーまたは保存してください。任意で利用できるActionの提案機能はデフォルトでオフになっており、確認可能な下書きを作るだけです。Actionが自動で有効化されたり、実行されたりすることはありません。

## 関連する記事

- [Create with Chat](https://orylo.io/ja/docs/create-with-chat)
- [テキスト、ファイル、コンテキスト](https://orylo.io/ja/docs/context-attachments)
- [Skillsを使う](https://orylo.io/ja/docs/skills)
- [権限と操作の管理](https://orylo.io/ja/docs/permissions)
- [Orylo Intelligence](https://orylo.io/ja/docs/orylo-intelligence)