対応環境
入口
- サイドバーの New chat ボタン、または
⌘N。 ⌥⌘O:No project を選択した状態で新規チャットページを開きます。- サイドバーのプロジェクト行にカーソルを合わせると表示される +、またはプロジェクトページの New task in this project:そのプロジェクトを選択した状態で新規チャットページを開きます。
⌘ を Ctrl に、⌥ を Alt に置き換えてください(以下同様)。
新規チャットページの構成
セッションはプロジェクトの現在の作業ディレクトリで開始します。新規チャットページにはブランチの選択はありません。
手順
- New chat をクリックします。プロジェクトのデフォルトは No project です。
- (任意)プロジェクトを選びます。
- (任意)実行環境として Cloud server または Run on your device の下のデバイスを選びます。
- (任意)権限、モデル、推論レベルを調整します。
- 依頼内容を書き(添付ファイルのみの送信も可能です)、
Enterで送信します(改行はShift+Enter)。 - セッションがサイドバーに表示されます。セッションが作成されると自動でセッションページに移動し、エージェントが作業を開始します。
プロジェクトを選ぶ
プロジェクトボタン(⌥⇧⌘O)をクリックしてメニューを開きます。プロジェクトの検索、プロジェクトの選択、New project、No project を選べます。新規チャットページでは、⌥⌘1〜⌥⌘9 でプロジェクト 1〜9 を直接選ぶこともできます。
- 各プロジェクトの下にはソースのテキストが 1 行表示されます(GitHub リポジトリ名、Local · folder name など)。セットアップが完了していないプロジェクトには Setting up · not ready yet と表示されます。
- 別のコンピューター上のローカルプロジェクトも選択できます。セッションはそのデバイス上で実行されます。そのデバイスがオフラインの場合は Device offline と表示されます。
- 新規チャットページは前回選んだプロジェクトを記憶しません。New chat をクリックするたびに No project に戻ります。
プロジェクトなし
No project のセッションはプロジェクトに紐づきません。一時的な作業ディレクトリで実行され、Q&A、スクリプトの作成、資料の整理などに向いています。サイドバーの Chats グループに表示され、後からプロジェクトに移動できます。メッセージとセッション操作 を参照してください。実行環境を選ぶ
実行環境は、エージェントがどのマシン上でファイルを読み書きし、コマンドを実行するかを決めます。エージェント自体は常にクラウドで動作します。- デフォルトは Cloud server です。ローカルプロジェクトは、プロジェクトがあるデバイス上での実行がデフォルトです。
- 選択できないデバイスはグレー表示になり、理由(Device offline、Execution disabled など)が表示されます。
- 実行デバイスはセッション作成時に決まり、後から変更できません。別のデバイスを使うには、新しいセッションを作成してください。
権限を選ぶ
権限は、エージェントが操作の前にあなたに確認するかどうかを決めます。メッセージボックス左下の権限ボタン(Ctrl+Shift+S)をクリックします。
- 新しいセッションのデフォルトは Full access です。新しいセッションは毎回デフォルトから始まり、前回の選択は記憶されません。
- デバイス上で実行する場合、権限はデバイスの権限の上限を超えられず、上限を超えるレベルはグレー表示になります。上限は、そのデバイス上のアプリの Machines & access で変更してください。
- 開始済みのセッションでも、いつでも権限を変更できます。修復タスクとアーカイブ済みのセッションは変更できません。
- 承認のリクエストへの対応方法は、対応が必要 を参照してください。
フルアクセスを有効にする際の確認
デバイス上で実行していて Full access に切り替えると、Turn on full access? が表示されます。エージェントがあなたの同意なしにコマンドの実行、インターネットへのアクセス、任意のファイルの作成と変更を行えるようになることが説明され、機密データの消失や漏洩、プロンプトインジェクションなどのリスク(エージェントがこのプロジェクトのすべてのシークレットを読み取れることを含む)が記載されています。Confirm をクリックした場合のみ切り替わります。Cancel をクリックするかEsc を押すと、元の権限のままになります。
モデルと推論レベルを選ぶ
メッセージボックスの右下には、モデルボタンと推論レベルボタンがあります。新しいセッションでは、アカウントのデフォルトの選択、または前回セッションを作成したときの選択が使われます。詳しくは Harness とモデル を参照してください。送信前の確認
以下のダイアログは初回のみ表示されます。どのダイアログでも Cancel をクリックするとメッセージは送信されず、テキストと添付ファイルはメッセージボックスに残ります。デフォルトでフルアクセス(フルアクセスでの初回送信)
Full access by default ダイアログでは、エージェントがコマンドの実行、依存関係のインストール、クラウド環境内のファイルの変更、インターネットと接続済みサービスへのアクセス、このプロジェクトのすべてのシークレットの読み取りを行えることが説明されます。また、メッセージボックス左下でいつでも Ask for approval または Approve for me に切り替えられることも記載されています。Got it, start the task をクリックすると送信され、このダイアログは再表示されません。クラウドサーバーの管理者権限(クラウドサーバー上での初回送信)
クラウドサーバーの管理者権限が有効になっている場合、初めてクラウドサーバー上でセッションを開始するときに Turn on admin access on cloud server が表示され、次の点が示されます。- エージェントはクラウドサーバー上で管理者権限を持ち、クラウドサーバーに保存された認証情報を読み取れます。
- 承認とブランチの制限は推奨にとどまり、強制されなくなります。
- 無効にしても、すでに行われた変更は元に戻りません。システムファイルを誤って変更した場合、クラウドサーバーの再構築が必要になることがあります。
ルールと状態
その他のエラーについては、エラーと復旧 を参照してください。