Local Hands は段階的に提供中です。Local Hands 設定が表示されない場合、ご利用の組織ではこの機能をまだ利用できません。
Local Hands は機能名で、アクセスカードやトースト通知では local machine access と表記されます。セッションヘッダーでは、接続済みのマシンが Local Hands として表示されます。なお、Local Hands は、Devin にプライベートネットワークへのアクセスを提供する Devin Connect とは別の機能です。
仕組み
1
Devin がアクセスをリクエストする
タスクにあなたのマシンが必要になると、Devin はセッション内に Local machine access requested カードを投稿します。カードには、リクエストの理由と有効期限が表示されます。Devin Desktop では Approve ボタンが、ブラウザでは ペアリングコード付きの
devin connect コマンドが表示されます。「ローカルマシンでテストを実行して」のように、直接依頼することもできます。2
マシンを接続する
Devin に利用させたいマシン上でリクエストを承認します。Devin Desktop で Approve をクリックするか、ターミナルで
devin connect を実行してください。詳しくはマシンを接続するを参照してください。3
Devin がローカルツールを利用する
Devin のローカルツールが利用可能になり、ヘッダーに Local Hands チップが表示されます。バイパスを有効にしない限り、ツール呼び出しはすべてあなたが個別に承認します。
4
接続が終了する
アクセスを失効させた場合、
devin connect を停止した場合、リクエストを承認した Devin Desktop のウィンドウを閉じた場合、またはセッションが終了した場合に、接続は終了します。それに伴い、ローカルツールも利用できなくなります。要件
- 自分が所有するクラウドセッションであること。Devin はペアリングコードをセッション所有者のアカウントに発行するため、セッションを閲覧している他のユーザーが自分のマシンを接続することはできません。スケジュールされたセッション、自動化、サービスユーザーが実行する API セッションなど、アクセスを承認するユーザーがいないセッションでは、マシンをリクエストできません。
- 接続するマシンに Devin CLI または Devin Desktop がインストールされており、セッションを所有しているのと同じ Devinアカウントでサインインしていること。CLI の場合は
devin auth loginを実行してください。 - 組織で Local Hands 設定が有効になっていること。詳しくは利用可能状況を参照してください。
マシンを接続する
最も簡単なのは Devin Desktop を利用する方法です。Devin Desktop でセッションを開き、Approve をクリックします。ブラウザから作業している場合は、接続したいマシンのターミナルで、カードに表示されているdevin connect コマンドを実行します。
リクエストは使い捨てで、Devin が作成してから 10 分で期限切れになります。新しいリクエストが作成されると古いリクエストは置き換えられ、以前のペアリングコードは使用できなくなります。
- Devin Desktop
- ターミナル
- devin --cloud
Devin Desktop でセッションを開くと、カードに Approve と Decline が表示されます。Approve をクリックすると、Devin Desktop が動作しているマシンが接続されます。ペアリングコードやターミナルは不要です。CLI を利用したい場合は、Use the terminal instead をクリックするとコマンドが表示されます。
セッションのプライバシー
自分が所有するセッションにマシンを接続すると、Devin はそのセッションを非公開にし、あなただけがメッセージを送信できるようにします。これにより、組織内の他のユーザーが、あなたのコンピューター上でコマンドを実行できるセッションを操作することを防ぎます。 セッションのプライバシー設定を変更せずにそのままにするには、--public を指定します。
あなたのマシン上で Devin ができること
Devin は、シェルコマンドの実行、ファイルの読み取りと検索、ファイルの作成と編集、およびあなたのマシンとセッションの VM との間でのファイルのコピーを行えます。Devin があなたのマシンの画面、キーボード、マウスを操作することはありません。Computer use が適用されるのはセッションの VM のみです。承認
デフォルトでは、ローカルのツール呼び出しはすべて一時停止し、あなたに確認を求めます。セッションにはツールとその引数が表示され、次の3つから選択できます。- Allow once: この呼び出しを実行します。
- Allow for this session: この呼び出しに加え、同じツールに対する以降の呼び出しも、マシンが切断されるまで確認なしで実行します。
- Deny: この呼び出しを拒否します。Devin は拒否されたことを把握し、別のアプローチを試すことができます。
allow ルールに一致した呼び出しは確認なしで実行され、deny ルールに一致した呼び出しは阻止され、ask ルールに一致した呼び出しは毎回確認が求められます。これには、お客様の組織がチーム設定で設定したルールも含まれます。
ローカル権限をバイパスする
呼び出しごとの確認プロンプトを止めるには、アクセスカードまたは Local Hands メニューで Bypass local permissions をクリックします。以降はマシンが切断されるまで、ローカルのツール呼び出しが確認プロンプトなしで実行されます。保留中のリクエストも即座に承認されます。 すべての接続をバイパス状態で開始するには、Devin CLI の設定でlocal_tools_bypass_permissions を設定します。セッションからバイパスのオン／オフを切り替えると、CLI がこの設定を更新します。
常に確認を求める呼び出し
built-in のルールにより、一部の呼び出しはバイパスが有効な場合でも毎回確認を求めます。これらは Allow for this session や独自のallow ルールでも承認されません。対象となるのは、認証情報ファイルや秘密鍵、権限昇格、破壊的なコマンド、シェルインタープリター、シークレットストア、およびシェルプロファイルや Git 設定への書き込みです。承認カードには、その呼び出しに明示的な承認が必要な理由が表示されます。あなたが設定した ask ルールや組織の ask ルールも、同じように動作します。
接続の切断またはアクセスの失効
- アクセスを失効する: アクセスカードまたは Local Hands メニューで Revoke access をクリックします。Devin はただちにローカルツールを利用できなくなります。
- CLI を停止する:
devin connectを実行しているターミナルでCtrl+Cを押します。 - Devin Desktop を閉じる: リクエストを承認した Devin Desktop ウィンドウを閉じるか、Devin Desktop を終了すると、接続は終了します。
- セッションを終了する: セッションが終了すると、接続も終了します。
devin connect は、ネットワークが一時的に切断されても自動的に再接続します。マシンがオフラインのままの場合やコマンドを停止した場合は、チップにそのマシンが切断済みとして表示されます。再接続するには、Devin にアクセスを再度リクエストするよう依頼し、新しいコードを使用してください。
利用条件
組織管理者は、設定 > Devin の Local Hands トグルでこの機能のオン/オフを切り替えられます。このトグルは、エンタープライズに属していない組織ではデフォルトでオン、エンタープライズに属している組織ではデフォルトでオフになっています。 次のいずれかに該当する場合、Local Hands は利用できません。- セッションでセキュリティプロファイルを利用している場合
- ご利用の組織でネイティブデプロイメントがオフになっている場合
- セッションにアクセスを承認するユーザーがいない場合 (スケジュールされたセッション、自動化、サービスユーザーによる API セッションなど)
トラブルシューティング
関連リソース
CLI での Devin Cloud
ターミナルからクラウドセッションを開始・操作する
CLI の権限
ツール呼び出し用の許可 (allow) 、ask、拒否 (deny) ルールを記述する
クラウドDevinに引き継ぐ
ローカルのタスクをクラウドセッションに移す
Computer Use
Devin が自身の VM のデスクトップを利用する仕組み