Hane Cowork

管理者向けの設定

組織の管理者が Hane Cowork の利用・モデル・利用枠・手元の機能の決まりを設定する方法と、組織に展開するときの注意を説明します。

このページは、Cowork を組織で使えるようにする管理者向けです。Cowork の設定の項目と変え方、利用者に必要な権限、展開するときに気をつけることを説明します。

Cowork の設定

Cowork の設定は、プロジェクトと環境ごとに 1 つあります。利用者の Cowork は、接続に使ったアクセストークンのプロジェクトと環境の設定に従います。

項目	意味	初期値
`enabled`	Cowork のモデル利用を有効にするか	`false`
`models`	Cowork に使わせるモデル。Model Gateway で使えるものだけを指定できます	なし
`daily_token_limit`	プロジェクト全体で 1 日（UTC）に使えるトークン数	100,000
`session_token_limit`	1 つのモデル利用で使えるトークン数。Cowork は依頼ごとにモデル利用を作ります	25,000
`max_output_tokens`	1 回の呼出しで出力するトークン数の上限	4,096
`local_tools`	手元の機能ごとの決まり（下の表）	すべて `deny`

local_tools には、次の 5 つの機能ごとに allow（許可）・confirm（使うたびに本人に確認）・deny（禁止）を決めます。

キー	画面での名前	対象
`files`	作業フォルダのファイル	本人が選んだ作業フォルダの読み書き
`commands`	コマンドの実行	手元のコマンドの実行（Cowork はまだこの道具を提供していません）
`browser`	Chrome の操作	共有した Chrome のタブの読取りと操作
`computer`	PC の操作	選んだアプリの画面の取得と入力
`external_transfer`	外部への送信	ページへの入力などで手元の内容を外へ送ること

設定がない場合と、enabled が false の場合は、手元の機能をすべて禁止として扱います。各機能の動きは確認と組織の設定を参照してください。

Cowork が使うのは、設定したモデルのうち、いま Model Gateway で使えるもの（available_models）の先頭のモデルです。利用者がモデルを選ぶ画面はありません。

設定を変える

設定は API で読み書きします。Console の画面はまだありません。

操作	API	必要な権限
読む	`GET /v1/cowork/policy`	`cowork:run` または `cowork:manage`
変える	`PUT /v1/cowork/policy`	`cowork:manage`

変えるときは、先に GET で今の設定を読み、応答の version を If-Match に付けます。ほかの人が先に変えていた場合は、保存せずにエラーを返します。

PUT /v1/cowork/policy
Authorization: Bearer <アクセストークン>
If-Match: "3"
Content-Type: application/json

{
  "enabled": true,
  "models": ["<Model Gateway のモデル名>"],
  "daily_token_limit": 200000,
  "session_token_limit": 60000,
  "max_output_tokens": 2048,
  "local_tools": {
    "files": "allow",
    "commands": "deny",
    "browser": "confirm",
    "computer": "deny",
    "external_transfer": "deny"
  }
}

local_tools を省くと、保存済みの手元の機能の決まりをそのまま使います。アクセストークンは、設定したいプロジェクトと環境を指定して取得します（認証）。

利用者の Cowork は、道具を使うたびに 5 秒以内に読んだ設定で判断します。設定を変えると、実行中の作業にも数秒で反映します。

利用者に必要な権限

Cowork を使うには cowork:run が必要です。組み込みのロールでは、developer・operator・admin・owner が持っています。viewer は持っていません。設定を変える cowork:manage は admin と owner が持っています。

Cowork のモデル用の資格情報は 5 分で期限が切れ、Cowork が期限の前に更新します。Platform は更新のたびに、利用者の権限・設定・残りの利用枠を確かめ直します。利用者が停止された場合や cowork:run を失った場合は、更新を拒否し、実行中の作業でもモデルを呼べなくなります。

利用量と記録

モデルの呼出しは、上流へ渡す前に記録し、利用枠を予約します。呼出しが終わると、実際の使用量に置き換えます。上限に達すると、利用者の画面に「モデルの利用上限に達しました。組織の利用状況を管理者に確認してください。」と表示します。

呼出しの記録には、モデル・結果・入力と出力のトークン数・かかった時間を残します。依頼や応答の本文、ファイル名、資格情報は残しません。

展開するときの注意

配布物は署名していません。 macOS の公証、Windows の署名、自動更新はまだありません。端末管理の方針と合うかを確かめてください。
ログインは仮の方式です。 利用者は接続先の URL とアクセストークンを入力します。通常のログインとトークンの更新はまだありません。
最初は狭く許可します。 files だけを allow か confirm にし、ほかは deny から始めることをおすすめします。browser と computer はプレビューの機能です（普段の Chrome を使う、アプリを操作する）。
Windows には OS のサンドボックスがありません。 macOS ではハーネスの通信と書込みを OS で制限しますが、Windows には同じ制限がまだありません。
端末に履歴が残ります。 会話の本文と作業の記録は端末のアプリ用データに保存します。端末のディスクの暗号化を前提にしてください。
手元の操作は Platform の監査記録に残りません。 残るのはモデルの呼出しの記録です。フォルダ・サイト・アプリごとの細かな設定もまだありません。
OS の許可が必要です。 PC の操作には、macOS の画面収録とアクセシビリティの許可が要ります。

アンインストールするときは、Cowork で Chrome の接続を解除してから削除し、アプリ用データのディレクトリも削除します。Cowork のために組織のクラウドの資源やアカウントを作る必要はありません。

次に読む

Cowork の安全の仕組み資格情報・通信・OS の制限

Model GatewayPlatform のモデルの利用

提供状況と制限機能ごとの現在の状況