---
id: tasks
title: タスクを作って実行する
category: basic
order: 20
keywords: [タスク作成, piece選択, 添付, 詳細設定, 可視性, ask policy]
---

## 新しいタスクを作る

タスク一覧の上部にある **「新しい Task」ボタン** を押すと、作成ダイアログが開きます。最低限必要なのは「依頼内容」だけです。

### 依頼内容

「依頼内容」テキストエリアに、エージェントへの指示を書きます。`Ctrl+Enter`（Mac は `Cmd+Enter`）で送信できます。

書き方のコツ:

- **何をしてほしいか** を最初の 1〜2 行で書く
- **出力形式** を指定する（例:「output/report.md に Markdown で」「1500 字以内で」）
- **観点・制約** を補足する（例:「主要 3 社を比較」「商用利用前提で」）
- 参照すべき URL があれば添える

依頼が曖昧だと、エージェントが確認を返して `waiting_human` で一時停止することがあります。

### 添付ファイル

ダイアログのドロップゾーンにファイルをドラッグ&ドロップ、またはクリックで選択して添付できます。添付したファイルはワークスペースの `input/` に保存され、エージェントが読み込めます。依頼文で「input のファイルを読んで」と明示すると確実です。

## 詳細設定

「詳細設定を開く」を押すと、次の項目を調整できます。

### タスクタイプ（piece）

`自動選択` のままにすると、依頼内容から最適な piece が自動で選ばれます。特定の piece で実行したいときだけ、ドロップダウンから選んで固定します。piece については [piece を使う・作る](./05-pieces.md) を参照。

### プロファイル / 優先度

- **プロファイル**: `auto` / `fast` / `quality` — どの種類のワーカーで実行するか
- **優先度**: `low` / `medium` / `high` — ワーカーが拾う順番に影響します

### 出力形式

`markdown` / `text` / `json` から選べます。最終回答の形式の指針になります。

### 質問ポリシー（ask policy）

エージェントが不明点をどれくらい確認してくるかを決めます。

- **low（少なめ）**: できるだけ自分で判断して進める（デフォルト）
- **high（積極的に質問）**: 不明点があれば止まって確認する

### MCP / Skills のトグル

- **MCP ツールを無効化（トークン節約）**: このタスクでは外部サービス連携（MCP）のツールを使いません。詳しくは [MCP 連携](./13-mcp.md)
- **Skills を無効化**: このタスクでは Skills を読み込みません。詳しくは [Skills を使う](./11-skills.md)

どちらも、不要なツール定義を外してトークンを節約したいときに使います。

### ブラウザセッション

有効なブラウザセッションが登録されている場合のみ表示されます。選ぶと、エージェントがそのサイト用の保存済みログインを使ってブラウズします。

## 公開範囲（可視性）

作成したタスクを誰が見られるかを設定します。

| 選択肢 | 見られる範囲 |
|---|---|
| 非公開 | 自分のみ（管理者は閲覧可） |
| 組織 | 同じ組織（Gitea organization）のメンバー |
| 公開 | ログイン済みの全ユーザー |

「組織」は Gitea でログインしていて、所属組織がある場合のみ選べます。組織が複数あるときは共有先を選択できます。

## 定期実行

「定期実行」にチェックを入れると、毎日 / 毎週 / 毎月 / cron 式 / 一度きり の自動実行を設定できます。詳しくは [スケジュール実行](./06-schedules.md) を参照。

## 作成したあと

「Task 作成」を押すとタスクは `queued`（順番待ち）で登録され、ワーカーが拾うと数秒で `running`（実行中）に変わります。

そこから先 — エージェントの動きをリアルタイムで見たり、途中で指示を追加したりする方法は [実行中のタスクを見る・介入する](./03-running.md) を参照してください。
