このページでは、Devin セッションにおけるプレビューについて説明します。Devin Desktop でローカル開発サーバーをプレビューする方法については、Devin Desktop プレビューを参照してください。
プレビューを開く
Devin は、あなたに確認してほしいアプリを起動すると、プレビューを開きます。例えば「アプリをプレビューして」のように依頼して、プレビューを開かせることもできます。 Devin はチャットに Open preview カードを投稿します。カードをクリックすると、セッションの プレビュー タブでアプリが開きます。新しいブラウザタブでプレビューを開く場合は、Cmd キーまたは Ctrl キーを押しながらカードをクリックするか、カードを中クリックします。 Slack から開始したセッションでは、スレッドに Open preview リンクが投稿されます。プレビュー URL
プレビュー URL は次のような形式です。プレビューを開けるユーザー
プレビューは非公開です。パブリックなインターネットには一切公開されません。 プレビューの URL を開くには、Devin にサインインしている必要があります。サインイン後は、プレビューへのアクセス権はそのセッションのアクセス設定に従います。セッションにメッセージを送信できるユーザーであれば、そのプレビューを開くことができます。 デフォルトでは、組織内で Devin セッションを利用できるすべてのユーザーが対象となるため、チームメイトにリンクを送るだけでそのまま開いてもらえます。セッションがオーナーのみ、または特定のユーザーに制限されている場合は、それらのユーザーだけがプレビューを開けます。それ以外のユーザーには、プレビューを利用できない旨のページが表示されます。プレビュータブでできること
プレビュータブは小さなブラウザのように動作します。進む、戻る、再読み込み、ズーム、ページ内検索の各ボタンに加え、デスクトップ、タブレット、モバイルの幅を切り替えるデバイスサイズ切り替え機能を備えています。 ページ上の要素に注釈を付けて、Devin に変更内容を伝えることもできます。セッションで「選択」ボタンを使用する場合は、要素をクリックするか領域をドラッグし、メモを追加してチャットに送信するだけです。Devin は、選択された要素とあなたのメモを受け取ります。複数のポートを使用するアプリ
プレビューでは、あるポートでフロントエンドを、別のポートでバックエンド API を動かすなど、複数のポートを扱えます。Devin はプレビューを開く際にそれらのポートをすべて一覧表示し、プレビューは最初のポートで開きます。ポートを切り替えるには、プレビュータブの Ports メニューを利用します。 フロントエンド側でプレビュー URL を意識する必要はありません。ページがhttp://localhost:8000 を呼び出すと、プレビューはそのリクエストを Devin のマシン上のポート 8000 に転送します。これは、プレビューがインストールする Service Worker があなたのブラウザ内でリクエストを書き換えることで実現されており、WebSocket 接続も同様に処理されます。リクエストはプレビュー自体のアドレス上で完結するため、CORS 設定を変更する必要はありません。
この仕組みで接続できるのは、Devin がプレビュー用に公開したポートのみです。
アプリからの見え方
サーバーからは、リクエストはlocalhost から送られてきたように見えます。プレビューはリクエストがアプリに届く前に Host ヘッダーと Origin ヘッダーを localhost に設定するため、ホスト名をチェックする開発サーバーも追加の設定なしで動作します。Devin も、アプリの実行時とテスト時のどちらでも引き続き localhost を利用します。
ただし、自分のコンピューターでアプリを実行する場合とは、いくつかの点で動作が異なります。
- Service Worker。 プレビューは独自の Service Worker を利用するため、アプリ側で Service Worker を登録することはできません。アプリが PWA の場合は、開発時に Service Worker を無効にするか、ポートの自動書き換えが機能しない場合があることを許容してください。
- クッキー。 プレビュータブ内でアプリが設定したクッキーは、プレビューを別のブラウザタブで開いたときに設定されたクッキーとは別々に保持されます。そのため、一方でアプリにサインインしても、もう一方で再度サインインが必要になる場合があります。
- アイデンティティプロバイダーによるサインイン。 ブラウザが開いているのは
localhostではなくプレビュー URL です。Microsoft Entra ID、Okta、Google などのプロバイダーでは、リダイレクト URL としてlocalhostしか登録されていない場合、サインインが拒否されます。ポートのトンネリングを参照してください。 - HTTPS 開発サーバー。 ブラウザに表示されるのは、サーバーの証明書ではなく Devin の証明書です。HTTPS ループバックを参照してください。
ポートのトンネリング
一部のサービスは、ブラウザが実際にlocalhost 上にある場合にしか動作しません。代表的な例が、アイデンティティプロバイダーを介したサインインです。プロバイダーは登録済みのリダイレクト URL しか受け付けず、ほとんどの開発環境では http://localhost:<port> が登録されています。プレビューには独自の URL があるため、プロバイダーに拒否されてしまいます。
このような場合は、Devin のマシンから手元のコンピューターへポートをトンネルできます。これにより、アプリはブラウザ上で http://localhost:<port> として開かれ、自分のコンピューターで実行している場合と同じように扱われるため、プロバイダーにも受け付けられます。
ポートをトンネルする方法は 2 つあります。
- Devin Desktop: Devin Desktop でセッションを開き、そこからポートをフォワードします。
- SSH:
devin forward <session> 3000を実行するか、devin sshまたは通常のsshに-L 3000:localhost:3000を渡します。ポートのフォワードを参照してください。
localhost が必要な場合にはトンネルを利用してください。
プレビューを使い続けたい場合は、セッションのプレビュー URL をプロバイダーのリダイレクト URL リストに追加するか、プロバイダーを経由しない開発用のサインイン手段をアプリに用意してください。また、Devin は自身のブラウザで localhost にサインインすることもできます。Interactive Browserを参照してください。

