> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kanaeru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# オートメーション

> スケジュール、API 呼び出し、署名付きウェブフックをきっかけに Kana を実行します。

オートメーションは、トリガーが発火したときに Kanaeru が代わりに実行する保存済みのプロンプトです。毎晩の依存関係チェック、週次レポート、他のシステムで起きたイベントへの対応など、定期的な作業に使います。

## トリガー

| トリガー | 発火する条件 |
| - | - |
| **スケジュール** | 選択したタイムゾーンで cron 式に一致したとき |
| **API** | オートメーションのエンドポイントが API キー付きで呼び出されたとき。[オートメーションをトリガーする](/ja/api/introduction)を参照してください |
| **ウェブフック** | 設定したイベントフィルターに一致する署名付きウェブフックを受信したとき |

## オートメーションを作成する

ユーザーメニューの **自動化** またはワークスペースのメニューの **設定** を開くと、そのワークスペースの設定ページにオートメーションが表示されます。そこで作成するか、チャットで Kana に設定を依頼します。Kana はオートメーションの下書きを作成できますが、新しいオートメーションはすべて **無効** の状態で作成されます。内容を確認し、自分で有効にしてください。

オートメーションには次の項目があります。

* **名前**、任意の **説明**、実行する **プロンプト**。
* **トリガー**。
* **実行モード**：自分のマシン上で Claude Code または Codex を使って実行します。
* **オートメーションセッション**：ネイティブセッション、Koa セッション、計画セッション、振り返りセッションなど、プロンプトをどの種類の Kana セッションとして実行するかを選びます。
* **対象**：**自分のみ** です。**チーム** も表示されますが、チームで共有するマシンが必要で、現在すべてのマシンは個人に属しているため、まだ選択できません。

<Note>
  オートメーションは作成者のエージェントマシンで実行されるため、実行が発火する時点でそのマシンが接続されている必要があります。マシンがビジー状態またはオフラインの場合、実行はマシンを待ちます。オートメーションを別のマシンに移せるのは作成者だけです。
</Note>

ワークスペース内で作成したオートメーションは、そのワークスペースに属します。Kana はワークスペースを指定せずにオートメーションを作成することもでき、その場合は組織全体に適用されます。Kana が返すリンクから組織全体の **オートメーション** ページを開けます。

オートメーションを変更できるのは、作成者、またはオーナーか管理者だけです。それ以外の人もオートメーションを開いて **自分用コピーとして保存** を選ぶと、自分専用・自分のマシン用のコピーを作成できます。コピーは無効の状態で作成され、元のオートメーションはそのまま残ります。

## 実行

トリガーが発火するたびに実行が作成され、**待機中**、**マシン接続待ち**、**実行中** を経て、**完了**、**失敗**、**キャンセル済み** のいずれかになります。あなたの入力が必要な実行は **入力待ち** で一時停止します。各オートメーションは実行履歴を保持します。

有効にせずにオートメーションを試すには、**実行** を選んで 1 回トリガーします。

## ターミナルから

```bash theme={null}
kana automations list
kana automations create --file nightly-deps.json
kana automations trigger <automation-id>
kana automations runs <automation-id>
kana automations enable <automation-id>
```

[`kana automations`](/ja/cli/reference) を参照してください。


## Related topics

- [APIの概要](/ja/api/introduction.md)
- [コマンドリファレンス](/ja/cli/reference.md)
- [設定とプロフィール](/ja/guides/settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.