プロファイル

プロファイルは、エージェント用の再利用可能な起動ポリシーです。どのプロバイダーとモデルを実行するか、どの程度の推論を使うか、どのロールと指示を受けるか、どの機能または権限を許可するかに答えます。

ほとんどのユーザーは組み込みプロファイルから始め、解決済みプレビューを確認すべきです。通常の利用で未加工の JSON を作成する必要はありません。

プロファイルが制御するもの

解決済みプロファイルには、次を含められます。

• プロバイダー設定、モデル、推論努力量。
• スーパーバイザー、開発者、レビュアー、専門家などのロール。
• 指示とスキル参照。
• 許可するツールと MCP 機能。
• タイムアウトと実行動作。
• 書き込み担当またはオーナーレベルの権限制約。
• 常駐し続けることを意図するか、限定された作業を完了することを意図するか。

モデルの強さとオーケストレーションロールは別です。強力なモデルが自動的にスーパーバイザーになるわけではなく、プロファイル名で容量の課金方法も決まりません。

組み込みプロファイル

ThreadCells には、日常用および強力なスーパーバイザー、開発者、レビュアー、アーキテクチャおよび戦略作業、フロントエンド/UI 作業、そして厳密にオーナー承認された XHigh 実行者など、一般的なロール向けの不変プロファイルが含まれています。

例:

• supervisor_terra_medium: 通常および中程度のリスクのワークフローに使う既定の継続的オーケストレーター。分解、委任、レビュー、受け入れ、統合を担います。
• supervisor_sol_medium: リスクのある、モジュール横断、アーキテクチャ依存、またはライフサイクル依存のワークフロー向けの、オーケストレーション優先スーパーバイザー。
• developer_terra_medium: 定型的で範囲が限定され、曖昧さの少ない実装。
• developer_terra_high: 重要なプロダクト作業、難しいが範囲の限定された不具合とリファクタリング、および公開文面の意味品質。
• developer_sol_medium: 推論負荷が高いサブシステム横断作業と、微妙な不変条件に関わる作業。
• reviewer_sol_high: リスクのある変更または統合された変更の独立レビュー。
• critical_sol_xhigh_owner: 独立した認可境界を持つ、例外的なオーナー実行者プロファイル。

組み込みは不変であるため、よく知られた ID の意味が知らないうちに変わることはありません。カスタマイズするには複製してください。コピーにはカスタム ID が与えられます。

プロファイルの選択

タスクを確実に担える、最も専門性の低いプロファイルを使ってください。

より大きな推論量と広い権限は容量を消費し、影響も増大させます。既定にするのではなく、タスクを反映させてください。

Sol スーパーバイザーだからといって、Sol 開発者が必要とは限りません。定型実装は引き続き Terra 開発者に割り当て、developer_sol_medium は正しさが微妙なシステム横断の推論に依存する作業に限るべきです。

再試行とエスカレーション

ThreadCells は別のエージェントを選ぶ前に、失敗した実装試行を分類します。

通常のエスカレーション経路は developer_terra_medium → developer_terra_high → developer_sol_medium です。XHigh は、セキュリティ、exactly-once 並行処理、破壊的 Housekeeping、移行、危険な復旧など、真に重要でシステム全体に関わる権限に限ります。テスト合格は必要な証拠ですが、それだけで意味品質を証明するものではありません。

解決済みプレビュー

設定 → プロファイルには、保存済みアーティファクトと 解決済みプレビュー の両方が表示されます。起動前にプレビューを使い、既定値と参照が適用された後の実際のプロバイダー、モデル、推論、ロール、ツール、権限、タイムアウト、指示を確認してください。

新しい起動では、その解決済みリビジョンをアトミックにキャプチャします。その後カスタムプロファイルを編集すると別の不変リビジョンが作成され、既存セッションの過去の意味は書き換えられません。

リビジョンスナップショット前に作成された古いセッションには、legacy/unavailable snapshot と表示されることがあります。ThreadCells は過去の設定を捏造しません。

カスタムプロファイルを作成する

最も安全な手順は次のとおりです。

1. 設定 → プロファイルを開きます。
2. 最も近い組み込みプロファイルを選びます。
3. 複製します。
4. ロールが分かる明確な名前を付けます。
5. 必要なフィールドだけを変更します。
6. 解決済みプレビューを確認します。
7. より広い作業の前に、範囲を限定したテスト起動で使います。

カスタム編集ではリビジョンが作成されます。履歴から参照されるプロファイルは、破壊的に消去されるのではなく無効になります。

専門的な権限とオーナー権限

信頼されないインポートでは、owner-executor、XHigh、unrestricted、danger-full-access の権限を作成できません。認証済みオペレーターは、保護されたコントロールプレーンを通じてのみ特権カスタムリビジョンを作成でき、サーバーは起動時に該当する一回限りのオーナー許可も要求します。

組み込みの critical_sol_xhigh_owner プロファイルは、Web の両方の起動フロー、すなわちセッションの作成または既存セッションへのエージェント追加で選択できます。いずれも例外的権限のブロックを表示し、明示的な確認と短命なオペレーターアンロックを要求してから、通常の起動機能を1つ作成して消費します。エージェント追加では、その機能を既存セッションと正規の継承済み/プロジェクト作業ディレクトリーにスコープします。ローカル CLI では、同じ権限クラスを --owner-xhigh と対話確認で提供します。これらの経路はいずれも再利用可能な API バイパスを作成せず、他のプロファイル、子ターミナル、無関係な設定変更を認可しません。

プロファイルと容量

トップレベルのスーパーバイザーまたはオーナーセッションは、常駐スーパーバイザー容量を消費します。委任された子は作業コンテキストスロットを消費します。プロバイダー実行と高負荷実行は、プロファイルに supervisor や reviewer が含まれるだけではなく、活動に基づいて別々に課金されます。

強力なプロファイルの同時実行数を上げる前に、容量とリソースモデル を参照してください。

高度なインポートとエクスポート

CLI では、現在のスキーマと例を公開しています。

threadcells profiles schema
threadcells profiles example
threadcells profiles export
threadcells profiles validate /path/to/profile.json
threadcells profiles import /path/to/profile.json

インポート前に検証してください。インポートには UI と同じサービス検証が使われ、実行可能な MCP コマンドを導入することはできません。インストール済みのプロバイダー設定および登録済み機能 ID を参照できます。

データベース行を手で編集したり、プライベートな指示、ファイルシステムパス、資格情報、内部オーナー状態を公開プロファイルアーティファクトへコピーしたりしないでください。

よくある間違い

• モデル名だけでプロファイルを選ぶ。
• 日常的なワーカーにオーナーレベルの権限を与える。
• 解決済みプレビューを確認せずにカスタムプロファイルを編集する。
• 編集で既に実行中のセッションが変更されると期待する。
• 承認済み参照の代わりに未加工のシークレット値をインポートする。
• プロファイルをプロバイダーのインストールと見なす。選択した CLI も準備完了でなければなりません。

次に、スーパーバイザーとワーカーのプロファイルが協働する方法について、ワークフローと永続的な結果 を参照してください。