Agent とバージョン
Agent を作成し、バージョンを公開します。
Agent は Workspace で動かすものです。Agent 自体は設定を持たず、名前と、公開した順に並ぶ バージョン だけを持ちます。Session が使うモデル、モデルへの指示、接続してよい Tool は、バージョンごとに指定します。
Session は、開始した時点で最新だったバージョンのまま最後まで動きます。新しいバージョンを公開しても影響するのはその後に開始した Session だけなので、会話の途中の人がいても安心して公開できます。
Agent を作成する
Agent › Agent を作成 で入力するのは名前だけです。この名前で、Workspace を使う人やコードが Agent を見分けます。
作成したばかりの Agent にはバージョンがなく、最初のバージョンを公開するまでは Session を開始できません。最初のバージョンを公開 を選ぶと、バージョンの編集画面が開きます。
バージョンの編集画面
編集画面は上から下まで 1 つのフォームで、公開するときにまとめて確認されます。直す必要のある項目には印が付き、すべての項目が正しくなるまでは何も公開されません。
Model Provider とモデル
| 項目 | 設定する内容 |
|---|---|
| Model Provider | モデルを動かす場所です。Platform が提供するものか、Workspace で接続したものを選びます。詳しくは Model Provider を参照してください。 |
| モデル | Platform の Model Provider では、価格が設定されたモデルから選びます。自分の Model Provider では、その API が受け付けるモデル ID を指定します。 |
| 出力の上限 | モデルが 1 ステップで書けるトークン数の上限です。 |
| Context window | モデルが一度に読めるトークン数です。 |
| 画像を読む | Function の結果に含まれる画像などを、モデルに見せるかどうかです。 |
| Thinking、Thinking budget、Effort | Anthropic のモデルで、回答の前に考えるかどうかと、どれだけ考えるかを設定します。 |
| Reasoning effort | OpenAI Responses のモデルで、どれだけ深く推論するかを設定します。 |
指示
System prompt は、毎回の会話の前にモデルに与える指示です。空のままにすると、何も指示しません。
Tool
Tool では、Agent が接続してよいものを指定します。どの Tool も Policy に従って動きます。
| Policy | Agent が Tool を呼び出したとき |
|---|---|
| 許可 | そのまま実行されます。 |
| 承認を求める | コンソールかアプリで人が許可または拒否するまで待ちます。詳しくは 承認とフォーム を参照してください。 |
| 拒否 | 実行されずに拒否されます。 |
各 Grant には 既定の Policy があり、その Grant が提供するすべての Tool に適用されます。提供元が後から追加した Tool も対象です。特定の Tool だけ扱いを変えたいときは、Tool rule で Tool の正確な名前を指定し、既定の Policy を上書きします。
MCP サーバー
MCP サーバーには、モデルに見せる名前と、接続先の URL を指定します。バージョン自体は Credential を持ちません。Session は、その Session の Vault がその URL に対して保管している Credential を使ってサーバーにサインインします。
Skill
Skill は、Agent が必要なときに読む指示とファイルです。最新 を選ぶと、Session の開始時点で最も新しいバージョンを読みます。固定 を選ぶと、ずっと同じ 1 つのバージョンを使います。
Sandbox
Sandbox は、Session ごとに用意される専用の Linux マシンと、そこでコマンドを実行する Tool です。Release は起動する Platform image の系列で、これによってツールチェーンが固定されます。ネットワーク では、インターネットに接続するかどうかを選びます。Sandbox を付与するのは、コードベースのビルドやネイティブの CLI など、Linux が必要なプログラムを動かすときだけにしてください。それ以外の作業には Function を与えます。Function のほうが安全で安価なうえ、Credential をモデルの手の届かないところに置けます。両者の違いは Sandbox のページで比較しています。
Function package
Subako Functions は、Agent が Tool として呼び出す WebAssembly の Function package です。Platform が提供するものと、この Workspace でアップロードしたものがあります。Grant では、1 回の呼び出しで実行できる時間、接続できる Host、Session の Vault から Credential を受け取る Origin も設定します。各項目は Function の許可 で説明しています。
Session の命名と人への質問
Session の命名 では、Agent が自分の Session に名前を付けてよいかどうかを、付けない、名前がない間だけ、人が名前を変えるまで、の 3 つから選びます。どの場合も、人が付けた名前を上書きすることはありません。
人への質問 を有効にすると、Agent は判断が必要なときに人へフォームを提示できます。使えるのは、選択肢からの選択、自由入力、はい・いいえの質問と、アプリ側で描画する Custom widget です。詳しくは 承認とフォーム を参照してください。
Session Volume
Function は Session の Session Volume でファイルを読み書きします。Temporary (/volume/tmp) は常に用意され、Session の最後の操作から 24 時間で消去されます。Function に Data (/volume/data) を用意する をオンにすると、Session を削除するまでファイルが残る 2 つ目の領域が加わります。
公開した後
バージョン N を公開 を選ぶと Agent のページに戻り、公開したとおりの内容でバージョンが表示されます。
- バージョン では、以前のバージョンを選んで内容を確認できます。バージョンは削除されずに残ります。
- 新しいバージョンを公開 を選ぶと、表示中のバージョンの内容が入った状態で編集画面が開きます。今ある内容に手を加える形で変更できます。
- この Agent の Session を見る では、この Agent で動いた Session の一覧を表示します。
- CORS は、ブラウザーからこの Agent の Session を呼び出せる Origin の一覧です。サーバー側のクライアントは
Originを送らないので、設定は不要です。Session token を使ってブラウザーから Session と直接やり取りするページは、その Origin をここに追加する必要があります。 - Agent の操作 では、Agent の ID のコピー、名前の変更、削除ができます。削除すると、すべてのバージョンと、それらで動いたすべての Session も削除されます。記録済みの使用量は残ります。
同じバージョンはファイルからも公開できます。編集画面のフォームは、subako agent publish と API が受け付ける Agent config ドキュメントそのものです。各項目は Agent config リファレンス で説明しています。