認証、承認、下書き

Architectが代理で行う操作、承認が必要なタイミング、安全に変更を準備する方法について説明します。

Architectの認証方法

Architectは個別のサービスアカウントを使用したり、別のIDとして動作したりしません。ログイン中のセッション内で実行されます。エージェント設定の取得、プロンプトの更新、ブランチの作成など、Architectが行うすべての読み取り・書き込みは、ダッシュボードの他の部分と同じ認証済みリクエストを通じて、アカウントおよびワークスペースの権限の範囲内で行われます。

つまり、Architectができるのは、すでに許可されている操作だけです。ロールにmainブランチへのマージ権限がない場合や、リソースが共有されていない場合、Architectもその操作はできません。

承認モード

Architectの各会話は、コンポーザーから切り替え可能な次の3つのモードのいずれかで実行されます。

モード動作
承認が必要(デフォルト)何かを変更するツールを実行する前に、Architectは変更内容を正確に表示し、承認または却下を待ちます。
自動承認ブランチのマージや下書きの破棄といったリスクの高い操作を含め、制限付きツールの確認ステップを省略します。依頼した変更に確信が持てる場合に使用してください。
プランArchitectはまず調査してプランを作成し、プランを承認した後にのみ編集を開始します。

ツールの一覧表示やエージェントの現在の設定の取得など、読み取り操作はどのモードでも承認を必要としません。同じ会話内で一度承認したツールは信頼済みとして扱われ、新しい会話を開始するまで再度確認されません。

下書き、公開、マージ

エージェントの設定、プロンプト、ワークフロー、ツール、テスト、ナレッジベースへの変更は、作業中のブランチに未公開の下書きとして準備されます。公開するまで、Architectが行った操作が実際の発信者に影響することはありません。

  • 現在の下書きと公開済みの内容を比較して確認するには、これまでに変更した内容をArchitectに尋ねてください。
  • Architectは公開ダイアログを開けますが、自身で公開をクリックすることはできません。差分を確認してから確定してください。
  • 公開後も作業を続けられます。Architectに追加の変更を依頼し、確認して再び公開するというサイクルを、必要なだけ繰り返せます。

ブランチ

大規模な変更では、ライブのブランチを直接編集するのではなく、別のブランチで作業してください。Architectはブランチの作成、一覧表示、アクティブなブランチ間のトラフィック分割の調整を行えます。トラフィック分割の合計は常に100%である必要があります。

ブランチの変更をmainに取り込む準備ができたら、Architectにマージを依頼してください。Architectはまずマージのプレビューを表示します。自動承認モードでも、マージ自体には承認が必要です。mainへのマージには管理者権限が必要になる場合があります。また、未保存の下書きがあるブランチは、マージまたは別のブランチへの切り替え前に保存または破棄する必要があります。