> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Apps

> Devin Appsは、Devinが構築し、自身のマシン上で固定URLから提供するウェブアプリです。作成、共有、固定、更新の方法と料金について説明します。

Devin Appは、Devinがあなたのために構築し、自身のマシン上で提供し続けるウェブアプリです。社内ツール、ダッシュボード、フォーム、トラッカー、デモなど、さまざまな用途に使えます。各Appには固定のURLがあり、チームと共有できます。

Appは[ブラウザプレビュー](https://docs.devin.ai/ja/work-with-devin/browser-previews.md)と同じ仕組みで提供されます。プレビューは1つのセッション内で進行中の作業を確認するためのもので、ほとんどの作業にはこれで十分です。一方、Appはセッションの作業が終わった後もチームで使い続けるものに適しています。

> [!NOTE]
>
> Devin Appsは段階的に提供中です。サイドバーに **Apps** が表示されていない場合は、まだお使いの環境で有効になっていません。

## Devin Apps の仕組み

* **App は Devin のマシン上で実行されます。** Devin はセッション内で App を構築し、そのセッションのマシンから配信します。サードパーティのホストには何もデプロイされません。
* **技術スタックは問いません。** ポートで HTTP を提供できるものであれば、Devin はジョブに適した任意のフレームワークや言語を利用できます。
* **データはマシン上に保持されます。** App では、同じマシン上で動作する SQLite や Postgres など、任意のデータベースを利用できます。ファイルやアップロードされたデータも同じマシンに保存されます。
* **URL は固定です。** App の URL は `https://<name>--<id>.preview.devinapps.com` の形式です。更新しても変わらず、App の名前を変更しても同じままです。Devin はこの URL を把握しており、App が公開されるとあなたに知らせます。
* **App は非公開です。** App を開くには、誰であっても Devin へのサインインが必要です。アクセスできるユーザーはあなたが選択します。App が一般公開されることはありません。
* **App はセッションによって管理されます。** App を構築したセッションが、その後の変更の反映も担います。App を変更するには、そのセッションにメッセージを送信してください。

## ユースケース

* **自社プロダクトのベータ版やステージング環境。** Devinは自身のマシン上で、フロントエンド、バックエンド、データベース、各種ワーカーなど、あなたの会社の実際のスタックを実行できます。そのため、Devin Appは、アプリのベータ版やステージング環境のコピーを置く場所に最適です。別途ホスティングを用意しなくても、チームメンバーはリンクから開けます。
* **社内ツール。** 管理パネル、リクエストフォーム、承認キュー、共有スプレッドシートに代わる小規模なツールなど。
* **ダッシュボード。** メトリクス、オンコールの健全性、サポートキュー、売上の数値などを自社のデータソースから取得し、スケジュールに沿って更新します。
* **段階的展開のトラッカー。** 移行、リリース、機能フラグの段階的展開がどこまで進み、何が残っているかを示すページ。
* **デモとプロトタイプ。** 本格的に構築する前に、関係者が実際にクリックして試せる、アイデアの動作版。

## Appの作成

1. サイドバーで [**Apps**](https://app.devin.ai/apps) を開きます。
2. Appで実現したい内容を記述します。promptテンプレートを選んで、それをベースに始めることもできます。
3. promptを送信します。

新しい Devin セッションが開始されます。Devin は確認したいことがあれば最初のメッセージで質問し、その後Appをビルドしてオンラインで公開します。Appは URL とともにすぐに **Apps** に表示され、最初のバージョンが公開されるまでステータスは **Building** になります。

どのセッションからでもAppの作成を依頼できます。例えば「これを Devin App としてビルドして」のように依頼します。Devin がすでにブラウザプレビューを表示している場合は、そのプレビューをAppとして公開するよう依頼することもできます。

## スリープ、復帰、請求

Devin のマシンは、誰も使用していないときはスリープ状態に移行します。誰かがアプリを開くと、マシンが復帰してページを返します。スリープ後の最初の読み込みには数秒かかることがあります。マシンは最後のリクエストから 5 分後に再びスリープ状態に移行します。

アプリの請求は、マシンが起動している時間に基づいて計算されます。誰もアクセスしないアプリは、マシンがスリープ中であれば何も消費しません。アプリの構築や変更は通常のセッション作業として扱われ、他のセッションと同様に請求済みになります。詳しくは [使用量](https://docs.devin.ai/ja/admin/billing/usage.md) を参照してください。

## App を共有する

App の **Share** をクリックすると、リンクをコピーしたり、App を開けるユーザーを変更したりできます。**General access** には 3 つの階層があります。

| 階層 | App を開けるユーザー |
| - | - |
| **Only people with access** | 作成者、組織管理者、およびあなたが追加したユーザー |
| **組織** | ご利用の組織の全員、およびあなたが追加したユーザー |
| **Enterprise** | お客様の企業内のすべての組織のメンバー |

特定のユーザー、グループ、組織を追加して、それぞれに許可する操作 (App を開く、設定を編集する、他のユーザーと共有する) を選ぶこともできます。

組織管理者は、**Sharing defaults** で組織内のすべての App に適用するデフォルトの共有階層を設定できます。

## アプリの検索と固定

Apps ページには、あなたが開けるアプリが一覧表示されます。検索、カテゴリー、フィルターで絞り込むこともできます。よく利用するアプリは固定できます。固定には 2 種類あります。

* **Pin for me**：あなた自身の Apps ホームの上部にアプリを固定します。
* **Pin for everyone**：組織全体の Apps ホームの上部にアプリを固定します。この操作は組織管理者のみが行えます。

他のユーザーのアプリが気に入った場合は、**Use as a starting point** を利用すると、そのアプリをベースに新しいアプリを作成できます。

## アプリの更新

アプリを開いて **Edit in session** をクリックし、変更内容を Devin に伝えます。Devin が変更を加え、新しいバージョンをビルドして公開します。URL は変わりません。

更新するたびに新しいバージョンが作成されます。アプリのページの **Deployments** には各バージョンが一覧表示され、それぞれのステータス、説明、コミットを確認できます。新しいバージョンの起動に失敗した場合は、以前のバージョンが引き続き稼働します。古いバージョンに戻すには、そのバージョンを再デプロイするようセッションに依頼してください。

アプリのページでは、過去 24 時間、7 日間、30 日間のページビューも確認できます。

アプリの作成者と組織管理者は、アプリの設定から名前の変更、説明の編集、カバー画像の設定、オフライン化、削除を行えます。アプリをオフラインにしても履歴は保持されますが、削除すると URL にアクセスできなくなります。いずれの操作もセッションには影響しません。

## Devin がアプリを構築する仕組み

Devin はアプリを構築する際、built-in の一連の指示に従います。主なポイントは次のとおりです。

* **本番用 build を配信します。** Devin は開発サーバーで開発を進め、ブラウザプレビューで動作をチェックします。アプリが正しく動作したら build を実行し、開発サーバーではなく本番用 build を配信します。
* **コードを git で管理します。** Devin はデプロイのたびに事前にコミットするため、各バージョンは必ずいずれかのコミットに対応します。アプリがあなたのリポジトリ内にある場合、Devin はコミットをプッシュするか、プルリクエストを作成します。
* **データを build フォルダの外に保持します。** データベースファイルやアップロードされたファイルは再構築されるフォルダの外に保存されるため、更新やロールバックで消えることはありません。
* **あなたのブランドを利用します。** 特定のデザインの指定がない限り、Devin はあなたのリポジトリから会社のデザインシステムを探し、その色、フォント、コンポーネントを利用します。ブランドの参照元もあわせて伝えます。見つからない場合は、シンプルなデフォルトスタイルを利用します。
* **最初に質問をまとめて行います。** リクエストを送信した後はその場を離れるユーザーが多いため、Devin は必要な確認事項を最初の返信ですべて質問します。
* **壊れたバージョンを放置しません。** デプロイに失敗した場合、Devin はエラーを確認して修正し、再度デプロイします。
* **サムネイルを作成します。** デプロイ後、Devin はアプリのスクリーンショットを撮影し、Apps ページのカードに使用します。

これらはすべて prompt で上書きできます。たとえば、使用するスタック、データベース、デザインを指定できます。

## 自動化でアプリを最新の状態に保つ

アプリは、あなたからの変更依頼を待つ必要はありません。[自動化](https://docs.devin.ai/ja/product-guides/automations.md)を使えば、Devin を復帰させてアプリを自動的に更新させることができます。代表的なセットアップは次の 2 つです。

* **スケジュール実行。** Devin が 1 時間ごと、毎日、または毎週起動し、最新のデータを取得してアプリを更新します。ダッシュボードやレポートに適しています。
* **プッシュごとの実行。** アプリがあなたのリポジトリのいずれかのブランチに追従している場合、そのブランチが変更されるたびに Devin がアプリを再デプロイします。

設定はアプリのセッションに依頼してください。Devin が自動化を作成するので、あなたは一度承認するだけで済みます。自動化ページで自分で作成し、アプリのセッションにメッセージを送るよう設定することもできます。

> [!WARNING]
>
> 自動化の各 run は 1 つの Devin セッションであり、通常のセッションと同様に請求済みになります。数分ごとに更新されるアプリでは、アプリ自体よりもはるかに高いコストがかかる場合があります。コストを抑えるには、次の点に注意してください。
>
> * 自動化の実行頻度を下げる。ほとんどのダッシュボードでは、1 時間ごとや 1 日ごとの更新で十分です。
> * 自動化のセッションには、よりコスト効率の高いモデルを選択する。
> * 作業量を小さく抑える。新しいデータのみを取得するスクリプトを作成し、更新のたびにそのスクリプトを実行するよう Devin に依頼してください。こうすることで、Devin が毎回一から問題を解き直す必要がなくなります。
> * 自動化にセッションごとの支出上限を設定する。詳しくは [上限と安全策](https://docs.devin.ai/ja/product-guides/automations.md#limits-and-safeguards) を参照してください。

## シークレットとその他のサービス

アプリは他のサービスのデータを読み取ったり、書き込んだりできます。Devin は、通常のセッションと同じ方法でこれを設定します。

* **他のサービスの API キー。** キーを[シークレット](https://docs.devin.ai/ja/product-guides/secrets.md)として追加し、どのサービス用のキーかを Devin に伝えます。Devin はキーをアプリのサーバーに渡し、アプリはサーバーからそのサービスを呼び出します。キーは必ずアプリのサーバー側で保持してください。ブラウザに送信されたものは、アプリを開けるすべてのユーザーに見えてしまいます。
* **Devin API。** アプリは、[個人用アクセストークン](https://docs.devin.ai/ja/api-reference/personal-access-tokens.md)またはサービスユーザーキーを使って [Devin API](https://docs.devin.ai/ja/api-reference/overview.md) を呼び出せます。これにより、フォームからセッションを開始するページや、チームのセッションを一覧表示するダッシュボードなど、Devin を基盤とした独自のツールを構築できます。個人用アクセストークンはあなた自身として動作するため、そのアプリを利用するすべてのユーザーがあなたの権限で操作することになります。このようなアプリは慎重に共有してください。
* **サインイン。** アプリを開くユーザーは全員すでに Devin にサインインしているため、ほとんどのアプリでは独自のログイン機能は不要です。

シークレットは、アプリの他の部分と同様に Devin のマシン上に保存されます。シークレットはアプリの共有設定の対象外であり、アプリ側で表示しない限り、アプリを開けるユーザーがシークレットを読み取ることはできません。

## アプリがオフラインになる場合

アプリは、それを提供しているセッションに依存しています。次の点に注意してください。

* **セッションをアーカイブまたは終了すると、アプリはオフラインになります。** アプリを処理しているセッションをアーカイブしようとすると、Devin が事前に警告を表示します。アプリを復旧するには、セッションをアーカイブ解除するか再開してください。
* **クラッシュしたサーバーは自動では再起動されません。** アプリのサーバーが停止すると、Devin が再起動するまで URL にはエラーページが表示されます。アプリのセッションを開き、Devin に再デプロイを依頼してください。
* **ライブバージョンのないアプリにはオフラインページが表示されます。** 最初のデプロイが完了する前や、誰かがアプリをオフラインにした後には、このページが表示されます。

いずれの場合も、対処法は Apps ページからアプリのセッションを開き、Devin にデプロイを依頼することです。

## 制限事項

* アプリを公開することはできません。訪問者は必ず Devin にサインインする必要があります。
* アプリは独自の Service Worker を登録できないため、PWA のオフラインモードは利用できません。
* アプリは 1 台のマシン上で動作します。社内ツールやダッシュボードには適していますが、高トラフィックの本番サービスには向いていません。そのような用途では、既存の CI/CD を使ってあなたのインフラストラクチャにデプロイし、[シークレット](https://docs.devin.ai/ja/product-guides/secrets.md)と[スキル](https://docs.devin.ai/ja/product-guides/skills.md)を通じて Devin にアクセス権を付与してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.