Admin Assistant
Admin Assistant はスーパー管理者ダッシュボードのチャットパネルです。管理 UI を離れずにプラットフォームの状態を検査し、カスタムツールキットを構築・共有するために使用します。
リリースノートではこの機能が Toolkit Management Assistant と表示される場合があります。プロダクト UI ではボタンとパネルのラベルは Admin Assistant です。
これは、組み込みのエンタープライズツールキット（OAuth、有効/無効、カテゴリ）を有効化・構成する Toolkits タブとは別物です。アシスタントはカスタムツールキット — プロジェクトに既に存在する Actions や Workflows へのリンクの名前付きバンドル — と連携します。
前提条件
- 役割に Custom Toolkits → Manage が含まれていること（RBACをご覧ください）。なければ Admin Assistant ボタンは非表示になります。
- バンドルしたい Actions または Workflows が既にプロジェクトに存在すること（アシスタントはそれらをリンクします；新しいツールを作成しません）。
- 共有されたツールキットを受け取るべきチームがわかっていること。
パネルを開く
- Super Admin を開きます。
- ヘッダーバーで Admin Assistant（シールドアイコン）をクリックします。
- サイズ変更可能なサイドパネルが開きます（幅おおよそ400〜800px；左端をドラッグしてサイズ変更）。
| コントロール | 目的 |
|---|---|
| New chat | 会話をクリアして新しく開始 |
| Close | パネルを隠す（プラットフォームの状態は変更しない） |
| Composer | プレースホルダー：Ask the Admin Assistant… — Enter で送信 |
| Stop | 表示されている間に進行中の生成をキャンセル |
空状態のコピー：Build and share custom toolkits、およびプラットフォームを変更する操作はすべて事前に確認されるとの注記。提案チップをクリックするとそのプロンプトが送信されます。
カスタムツールキットとは
カスタムツールキットは、既に存在するものへのリンクのバンドルです：
| リンクされるリソース | 格納場所 |
|---|---|
| Actions | プロジェクトの Actions ライブラリ |
| Workflows | プロジェクトのワークフロー / Tool Editor |
重要な性質：
- ツールキットはツールをコピーしたり所有したりしません。オリジナルが置かれているホームプロジェクトを指します；あちらでの編集はツールキットが共有されているすべての場所に適用されます。
- チームと共有すると、そのチームのエージェントが利用できるようになります — エージェントごとの個別のオプティンステップはありません。
- 表示名前は人間が読める形式；スラッグは不変で、モデルが見るツール名に名前空間を付けます。
- アシスタントは新しいアクションやワークフローを作成できません。まず Actions ライブラリまたは Tool Editor で作成してから、アシスタントにリンクを依頼してください。
質問と変更の違い
| リクエストの種類 | 例 | 何が起きるか |
|---|---|---|
| 読み取り | チーム一覧、カスタムツールキット一覧、使用状況リーダーボード、リンク可能な Actions/Workflows の検索、ツールキット詳細の取得 | 承認カードなしで実行 |
| 変更 | ツールキットの作成/更新/削除、アクションやワークフローのリンク/リンク解除、チームへの共有 | まず承認カードを表示 |
承認カード
変更が提案されたとき：
- ツール名、リスクレベル、引数を確認します。
- Allow（またはラベルされた確認アクション）を選択して実行するか、Deny でプラットフォームを変更しません。
- 最新のアシスタントターンのみが有効な承認を保持します — 古いカードは再実行できません。
チャットで「確認してください」と入力する必要はありません。変更を呼び出し、カードを使用してください。パネルのサブタイトルは Confirms every change before it runs です。
すべてのツール呼び出しはあなたの管理権限で認可されます。呼び出しが権限エラーを返した場合、アシスタントは黙って別の経路を試すのではなく、何が不足しているかを報告すべきです。
典型的なワークフロー：ツールキットの構築と共有
- ツールキットの作成をアシスタントに依頼します（わかりやすい表示名を指定）。
- Actions やワークフローが既に置かれているプロジェクトを指定します（アシスタントが解決できるプロジェクト名を使用）。
- 各アクションやワークフローを1つずつ****検索してリンクさせます。
- ツールキットを正しいチームに共有するよう依頼します。
- サマリーを確認します：ツールキット名、内容、閲覧できる人。
リンク時、アシスタントは入力に関する警告を表示することがあります（例：ツールのホームプロジェクト外の呼び出し側では機能しない可能性があるファイルアップロード入力）。リンクはそれでも成功します；警告は呼び出し側への指針として扱ってください。
共有はチームリストを置き換える
ツールキットを一連のチームと共有すると、共有チームの完全なリストを置き換えます。他のチームを維持したまま1つ追加するには：
- 現在の共有チームを読み取ります（まず
get/ ツールキットの検査）。 - 既存のチーム ID に新しいものを加えて渡します。
新しいチームだけを渡すと、他の全員の共有が取り消されます。
アシスタントが助けられること
| 機能 | 備考 |
|---|---|
| カスタムツールキットの一覧/検査 | プラットフォーム全体のカスタムツールキット在庫 |
| カスタムツールキットの作成、更新、削除 | 承認によって制御 |
| プロジェクト内でのリンク可能な Actions と Workflows の検索 | 解決済みプロジェクト内でのクエリによる |
| Actions と Workflows のリンク/リンク解除 | 1つずつ；入力に関する警告に注意 |
| チームへのツールキット共有 | 置換セマンティクス — 上記参照 |
| プラットフォームチームの一覧 | 共有とナビゲーション用 |
| チーム使用状況リーダーボード | 例：最近のウィンドウ（例：過去30日間）の使用状況 |
| プロジェクト一覧/プロジェクト詳細 | ツールの所在を解決するために |
組み込みツールキットの有効化、OAuth の構成、ツールキットカテゴリの管理については Super Admin → Toolkits の代わりにはなりません。
例のプロンプト
- 今どのカスタムツールキットがありますか？
- このプラットフォームのチームを一覧表示してください。
- 過去30日間で最も使用量が多いチームはどれですか？
- 私たちの Jira アクションをサポートチーム向けツールキットにバンドルしてください。
制限とヒント
- チャットで ID を絶対に捏造しない — チーム、プロジェクト、アクション、ワークフロー、ツールキットを検索/一覧の結果から解決させます。
- 複数のプロジェクトやツールが一致しうる場合は正確な名前を使用；あいまいな場合は、アシスタントがあなたがどれを意図したかを尋ねるべきです。
- 無関係なタスクに切り替えるときは New chat を使用し、以前のコンテキストが共有やリンクを混乱させないようにします。
- ツールがまだ存在しない場合は、まずプロジェクトで作成してからアシスタントに戻ってリンクします。
- 組み込みツールキットの有効化、OAuth、カテゴリのコントロールは Super Admin → Toolkits に留まります。
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| Admin Assistant ボタンがない | 役割に Custom Toolkits → Manage がない |
| 承認カードが表示されないが何も変化しない | Deny したか、またはリクエストが読み取り専用だった |
| フローの途中で権限エラー | 役割はアシスタントを開けるが、ツールが必要とする特定の管理 API 権限がない |
| 共有で他のチームが消えた | 共有は完全な置換 — 完全なチームリストで再共有 |
| アクション/ワークフローが見つからない | 間違ったプロジェクト、またはそのプロジェクトにツールが作成されていない |
| リンク後に入力警告 | 警告を確認；リンクは一部の呼び出し側では有効だが他ではそうでない場合がある |
関連
- RBAC — Custom Toolkits Manage 権限と Toolkits タブへのアクセス
- チーム — アシスタントが一覧表示・共有できるチーム構造
- エージェントツールキット概要 — エージェント上のツールキット（この管理アシスタントとは別物）