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

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# Slack エージェントを使う

> Slack で Phaseo エージェントをメンションするか、直接メッセージを送って、質問、モデルの比較、Slack の検索、タスクのスケジュール、ページの公開を行います。

Slack のチャンネルで Phaseo エージェントをメンションするか、直接メッセージを送ると、ワークスペースが選んだモデルでスレッドに回答します。このページでは、エージェントに何を頼めるかを説明します。先に Slack に追加するには、[Slack エージェントを設定する](https://phaseo.app/docs/ja/v1/guides/slack-agent.md)を参照してください。

## Slack でエージェントを使う

* **ダイレクトメッセージ：** Slack のアプリ一覧からエージェントを開き、**Messages** タブに書き込みます。すべてのメッセージに回答します。
* **チャンネル：** エージェントをパブリックまたはプライベートチャンネルに招待してから、メンションします。例：`@Phaseo which model should we use to summarise call transcripts?`。スレッドで回答します。そのスレッドで続けて質問するときも、毎回メンションしてください。

回答中は次のように動作します。

* 会話の流れを追えるように、スレッドの最新の部分を、あなたのメッセージまで読みます。Slack が一度に読ませるメッセージは 15 件で、Phaseo のアプリが読めるのは各 Slack ワークスペースでおよそ 1 分に 1 回です。
  * スレッドの最初のメッセージは常に読みます。
  * ダイレクトメッセージでは、あなたとの会話の最新のメッセージを読みます。
  * チャンネルでは、最大で直近 30 分の最新のメッセージを読みます。
  * 読めた数より多くのメッセージが書かれていた場合は、一部が欠けていることがエージェントに伝えられます。
  * そのとき Slack がスレッドを読ませない場合は、スレッド内の自分の以前の回答をもとに答えます。
* 各スレッドでは、メッセージに 1 件ずつ回答します。さらに最大 5 件のメッセージが順番を待ち、それを超えると前の回答を待つよう伝えます。
* Slack の停止ボタンで、作業中の回答を止められます。
* 各回答の最後には、モデルと、その回答にかかったモデルのトークンの費用が表示されます（例：`Auto → GPT-6 Astra · $0.0031`）。**自動** の場合は、選ばれたモデルが矢印の後に、回答で使ったほかのモデルが + の後に表示されます。モデル名は Phaseo のモデルページに、費用は **ログ** のその回答のリクエストにリンクしています。ログは Phaseo ワークスペースのメンバーが開けます。

各回答にはステップと支出の上限があります。[回答ごとの上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)を参照してください。

## メッセージごとにモデルを選ぶ

オーナーと管理者は、1 件のメッセージに使うモデルを選べるようにできます。**設定 → Slack** の **モデルの選択** で **メッセージごとのモデル選択を許可する** をオンにし、Phaseo カタログから最大 10 個のモデルを追加します。ワークスペースで自動ルーティングを利用できる場合は、**「自動」を含める** で **自動** もリストに加えられます。それ以外のメッセージには、引き続き **エージェント** のモデルが回答します。

モデルを選ぶには、メッセージを `with <model>:` で始め、許可されたモデルを名前または ID で指定します。

```text theme={null}
@Phaseo with Claude Opus 5.5: check this incident summary for gaps
with openai/gpt-6-astra: draft a reply to this customer
```

* 照合するのは許可されたモデルだけで、大文字と小文字は区別しません。許可されたモデルのうち 1 つだけが持つ名前や ID であれば、先頭部分だけでも指定できます。たとえば、リストに Claude のモデルが 1 つしかなければ `with claude:` で選べます。ID はラボ名を省いても使えます（例：`with gpt-6-astra:`）。
* エージェントはそのメッセージに、`with …:` の部分を除いた内容でそのモデルを使って回答し、フッターに回答したモデルを表示します。
* リストにないカタログのモデルを指定した場合や、名前が複数のモデルに当てはまる場合は、選べるモデルの一覧を本人だけに返信し、メッセージには回答しません。そのメッセージは回答として数えません。「With …:」で始まってもモデル名を含まないメッセージ（例：「With regards to the invoice: …」）には、通常どおり回答します。
* どのモデルが回答しても、各回答の[上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)（\$0.50 と 12 ステップ）は変わりません。モデルのトークンは、そのモデルの料金で請求されます。
* **Slack agent** ガードレールは引き続き適用されます。選んだモデルのどのプロバイダーもこれを満たさない場合、エージェントは回答せずにその旨を伝えます。

### 別のモデルに聞く

モデルの選択がオンのあいだは、エージェントは回答中に、許可されたモデルの 1 つにセカンドオピニオンを求めることもできます。たとえば、別のモデルの意見を尋ねたときです。

```text theme={null}
@Phaseo draft a reply to this customer, then ask Claude Opus 5.5 to check it
```

* 相手のモデルに見えるのは、エージェントが送った内容だけです。Slack のスレッドは見えず、Web 検索やツールも使えません。
* エージェントが 1 回の回答でほかのモデルに聞けるのは 3 回までです。その費用は同じ [\$0.50 の上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)に含まれ、回答を書き終えるのに足りないほどしか残っていない場合、エージェントはそれ以上聞きません。
* フッターには使ったすべてのモデルが表示され（例：`GPT-6 Astra + Claude Opus 5.5 · $0.0123`）、費用にもそれらが含まれます。
* モデルを使えない場合（たとえば、どのプロバイダーも **Slack agent** ガードレールを満たさない場合）は、エージェントに理由が伝わり、そのモデルなしで回答します。

### モデルを比較する

許可された 2 つまたは 3 つのモデルが同じ質問にどう答えるかを見るには、メッセージを `compare` で始め、モデルをカンマで区切って並べ、コロンを付けます。

```text theme={null}
@Phaseo compare GPT-6 Astra, Claude Opus 5.5: what are the risks of moving our database to another region?
compare gpt-6-astra, claude, auto: summarise the EU AI Act in five bullet points
```

* モデルは `with <model>:` と同じように、許可されたモデルの中からだけ照合されます。リストにないモデルがある、名前が複数のモデルに当てはまる、モデルが 2 つ未満または 3 つより多い、コロンの後に質問がない、のいずれかの場合、エージェントは本人だけに返信し、メッセージには回答しません。そのメッセージは回答として数えません。`compare the two plans, then pick one: …` のようにモデルをまったく指定していないメッセージは通常のテキストとして扱われ、エージェントはいつもどおり回答します。モデルの選択がオフのときに、カタログのモデルを指定した `compare …:` メッセージには、比較がオフになっていることを本人だけに返信し、回答としては数えません。
* 各モデルが受け取るのはあなたの質問だけで、スレッドのほかの部分は渡されません。各モデルは Web 検索や Web ページの読み込みができ、同時に回答します。
* 返信にはモデルごとのセクションがあり、モデル名（Phaseo のモデルページへのリンク付き）、費用、回答が表示されます。各モデルには短く答えるよう指示しており、長い回答はすべてが 1 つの Slack メッセージに収まるように切り詰められます。
* 失敗したモデルがあれば、そのセクションに理由が表示され、ほかの回答はそのまま表示されます。
* 比較は 1 回の回答として数えられます。\[$0.50 の上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)はモデル間で均等に分けられ、フッターにはすべてのモデルと合計が表示されます。この分割は、モデルに質問するかどうかを決めるだけです。割り当てが $0.02 未満のモデルには質問しません。回答は割り当てに達しても止まらないため、それ以上かかることがあります。その代わり、各モデルの回答の長さに上限があります。

### ボタン付きの質問

先に進む前に、いくつかの選択肢から選んでもらったり、何かを承認してもらったりする必要があるとき、エージェントはスレッドで質問し、選択肢ごとにボタンを表示します（最大 5 個）。**Other…** を出すこともあり、選ぶと自分の言葉で答えるための小さなフォームが開きます。

* 答えられるのは、エージェントが回答している相手だけです。ほかの人がボタンを選ぶと、その人だけに見えるメモが届きます。
* ボタンの代わりにスレッドで返信することもできます（チャンネルではエージェントをメンションします）。その返信が答えとして扱われます。
* 答えると、ボタンがあなたの答えに置き換わり、エージェントは止まったところから続けます。
* 質問は最大 1 時間待ちます。それを過ぎると、質問に期限切れと表示され、回答はそこで終わります。準備ができたら、もう一度質問してください。
* 待っている間も、Slack の停止ボタンを使えます。
* 待っている間、スレッド内のほかの人のメッセージは順番を待ち、誰の答えを待っているかがその人だけに伝えられます。
* 1 つの回答で質問できるのは 3 回までです。全体で 1 回の回答として数えられ、[回答ごとの上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)は、各質問の前後を含めた全体に適用されます。

### Home タブを確認する

Slack でエージェントを開いて **Home** を選ぶと、使い方、使っているモデル、Phaseo アカウントが接続されているかどうかを確認できます。接続されておらず、接続すると役に立つ場合（**連携済みのアカウントのみ** のとき、または利用状況データが許可されている場所）は、タブに **Connect your Phaseo account** ボタンが表示されます。アカウントを接続した Phaseo ワークスペースのメンバーには、今月（UTC）エージェントがこの Slack ワークスペースで回答した数も表示されます。タブに表示されるのは設定と数だけで、メッセージは表示されません。自分が設定した定期タスクと、その次回の実行も表示されます（[スケジュールされたタスク](#scheduled-tasks)を参照）。

独自の Slack アプリでは、Home タブに最新の[マニフェスト](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#use-your-own-slack-app)が必要です。

## グラフ、画像、ファイル

エージェントはスレッドにグラフや画像を投稿し、共有された画像や PDF を読むことができます。

* **グラフ：** グラフを頼みます。例：`@Phaseo chart our spend by week this month`。エージェントは手元の数値から棒グラフ、折れ線グラフ、円グラフのいずれかを描き、画像としてスレッドに投稿します。グラフの文字にはラテン文字とキリル文字を使います。それ以外の文字は回答の本文に書きます。
* **画像：** 画像の作成を頼みます。例：`@Phaseo make an icon of a paper plane in blue`。エージェントの API キーで [GPT Image 2](https://phaseo.app/models/openai/gpt-image-2) を使い、ほかのリクエストと同じように課金されます。画像 1 枚の費用は数セントで、回答の \[$0.50 の上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)に含まれ、回答のフッターにも含まれます。1 回の回答で作成できる画像は最大 2 枚で、上限の残りが $0.15 以上あるときだけ作成します。
* **共有したファイル：** 画像（PNG、JPEG、GIF、WebP、各 5 MB まで）や PDF（10 MB まで）をメッセージに添付するか、エージェントが読むスレッド内の以前のメッセージに添付します。1 回の回答で、新しいものから最大 4 ファイル、合計 12 MB まで読みます。ほかの種類のファイルはまだ読めません。

モデル自体も画像や PDF を読める必要があります。**自動** の場合、エージェントはファイルを送り、選んだモデルが読めなければファイルなしで回答します。特定のモデルの場合、共有された種類のファイルをそのモデルが読めないときはエージェントがそう伝えます。

共有したファイルは、それを読む回答のためにダウンロードされ、保存されることはありません。エージェントが投稿するグラフや画像は、ほかのファイルと同じく Slack ワークスペースのファイルです。

これらの機能より前に追加したエージェントには、[Slack 権限の更新](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#update-slack-permissions)が必要です。

## Slack を検索する

エージェントは質問した人の代わりに Slack ワークスペースを検索し、使ったメッセージやファイルへのリンクを付けて回答できます。例：

```text theme={null}
What did we decide about the launch date?
@Phaseo find the latest incident review in #ops and summarise it
Who has been working on the billing migration this month?
```

* **あなたとして検索します。** あなたのメッセージに対して Slack が与える権限で Slack のリアルタイム検索を使うため、あなたが Slack で見られるものだけが見つかります。検索するのはパブリックチャンネルだけで、プライベートチャンネル、ダイレクトメッセージ、グループ DM は検索しません。
* **使ったものにはリンクを付けます。** 根拠にしたメッセージやファイルにはそれぞれリンクが付くので、Slack で開けます。検索で何も見つからなかったときは、そう伝えます。
* **検索を絞り込めます。** チャンネル、人、期間で絞り込めます。1 つの回答で最大 4 回、1 回あたり 10 件まで検索します。
* **意味でもキーワードでも。** AI 検索を含む Slack プラン（Business+ と Enterprise+）では、自分の言葉で書いた質問を意味で検索します。ほかのプランではキーワードで検索します。
* **データを保持しないプロバイダーだけ。** Slack を検索した回答は、それ以降、ほかのモデルへの質問や画像の作成も含めて、データ保持ゼロの AI プロバイダーだけに送られます。そのため、見つけた内容がプロバイダーのログに残ることはありません。また、その回答の残りでは Web 検索と Web ページの読み込みもオフになり、見つけた内容が検索やリンクを通じて外に出ることはありません。両方が必要な場合は、先に Web を検索するよう頼んでください。

どこで検索するかは **設定 → Slack** の **Slack 検索** で選びます。変更はすぐに反映されます。

| オプション | 検索する場所 |
| - | - |
| **オフ** | どこでも検索しません。 |
| **ダイレクトメッセージ**（デフォルト） | エージェントとのダイレクトメッセージ内だけです。見つけた内容を読むのは質問した人だけです。 |
| **ダイレクトメッセージとチャンネル** | 誰かがメンションしたときは、チャンネルでも検索します。回答はチャンネルの全員が読めます。見つかったチャンネルを開けないゲストも含むため、ワークスペースにとって問題がない場合だけ選んでください。 |

Slack による制限もあります。

* 検索するのは誰かのメッセージに回答するときだけです。Slack はエージェントをメンションしたメッセージや、エージェントに直接送られたメッセージごとに検索の権限を与えます。エージェントがその権限を保持するのは回答し終えるまでです。
* Slack はアプリがゲストの代わりに検索することを許可していません。また、エージェントがほかの会社の人の代わりに検索することはありません。
* Slack で 1 人が検索できるのは 1 分あたり約 10 回です。それを超えると、エージェントは手元の情報で回答し、そのことを伝えます。
* Slack がこの検索を許可しているのは、Slack Marketplace のアプリと、会社が独自に作ったアプリだけです。Phaseo の Slack アプリは、Slack Marketplace での掲載が承認されると検索できるようになります。それまでは、検索は利用できないとエージェントが伝えます。今すぐ検索するには、[独自の Slack アプリ](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#use-your-own-slack-app)を使ってください。
* 検索機能より前のインストールでは、[Slack 権限の更新](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#update-slack-permissions)が必要です。

検索には、データ保持ゼロのプロバイダーが提供できるモデルも必要です。**自動** でもエージェントは検索できます。検索のあと、自動はデータを保持しないプロバイダーがあるモデルの中からだけ選びます。すべてのプロバイダーがデータを保持するモデルでは検索せず、頼まれたときはそう伝えます。管理者は **設定 → Slack** でデータを保持しないモデルを選べます。また、[メッセージごとにモデルを選べる](#choosing-a-model-per-message)場合は、メッセージを `with <model>:` で始めるとそのモデルを使えます。検索のあとで、データを保持しないプロバイダーが回答できないとゲートウェイが返した場合、エージェントはそこで止まって理由を伝えます（プロバイダーキーがないなど、ほかのエラーではいつものメッセージが表示されます）。それまでにかかった費用は計上されます。

見つけた内容はその回答だけに使われ、保存されません（[データとプライバシー](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#data-and-privacy)を参照）。同じ理由で、Slack を検索した回答では、途中で質問したり、メモ、ピン、To-Do、スキルを保存したり、定期タスクを設定したり、共有ページを公開したりできません。

## 利用状況について質問する

連携済みのメンバーは、この Phaseo ワークスペースについてエージェントに次のことを質問できます（それ以外の人が質問すると、[アカウントを連携するためのボタン](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#link-a-slack-account)が届きます）。

* 期間内のリクエストと支出（日・週・月ごと、モデルやプロバイダーごと）
* クレジット残高、処理中のリクエストのために確保されたクレジット、今月使ったクレジット
* API キーごとのリクエストと支出
* Phaseo カタログのモデル

日付は UTC で、週は月曜日に始まります。エージェントがこれらの質問に答える場所は、**利用状況データ** で選びます。

| オプション | 連携済みのメンバーが質問できる場所 |
| - | - |
| **オフ** | どこでも答えません。エージェントは利用状況データを共有しません。 |
| **ダイレクトメッセージ**（デフォルト） | エージェントとのダイレクトメッセージだけです。 |
| **ダイレクトメッセージと選んだチャンネル** | ダイレクトメッセージと、**チャンネル ID** に入力したチャンネル（最大 100）です。 |

チャンネルのメンバーは全員エージェントの回答を読めるため、ワークスペースの支出を見てもよいメンバーだけのチャンネルを指定してください。チャンネルの ID は、Slack のチャンネル詳細の一番下にあります（例：`C0123ABCD`）。

## メモリとスキル

エージェントは、チームに頼まれたことを覚えておき、スキル（繰り返す作業のために保存した指示）に従うことができます。Slack で次のように頼みます。

* `@Phaseo remember that deploys freeze on Fridays after 3pm`
* `@Phaseo pin this for everyone: our fiscal year starts on 1 April`
* `@Phaseo add a to-do: send the Q4 budget to finance`、あとで `@Phaseo the budget to-do is done`
* `@Phaseo what do you remember about deploys?` または `@Phaseo forget the note about deploys`

エージェントは 3 種類のメモを、それぞれ 500 文字以内で、自分の言葉で保存します。

| 種類 | 用途 |
| - | - |
| **メモ** | 覚えておくこと。エージェントは関係があるときにメモを調べます。 |
| **ピン留め** | 常に念頭に置いておくこと。エージェントはメッセージごとに、その会話のピンを最大 10 件と、ワークスペース全体のピンを最大 10 件確認します。 |
| **To-Do** | 進み具合を追うこと。完了にできます。 |

メモは、保存されたチャンネルまたはダイレクトメッセージに属します。ワークスペース全体向けにするよう頼まれた場合は例外です。会話の中でエージェントが確認するのは、その会話のメモとワークスペース全体のメモだけで、ほかのチャンネルやダイレクトメッセージのメモは確認しません。ワークスペース全体のメモは、エージェントが回答する組織内のすべての人が利用できます。共有された Slack Connect チャンネルにいる他社の人が見たり保存したりできるのは、その会話のメモだけで、ワークスペース全体のメモは対象外です。保存済みのスキルは使えますが、スキルはワークスペース全体に適用されるため、新しいスキルは保存できません。メモは `remember until Friday that the office is closed` のように日付まで保持でき、その日を過ぎると削除されます。

エージェントがメモを保存するのは、覚えておく、ピン留めする、やることとして記録するよう頼まれたときか、決定事項や締め切りのように長く必要な事実があるときだけです。メッセージやスレッドを丸ごとコピーすることはありません。

### スキル

スキルは、名前、1 行の説明、最大 4,000 文字の指示からなり、週次レポートのようにチームが繰り返す作業に使います。エージェントに保存を頼むには、次のようにします。

`@Phaseo save a skill called Weekly report: list what shipped this week, then what slipped, then next week's priorities`

エージェントはメッセージごとに、最近変更された 20 件のスキルの名前と説明を確認します。依頼がスキルに合うとき、または `@Phaseo use the Weekly report skill` のように頼まれたときに、そのスキルの指示を読み込みます。スキルを保存するのははっきり頼まれたときだけで、同じ名前のスキルを置き換えるのも頼まれたときだけです。

### 管理者が管理できること

* **エージェントにメモを残させる**（既定でオン。**設定 → Slack** の **メモリとスキル** にあります）をオフにすると、メモ、ピン、To-Do が使えなくなります。オフの間、エージェントはメモを保存も参照もせず、何かを覚えるよう頼まれると、管理者がメモリをオフにしていると伝えます。スキルは引き続き使えます。保存済みのメモは残り、オーナーと管理者は引き続き確認・削除できます。オンに戻すと、エージェントは再びそれらを使います。
* Slack ワークスペースごとに、メモは最大 500 件、スキルは最大 100 件まで保持します。メモリがいっぱいになるとエージェントがそう伝えるので、いくつか削除して空きを作ってください。
* オーナーと管理者は、エージェントが保存したものをすべて **設定 → Slack** の **メモリとスキル** で確認できます。メモを種類で絞り込み、任意のメモやスキルを削除し、スキルの名前、説明、指示を編集できます。これらの変更は、本文を含めずにワークスペースのアクティビティログに記録されます。
* [エージェントをアンインストールする](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#pause-or-uninstall)と、メモとスキルはすべて削除されます。もう一度追加すると、空のメモリから始まります。

## スケジュールされたタスク

エージェントに定期的に何かをするよう頼むと、その会話に定期タスクを設定します。例：

* `@Phaseo every weekday at 9:00, summarise yesterday's news about electric vehicles`
* `@Phaseo every Monday at 8:30, list last week's Phaseo spend by model`
* `@Phaseo on the 1st of every month at 10:00, list the API keys nobody used last month`
* `@Phaseo which recurring tasks are set up here?` または `@Phaseo cancel the Monday spend summary`

エージェントは、設定した内容（何をするか、どこに投稿するか、頻度、次回の実行日時）を確認として伝えます。

* **頻度：** 毎時（指定した分）、毎日、平日（月曜から金曜）、毎週指定した曜日、または毎月指定した日（その日がない月は月末）。1 時間に 1 回より多くは実行されません。
* **時刻：** 設定した人の Slack のタイムゾーンでの現地時刻です。夏時間の切り替えがあってもその時刻を保ちます。
* **場所：** 設定したチャンネルまたはダイレクトメッセージです。各実行ではそこに短い **Scheduled: …** メッセージを投稿し、そのスレッドで回答します。そのスレッドへの返信は、エージェントへの通常のメッセージとして扱われます。
* **実行内容：** エージェントは依頼を単独で完結する指示として保存するため、各実行は設定したときの会話がなくても動きます。スケジュールされた実行では、ボタン付きの質問や Slack の検索はせず、定期タスクの設定や変更もできません。

各実行は、設定した人への通常の回答です。エージェントはその人がまだ利用できるかを確認し、実行はその人の回答の 1 回としてプラン、**月の支出上限**、**1 人 1 時間あたりの回答数** に数えられ、[回答ごとの上限](https://phaseo.app/docs/ja/v1/guides/slack-agent-admin.md#limits-on-each-answer)を守り、いつものフッターで終わります。

実行できない場合：

* エージェントが Phaseo で一時停止されている、または Phaseo の請求が未払い（**支払い待ち**）のときは、その実行はスキップされ、タスクはそのまま続きます。エージェントが再開されると次の時刻に実行され、タスクを再開する操作は必要ありません。こうしてスキップされた実行は失敗として数えられず、前回の実行がスキップされた理由は **設定 → Slack** に表示されます。
* 設定した人がエージェントを使えなくなった、またはエージェントが会話に投稿できなくなった（チャンネルから外された場合など）ときは、その実行はスキップされ、タスクは一時停止されます。理由は **設定 → Slack** に表示されます。
* それ以外で実行できなかった場合（**月の支出上限** に達して断られた場合など）は失敗として数えられます。3 回続けて失敗するとタスクは一時停止され、エージェントが設定した人にダイレクトメッセージで知らせます。

自分が設定したタスクは、エージェントに頼んでキャンセルできます。[Slack アカウントを連携した](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#link-a-slack-account) Phaseo ワークスペースのオーナーと管理者は、誰のタスクでもキャンセルできます。共有の Slack Connect チャンネルにいるほかの会社の人は、会話のタスクを見られますが、設定はできません。エージェントの **Home** タブには自分のタスクが表示されます。

### 定期タスクの設定

オーナーと管理者は、**設定 → Slack** の **定期タスク** で次を設定します。

| 設定 | 内容 | 既定値 |
| - | - | - |
| **定期タスクの設定を許可する** | オフにすると、誰も設定できず、どれも実行されません。タスクは保持され、オンに戻すと再び実行されます。 | オン |
| **このワークスペースの定期タスクの上限** | 1 から 100 まで。下げても、設定済みのタスクは残ります。 | 20 |
| **設定できる人** | **エージェントを使えるすべての人** または **Phaseo アカウントを連携した人のみ**。 | すべての人 |

同じセクションに、各タスクの内容、投稿先、頻度、次回の実行、設定した人、前回の実行結果が一覧表示されます。どのタスクも一時停止、再開、削除できます。再開したタスクは次の時刻に実行され、失敗の回数は 0 から数え直されます。エージェントをアンインストールすると、定期タスクはすべて削除されます。

## 共有ページ

レポート、表、グラフなど、Slack のメッセージには長すぎたり複雑すぎたりする回答は、エージェントが Web ページとして公開し、返信にリンクできます。たとえば次のように頼みます。

* `@Phaseo make a page comparing our spend by model this month`
* `@Phaseo turn the decisions in this thread into a one-page summary`

ページはエージェントが書く 1 つの HTML ファイルで、テキスト、表、グラフを載せられます。ページは静的です。Phaseo はページを保存する前に、スクリプト、リンク、フォームと、ほかのサイトのフォントや画像などよそから読み込まれるものをすべて取り除きます。そのため、ページでスクリプトを実行することも、どこかへデータを送ることもできず、Web アドレスはプレーンテキストとして表示されます。ページは `slack.phaseo.app` 上の厳しく制限されたサンドボックスで開くため、Phaseo や Slack のサインイン情報には触れられません。

| ページを表示できる人 | 方法 |
| - | - |
| **リンクを知っている全員**（既定） | リンクを持っている人なら誰でも、サインインせずに表示できます。リンクは長くランダムなので、推測されません。 |
| **この Slack ワークスペースのメンバー** | Slack でサインインした、Slack ワークスペースのメンバー。ゲストは **ゲストを許可** がオンのときだけ表示でき、他社の人は表示できません。サインインは 8 時間有効です。 |

誰かがもう一方を求めない限り、エージェントは管理者が選んだ既定を使います。例：`@Phaseo make it a page only our Slack workspace can see`

共有ページが開かない場合は、期限切れか削除された可能性があります。エージェントに新しいページを頼んでください。Slack ワークスペースと共有されたページでは Slack でのサインインを求められるので、そのワークスペースでサインインしてください。ゲストが開けるのは **ゲストを許可** がオンのときだけです。

### ページの上限

* ページは既定で 30 日間保持され、その後削除されます。新しいページの保持期間は、管理者が 7 日、30 日、90 日から選べます。
* 1 つの回答で公開できるページは最大 3 件で、Slack ワークスペースごとに同時に保持できるページは最大 200 件です。1 ページの上限は 512 KB です。
* 公開は回答の一部です。追加料金はかからず、ページを書くのに使ったモデルトークンは回答の \$0.50 の上限に含まれます。
* 共有の Slack Connect チャンネルにいる他社の人は、ページを公開できません。
* Slack を検索した回答では、ページを公開できません。ページにはエージェントが書いた内容が保存されるためです（[Slack を検索する](#searching-slack)を参照）。

### 管理者がページについて管理できること

**設定 → Slack** の **共有ページ** で次を設定します。

* **エージェントにページの公開を許可する**（既定でオン）をオフにすると、公開しなくなります。公開済みのページは、期限が来るか削除するまで残ります。
* **新しいページの保持期間**：7 日、30 日、90 日。
* **リンクを知っている人なら誰でもページを表示できる**（既定でオン）。オフにすると、公開済みのページも含めて、すべてのページで Slack へのサインインが必要になります。
* **新しいページの公開範囲** は、両方を選べるときの既定を決めます。
* 一覧には、各ページのタイトル、依頼した人、公開日と期限、表示回数が表示されます。オーナーと管理者はどのページも削除でき、削除するとリンクはすぐに使えなくなります。ページを開けるのは、そのページのアクセス設定が許す場合です。Slack ワークスペース向けのページでは、メンバーとして Slack でサインインする必要があります。削除はワークスペースのアクティビティログに記録されますが、タイトルは含まれません。

**この Slack ワークスペースのメンバー** を使うには、エージェントが使う Slack アプリで Slack でのサインインが設定されている必要があります。設定されるまでは **設定 → Slack** にそのことが表示され、ページはリンクを知っている全員に公開されます。独自の Slack アプリでは、Phaseo のマニフェストと同じく、マニフェストにリダイレクト URL `https://slack.phaseo.app/p/signin` を含める必要があります（[独自の Slack アプリを使う](https://phaseo.app/docs/ja/v1/guides/slack-agent.md#use-your-own-slack-app)を参照）。


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