@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/ja-JP/template-analytics.md

@@ -0,0 +1,259 @@
+---
+title: "分析"
+description: "わかりやすい英語で分析に関する質問をし、グラフやダッシュボードを取得します。 Amplitude、Mixpanel、Looker のオープンソースの代替品。"
+---
+
+# 分析
+
+平易な英語で分析に関する質問をし、グラフやダッシュボードを取得します。エージェントは、BigQuery、GA4、Amplitude、組み込みのファーストパーティ イベント コレクター、HubSpot、Jira、その他多数のソースに接続し、クエリを作成して検証し、回答をグラフ、表、または保存されたダッシュボード パネルとしてレンダリングします。
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:500px;box-sizing:border-box'><h1 style='margin:0'>Agent-Native Templates</h1><p class='wf-muted' style='margin:0'>Adoption and engagement across the last 12 weeks.</p><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px'><div class='wf-card'><small class='wf-muted'>Weekly active users</small><br/><strong>24,318</strong><br/><span class='wf-pill accent'>+12.4%</span></div><div class='wf-card'><small class='wf-muted'>New signups</small><br/><strong>1,842</strong><br/><span class='wf-pill accent'>+8.7%</span></div><div class='wf-card'><small class='wf-muted'>Revenue MRR</small><br/><strong>$48,210</strong><br/><span class='wf-pill accent'>+21.3%</span></div></div><div style='display:grid;grid-template-columns:1fr 1fr;gap:12px;flex:1'><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Weekly active users</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:38%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:44%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:58%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:74%;flex:1;background:var(--wf-accent-soft)'></div></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Revenue over time</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:32%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:48%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:63%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:80%;flex:1;background:var(--wf-accent-soft)'></div></div></div></div><div class='wf-card'><strong>Signups by source</strong><br/><small class='wf-muted'>Lower chart begins below the main charts.</small></div></div>"
+}
+```
+
+これは、コード、クエリ、データを所有したいチーム向けの、Amplitude、Mixpanel、Looker に代わるオープンソースです。
+
+```an-diagram title="Question to chart" summary="The agent consults the data dictionary, writes SQL, validates it against the warehouse, then renders a chart or saves a panel."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-node\">Plain-English<br>question</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads data dictionary</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">Dry-run validate</div><small class=\"diagram-muted\">BigQuery / source</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Chart, table, or<br>saved panel</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:6px;align-items:center}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## それを使って何ができるか
+
+- **わかりやすい英語でデータに関する質問をします。** 「先月のサインアップの何パーセントが有料に変換されましたか?」または「過去 6 か月間、毎週のアクティブ ユーザーを表示します。」エージェントは適切なソースを選択し、SQL を書き込み、グラフをレンダリングします。
+- **フィルタ、保存されたビュー、パラメトリック クエリを備えた再利用可能な SQL ダッシュボード**を構築します。
+- **複数のデータ ソースを相互参照するアドホック分析を実行します**。元の質問、指示、結果を含む再実行可能な調査として保存されます。
+- メトリック、テーブル、SQL レシピの**生きたデータ ディクショナリ**を維持し、エージェントが毎回正しい列名を使用できるようにします (実際には `hs_is_closed` であるにもかかわらず、`is_closed` を推測する必要がなくなります)。
+- **ダッシュボードをチームと共有** - デフォルトでは非公開で、閲覧者/編集者/管理者の役割を持つユーザーまたは組織ごとに共有可能です。
+- **多くのソースにすぐに接続**: BigQuery、GA4、Mixpanel、Amplitude、PostHog、HubSpot、Jira、Apollo、Pylon、Gong、Common Room、Twitter、アプリ固有の SEO ソース
+- **ワークスペースがすでに接続されている場合は、ワークスペース統合を再利用します**。
+  Analytics にプロバイダーを付与しました。共有統合ストアプロバイダ
+  アイデンティティと資格情報の参照。 Analytics はアプリ固有のソース選択を維持します。
+  データ ディクショナリ エントリ、ダッシュボード SQL、および分析履歴。
+
+## はじめに
+
+ライブデモ: [analytics.agent-native.com](https://analytics.agent-native.com)。
+
+初めてアプリを開いたとき:
+
+1. Google でサインインします。
+2. サイドバーから **データ ソース** ページを開きます。
+3. 各ソースにはウォークスルーがあり、必要なソースを接続します (BigQuery、GA4、Amplitude、ファーストパーティ トラッキングなどの 1 つから始めます)。
+4. エージェントとの新しいチャットを開き、「先週は何件の登録がありましたか?」と質問します。
+
+最初の質問は、接続が機能していることを確認するのに十分です。そこから、エージェントに「これをダッシュボードとして保存」するか、「主要指標用の 4 パネルの概要ダッシュボードを構築」するよう依頼します。
+
+### 便利なプロンプト
+
+- 「過去 6 か月間、毎週のアクティブ ユーザーを表示するダッシュボードを作成します。」
+- 「先月のサインアップの何パーセントが有料に変換されましたか?」
+- 「プランごとの収益を比較するグラフをこのダッシュボードに追加します。」
+- 「MRR メトリクスが最初になるように、このダッシュボードのパネルの順序を変更します。」
+- 「第 1 四半期の成立しなかった取引を分析し、分析を保存します。」
+- 「今月のデータを使用してチャーン分析を再実行します。」
+- 「このメトリクスをデータ ディクショナリに文書化します。」
+
+エージェントは、ユーザーが何を見ているのか (現在のダッシュボード、フィルター、ビュー) を常に知っているため、明示的に言わなくても「このダッシュボード」または「そのパネル」と言うことができます。
+
+## 知っておくべき 3 つのこと
+
+アプリには、時間を過ごす主な面が 3 つあります。
+
+- **SQL ダッシュボード** — フィルターと保存されたビューを備えた再利用可能なパネル。定期的にチェックする指標に最適です。
+- **アドホック分析** — 複数のソースから取得した長い形式の調査。再実行手順も一緒に保存されます。再検討したい 1 回限りの質問に最適です。
+- **データ ディクショナリ** — メトリクス、テーブル、列、SQL レシピの正規カタログ。エージェントは、SQL を書き込む前にそれを参照するため、実際のウェアハウス列名が使用され、「内部電子メールを除外する」などの注意事項が認識されます。
+
+エージェントに「dbt 定義をインポート」または「Notion ハンドブックからメトリクスを取得」するように依頼することで辞書がシードされ、エージェントが機能します。
+
+## 開発者向け
+
+このドキュメントの残りの部分は、Analytics テンプレートをフォークまたは拡張する人を対象としています。
+
+### クイックスタート
+
+CLI から新しい分析アプリを作成します:
+
+```bash
+npx @agent-native/core@latest create my-analytics --standalone --template analytics
+```
+
+ローカル開発者:
+
+```bash
+cd my-analytics
+pnpm install
+pnpm dev
+```
+
+CLI はローカル開発 URL を出力します。 Google でログインし、**データ ソース** ページを開いて、BigQuery、GA4、ファーストパーティ トラッキング、HubSpot、Jira などに接続します。
+
+### 主な機能
+
+**質問をし、グラフを取得します。** エージェントはデータ ソースを選択し、SQL を書き込み、検証してから、グラフ、テーブル、メトリック、または保存されたパネルをレンダリングします。
+
+**ダッシュボードと調査。** 再利用可能なダッシュボードには、SQL パネル、フィルター、保存されたビュー、共有が保持されます。アドホック分析では、再実行指示により長い結果が保存されます。
+
+**生きているデータ ディクショナリ。** メトリクスの定義、所有者、ソース テーブル、および既知の注意事項により、エージェントはクエリを作成する前に実際のウェアハウスの語彙を得ることができます。
+
+**幅広いコネクタ サーフェス。** BigQuery、GA4、製品分析、CRM、サポート、コミュニティ、GitHub/Jira、SEO、ファーストパーティ `/track` イベントはすべて、エージェントが呼び出すことができる actions 経由で行われます。
+
+### エージェントとの連携
+
+エージェントは、あなたが何を見ているのかを常に知っています。現在の画面状態は、`<current-screen>` ブロックとしてすべてのメッセージに挿入されます。これには、アクティブなビュー、開いているダッシュボードまたは分析、選択したフィルターが含まれます。
+
+エージェントのシステム プロンプトは、アクティブな組織の承認された指標エントリを含む、挿入された `<data-dictionary>` ブロックを取得します。ダッシュボードを要求すると、エージェントは最初に辞書を参照し、文書化された `table` / `columns` / `queryTemplate` をそのまま使用します。列名は推測しません。
+
+**自動的に持つコンテキスト:**
+
+- **現在のビュー** — `overview`、`adhoc` (`dashboardId` を使用)、`analyses` (`analysisId` を使用)、`data-dictionary`、`data-sources`、または `settings`。
+- **アクティブな組織** — すべてのクエリと書き込みのスコープを設定します。
+- **承認された辞書エントリ** — アクティブなワークスペース用。
+
+**ダッシュボードの編集。** エージェントは `update-dashboard` アクションを使用してダッシュボードを編集します。 2 つのモードをサポートしています:
+
+- `ops` — 外科的編集用の JSON ポインター パッチ (パネルの移動、1 つの SQL 文字列の置換、フィルターの削除)。
+- `config` — ダッシュボード設定の完全な置き換え。
+
+すべての BigQuery パネルの SQL は、ダッシュボードが保存される前にウェアハウスに対してドライランされます。列が間違っている場合、保存は BigQuery エラーで拒否されます。エージェントは破損したパネルを保持する代わりに、SQL を修正して再試行します。
+
+### データ ソースの接続
+
+**データ ソース** ページ (`/data-sources`) を開いてプロバイダーに接続します。各
+ソースは、env-key リスト、ウォークスルー、および **Test Connection** ボタンを公開します。
+Analytics がワークスペースで実行されている場合、`data-source-status` もレポートします
+エージェントができるように、`appId=analytics` に再利用可能なワークスペース接続を許可しました
+同じプロバイダー キーの別のコピーではなく、アプリの許可を要求します。
+Slack、HubSpot、Notion、GitHub などの再利用可能なプロバイダーの場合、データ
+ソース UI は、共有統合状態を直接表示します: ワークスペース経由で準備完了、
+許可が必要、認証情報、またはローカル認証情報が必要です。
+
+再利用可能なワークスペース統合は、共有プロバイダーの実行時の方向性です。
+フレームワークは、プロバイダー ID、アカウント メタデータ、資格情報参照を保存します。
+アプリごとに 1 回付与されます。 Analytics はデータソースの解釈、ソースを保存します
+真実の選択、指標の定義、ダッシュボード、分析。
+
+認証情報はフレームワークの設定/環境レイヤーを介して保存されます。git にはシークレットはありません。生産には以下が必要です:
+
+| 変数                                     | 目的                                                             |
+| ---------------------------------------- | ---------------------------------------------------------------- |
+| `DATABASE_URL`                           | 永続的な SQL 接続 URL                                            |
+| `BETTER_AUTH_SECRET` / `BETTER_AUTH_URL` | 認証                                                             |
+| `GOOGLE_SIGN_IN_CLIENT_ID` / `_SECRET`   | 優先 Google サインイン クライアント (OAuth 2.0)                  |
+| `GOOGLE_CLIENT_ID` / `_SECRET`           | レガシー サインイン フォールバック / Google API 統合クライアント |
+| `BIGQUERY_PROJECT_ID`                    | BigQuery プロジェクト                                            |
+| `GOOGLE_APPLICATION_CREDENTIALS_JSON`    | BigQuery サービス アカウント JSON                                |
+| `ANTHROPIC_API_KEY`                      | エージェントチャット                                             |
+
+プロバイダー固有のキー (HubSpot、Jira、Gong、Pylon など) は、「データ ソース」ページの各ソースのウォークスルーに文書化されています。 API キーを必要とする新しいアクションを追加すると、テンプレートのオンボーディング登録を介してそのページに新しいソースとして表示されます。
+
+注: Google ログイン用の BigQuery OAuth 認証情報は **別個**です
+認証情報。
+GCP コンソール → API とサービス → 認証情報 → OAuth クライアント ID を選択し、
+`GOOGLE_SIGN_IN_CLIENT_ID` / `GOOGLE_SIGN_IN_CLIENT_SECRET` 環境名はこれです
+低スコープのログイン クライアントは、Google API 統合クライアントから分離されたままになります。
+
+### データモデル
+
+コア テーブル (`templates/analytics/server/db/schema.ts` を参照):
+
+```an-schema title="Analytics data model" summary="Dashboards and analyses are the resources; views, shares, and a query cache hang off them. Org tables come from @agent-native/core/org."
+{
+  "entities": [
+    {
+      "id": "dashboards",
+      "name": "dashboards",
+      "note": "Explorer and SQL dashboards",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "kind", "type": "text", "note": "\"explorer\" or \"sql\"" },
+        { "name": "config", "type": "text", "note": "JSON matching SqlDashboardConfig" }
+      ]
+    },
+    {
+      "id": "dashboard_views",
+      "name": "dashboard_views",
+      "note": "Saved filter presets per dashboard",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "dashboard_id", "type": "text", "fk": "dashboards.id" }
+      ]
+    },
+    {
+      "id": "analyses",
+      "name": "analyses",
+      "note": "Re-runnable ad-hoc investigations",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "question", "type": "text" },
+        { "name": "instructions", "type": "text", "note": "Re-run steps" },
+        { "name": "dataSources", "type": "text", "note": "Sources touched" },
+        { "name": "resultMarkdown", "type": "text" },
+        { "name": "resultData", "type": "text", "nullable": true }
+      ]
+    },
+    {
+      "id": "bigquery_cache",
+      "name": "bigquery_cache",
+      "note": "Result cache keyed by SQL hash",
+      "fields": [
+        { "name": "sql_hash", "type": "text", "pk": true },
+        { "name": "bytes_processed", "type": "integer" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "dashboards", "to": "dashboard_views", "kind": "1-n", "label": "saved views" }
+  ]
+}
+```
+
+さらに、`@agent-native/core/org` によって提供されるリソースごとの共有テーブル (`dashboard_shares`、`analysis_shares`) と組織テーブル (`organizations`、`org_members`、`org_invitations`)。データ ディクショナリは、スコープ付きキーの下のフレームワークの `settings` テーブルに存在します。
+
+- **`dashboards`** — Explorer と SQL の両方のダッシュボード。 `kind` は `"explorer"` または `"sql"` です。 `config` は、`SqlDashboardConfig` に一致する JSON BLOB です。
+- **`dashboard_shares`** — リソースごとの共有付与 (プリンシパル、ロール)。
+- **`dashboard_views`** — ダッシュボードごとに保存されたフィルター プリセット。
+- **`analyses`** — `question`、`instructions`、`dataSources`、`resultMarkdown`、およびオプションの `resultData` を使用したアドホック調査。
+- **`analysis_shares`** — 分析に対するリソースごとの共有の許可。
+- **`bigquery_cache`** — バイト処理アカウンティングを使用した SQL ハッシュをキーとするクエリ結果キャッシュ。
+
+さらに、`@agent-native/core/org` によって提供される組織テーブル (`organizations`、`org_members`、`org_invitations`)。
+
+データ ディクショナリは、スコープ付きキーの下のフレームワークの `settings` テーブルに存在します。完全な形状については、`list-data-dictionary` および `save-data-dictionary-entry` actions を参照してください。
+
+### カスタマイズ
+
+Analytics テンプレートはフォークおよび拡張されることを目的としています。すべては `templates/analytics/` に存在します:
+
+- **`AGENTS.md`** — エージェントのトップレベルのガイド。ドキュメント ビュー、actions、ワークフロー。
+- **`actions/`** — エージェント呼び出し可能なすべての操作。新しいアクションを追加するには、新しいファイルを追加します。注目すべきもの:
+  - `update-dashboard.ts` — ダッシュボードの編集 (ops + 完全置換)
+  - `save-analysis.ts` / `list-analyses.ts` — アドホック分析
+  - `save-data-dictionary-entry.ts` / `list-data-dictionary.ts` — 辞書
+  - `bigquery.ts` — 生の BigQuery 実行
+  - `view-screen.ts` / `navigate.ts` — コンテキスト認識
+- **`app/routes/`** — ファイルベースのルート。各ルートは、`app/pages/` のページの薄いラッパーです。
+- **`app/pages/adhoc/sql-dashboard/`** — SQL ダッシュボード レンダラー、パネル エディター、フィルター バー、保存されたビュー。
+- **`app/pages/analyses/`** — リストと詳細ビューを分析します。
+- **`app/pages/DataSources.tsx`** — UI をオンボーディングするデータソース。
+- **`app/pages/DataDictionary.tsx`** — 辞書ブラウザおよびエディタ。
+- **`.agents/skills/`** — エージェントがオンデマンドで読み取るパターン ガイド:
+  - `dashboard-management` — ストレージ、スコープ解像度、ダッシュボード構成形状
+  - `data-querying` — どのスクリプトに到達するか、フィルタリング パターン
+  - `adhoc-analysis` — ソース間調査のワークフロー
+  - `data-querying`, `real-time-sync`, `frontend-design`, `storing-data`, `self-modifying-code`
+- **`.builder/skills/<provider>/SKILL.md`** — プロバイダー固有の注意事項 (BigQuery、HubSpot、Jira、GA4 など)。問い合わせる前にお読みください。新しいことを学んだら更新してください。
+- **`server/db/schema.ts`** — ダッシュボード、共有、ビュー、分析、BigQuery キャッシュの Drizzle スキーマ。
+- **`server/lib/dashboards-store.ts`** — スコープ解決と従来の KV 移行によるダッシュボードの読み取り/書き込み。
+- **`server/lib/bigquery.ts`** — BigQuery クライアント、ドライラン バリデータ、キャッシュ ロジック。
+
+新しいデータ ソースを追加するには、プロバイダーを呼び出し、`output()` ヘルパー経由で結果を返すスクリプトを `actions/` にドロップします。エージェントはすぐに利用できるようになり、ダッシュボード パネル内で使用できます (サーバー ハンドラー経由で結果を公開する場合)。
+
+新しいグラフ タイプを追加するには、`app/pages/adhoc/sql-dashboard/types.ts` で `ChartType` ユニオンを拡張し、それを `SqlChartCard.tsx` で処理します。これにより、エージェントは任意のパネルでそれを使用できるようになります。
+
+テンプレートの拡張に関する広範なパターンについては、[Skills guide](/docs/skills-guide) および [Actions](/docs/actions) を参照してください。

package/corpus/core/docs/content/locales/ja-JP/template-assets.md

@@ -0,0 +1,303 @@
+---
+title: "資産"
+description: "エージェントネイティブのデジタル アセット マネージャーと、ブランド一貫性のあるメディア向けのクロスエージェント生成サービス。"
+---
+
+# 資産
+
+Assets は、ブランドと一貫したメディアを作成および管理するためのエージェントネイティブのワークスペースです。アップロードと生成された結果をライブラリとフォルダーに整理し、チームがブログのヒーロー、図、ランディング ページ、製品ショット、ビデオ、ロゴの例を収集し、エージェント チャットを通じて生成をルーティングできるため、すべてのアセットをレビューして調整できます。
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Launch brand</h1><span class='wf-pill accent'>Blog heroes</span><span class='wf-pill'>Product shots</span><span class='wf-pill'>Logos</span><div style='flex:1'></div><button>Upload</button><button class='primary'>Generate</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Create brand media</strong><div class='wf-box'>Three homepage hero options using the approved logo and product references.</div><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>4 references</span><span class='wf-pill'>16:9</span><span class='wf-pill'>Web export</span></div></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px;flex:1'><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill accent'>Hero A</span></div><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill'>Reference set</span></div><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill'>Logo safe</span></div></div><div class='wf-card' style='display:grid;grid-template-columns:repeat(4,1fr);gap:8px'><div class='wf-box'>Use</div><div class='wf-box'>Refine</div><div class='wf-box'>Compare</div><div class='wf-box'>Export</div></div></div>"
+}
+```
+
+アプリを開くと、選択したライブラリ、プロンプト、参照、生成された候補が 1 つのワークスペースに残ります。エージェントは、UI が使用するのと同じ actions を通じて、すべてのアセットを参照、検索、生成、調整、エクスポートできます。
+
+```an-diagram title="Generate, review, reuse" summary="References and prompts feed a generate-and-choose session; chosen assets land in a library and flow out to other apps via the picker or A2A."
+{
+  "html": "<div class=\"diagram-assets\"><div class=\"diagram-col\"><div class=\"diagram-node\">References<br><small class=\"diagram-muted\">logos, product shots, style</small></div><div class=\"diagram-node\">Prompt<br><small class=\"diagram-muted\">chat or Generate controls</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Generation session</span><small class=\"diagram-muted\">image &amp; video candidates · audit log</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Library</span><small class=\"diagram-muted\">chosen, brand-consistent assets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">Picker<br><small class=\"diagram-muted\">iframe / MCP App</small></div><div class=\"diagram-node\">A2A<br><small class=\"diagram-muted\">Slides · Design · Content</small></div></div></div>",
+  "css": ".diagram-assets{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-assets .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-assets .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-assets .diagram-arrow{font-size:20px;line-height:1}"
+}
+```
+
+## いつ選択するか
+
+- **チームには、1 回限りの一般的なメディア プロンプトではなく、再利用可能なビジュアル ディレクションが必要です**。承認されたロゴ、製品ショット、スタイル例を収集して、何世代にもわたってブランドを維持できるようにします。
+- **実行ごとのプロンプト、モデル、参照、リネージの完全な監査ログを使用して、生成されたメディアをレビューして調整したいと考えています**。
+- **他のアプリにはアセット ピッカーまたはジェネレーターが必要です** — スライド、デザイン、コンテンツ、ブログ エディター、またはサイト ビルダーは、ピッカーを埋め込んだり、A2A 経由でアセットを呼び出したりできます。
+- **コーディング エージェントからブランド メディアを利用できるようにしたい** — Codex、Claude コード、Claude、または ChatGPT は、チャットを離れることなくアセットを生成して選択できます。
+
+## はじめに
+
+ライブデモ: [assets.agent-native.com](https://assets.agent-native.com)。
+
+1. **ライブラリを作成します。** ブランド、キャンペーン、製品、またはコンテンツ ストリームを追加します
+   管理したい
+2. **参照をアップロードします。** 承認されたロゴ、製品の写真、スタイルの例を追加します。
+   既存のビデオにより、エージェントは具体的な資料を基に作業を行うことができます。
+3. **チャットまたはライブラリから生成します。** ヒーロー画像、図、製品を要求します
+   ショット、またはビデオのバリアント。アセットには、プロンプト、参照、モデル、ステータスが保存されます。
+   レビュー用のリネージュ。
+4. **アセットを別の場所で使用します。** エクスポートをコピーし、ピッカーを別の場所に埋め込みます
+   アプリを使用するか、別のエージェントが A2A 経由でアセットを呼び出すようにします。
+
+## 便利なプロンプト
+
+- 「Acme 製品リファレンスを使用して 3 つのブログ ヒーロー オプションを生成します。」
+- 「ローンチ キャンペーン スタイルで正方形のソーシャル イメージを作成します。」
+- 「オンボーディングの再設計のために承認されたアセットをすべて検索します。」
+- 「このアップロードした図をよりわかりやすい製品説明画像に変換します。」
+- 「ビデオ ストーリーボードを作成し、最適なフレーム セットをこのライブラリに保存します。」
+
+## それを使って何ができるか
+
+- **アセット ライブラリを作成します。** 参照画像、ビデオ、標準ロゴ、スタイル ノート、パレット、フォルダー、および生成された出力をブランド、キャンペーン、製品、またはカテゴリごとにグループ化します。
+- **チャットを通じて生成します。** ホーム コンポーザーとライブラリの生成コントロールは、`sendToAgentChat()` を使用してエージェントにプロンプトを送信するため、ユーザーはバリアントを検査し、フィードバックを提供し、反復することができます。
+- **画像とビデオを生成します。** 有効にすると、Builder 管理の画像生成が利用可能になり、Gemini はビデオ生成と手動画像フォールバックを強化します。
+- **参照をアップロードして説明します。** ライブラリ UI またはプロンプトのコンポーザー添付ボタンから画像やビデオを追加し、タイトル、説明、代替テキスト、プロンプト、モデル、メディア タイプ、ステータス、役割、フォルダー、またはコレクションで検索します。
+- **生成監査ログを保存します。** 実行するたびに、プロンプト、モデル、アスペクト比、参照、ソース アセット、系統、生成されたアセット、ステータス、エラー、タイムスタンプが記録され、後で設計をレビューできるようになります。
+- **ロゴの精度を維持します。** エージェントはプレースホルダー領域を生成でき、サーバーは画像モデルに依存して再描画するのではなく、アップロードされた標準ロゴを最終画像に合成します。
+- **ピッカーとして埋め込みます。** 他のアプリは `/picker` を iframe し、`@agent-native/embedding` からの `chooseAsset` イベントをリッスンして、アセットをブログエディター、サイト ビルダー、スライド デッキ、カスタム アプリ用のアセット ピッカー/ジェネレーターに変えることができます。ピッカーは、既存のイメージ専用ホストのレガシー `chooseImage` エイリアスも生成します。
+- **アプリベースのスキルとしてインストールします。** `agent-native.app-skill.json` マニフェストはアセット スキルと MCP コネクタ メタデータをエクスポートするため、マーケットプレイスはアプリ、その手順、ピッカーを一緒にインストールできます。
+- **他のエージェントにサービスを提供します。** スライド、デザイン、コンテンツ、メール、ディスパッチは、A2A を介してアセットを呼び出し、ライブラリの一覧表示、バッチの生成、ビデオの作成、アセットの調整、エクスポートの取得、埋め込みが許可されているインライン プレビューのレンダリングを行うことができます。
+
+## コーディング エージェントからの使用
+
+Codex、Claude コード、Claude、または ChatGPT から離れることなく、ブランド メディアを生成して選択します。
+
+1. **一度インストールします。** これにより、スキルの手順が追加され、ホストされている MCP コネクタが一緒に登録されます。
+
+   ```bash
+   npx @agent-native/core@latest skills アセットを追加 # エイリアス: image-世代
+   ```
+
+   デフォルトのクライアントは `codex` です。その他の場合は、`--client claude-code` または `--client all` を追加してください。
+   Vercel/open を通じてポータブル スキルの説明のみが必要な場合
+   Skills CLI、使用:
+
+   ```bash
+   npx skills@最新の追加 BuilderIO/agent-native --skill アセット
+   ```
+
+   Vercel/open Skills CLI は命令ファイルのみをインストールします。そうではありません
+   MCP コネクタのセットアップを実行します。必要な場合は、上記の Agent Native CLI パスを使用してください。
+   コマンド 1 つでセットアップできます。
+
+2. **画像を要求します。** エージェントのチャット: 「Acme 製品のショットから 3 つのブログ ヒーロー オプションを生成します。」エージェントはピッカーを開き、再生成、再調整 (プロンプト、アスペクト、カウント) して選択できる候補画像を表示します。
+3. **Pick.** インライン ホスト (ChatGPT、Claude.ai、Claude デスクトップ メイン チャット) では、ピッカーがチャット内で直接表示されます。候補をクリックすると、選択肢が自動的に表示されます。 CLI/リンク専用ホスト (Codex、Claude コード、Claude デスクトップの「コード」タブ) では、**「アセットで開く →」** リンクが表示されます。それを開いて、ブラウザで選択し、コピーした引き継ぎ概要をチャットに貼り付けます。または、単に「画像 A を使用する」と言うだけです。
+
+   ```テキスト
+   この選択内容をチャットに貼り付けて、エージェントが使用できるようにします。
+
+   次のステップで選択したアセットの画像: <label>
+   メディア URL: <url>
+   この選択したアセットを現在のアーティファクトまたはデザインで使用します。
+
+   選択されたアセット コンテキスト:
+   { "selectedAsset": { "assetId": "...", "url": "...", "mediaType": "image", ... } }
+   ```
+
+4. **コードに適用します。** 選択したメディア URL および `assetId` がエージェントに返され、エージェントは作成するコード (`<img>` src、ダウンロード) で URL を直接使用するか、`export-asset` を呼び出します。
+
+## 開発者向け
+
+このドキュメントの残りの部分は、アセット テンプレートをフォークまたは拡張する人を対象としています。
+
+### 足場
+
+```bash
+npx @agent-native/core@latest create my-assets --standalone --template assets
+```
+
+### データモデル
+
+すべてのデータは、Drizzle ORM を介して SQL に存在します (バイナリ メディアはオブジェクト ストレージ、または開発中のローカル ファイル アップロード フォールバックに存在します)。スキーマ: `templates/assets/server/db/schema.ts`。ライブラリは標準の `ownableColumns` と一致するフレームワーク共有テーブルを保持しているため、ユーザーごと/組織ごとの共有モデルに組み込まれます。
+
+注: SQL テーブル名には、アプリが Images と呼ばれていたときのレガシー `image_*` プレフィックスが保持されています。動画やその他のメディアも取り上げています。
+
+| テーブル                         | 内容                                                                                                                                                                                                       |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `image_libraries`                | ライブラリ — ブランド、キャンペーン、製品、またはカテゴリーごとにグループ化された最上位のコンテナー。 `custom_instructions`、`style_brief`、正規ロゴとカバーアセット参照、およびアーカイブ状態を保持します |
+| `image_library_shares`           | フレームワークは、ライブラリごとにプリンシパル (ユーザーまたは組織) をロール (閲覧者、編集者、管理者) にマッピングするテーブルを共有します                                                                 |
+| `image_collections`              | ライブラリ内のスタイル/カテゴリのグループ化 — `style_brief`、`prompt_template`、デフォルトのアスペクト比と画像サイズ                                                                                       |
+| `asset_folders`                  | ライブラリ内のネスト可能なフォルダー (階層の場合は `parent_id`)                                                                                                                                            |
+| `image_generation_presets`       | 保存された生成レシピ — メディア タイプ、プロンプト テンプレート、アスペクト比、モデル、テキスト/参照ポリシー                                                                                               |
+| `image_generation_sessions`      | 概要、ステータス、アクティブなアセット、フィードバックの概要を含む反復的な生成と選択セッション                                                                                                             |
+| `image_generation_session_items` | セッション内の候補アセット。それぞれに役割とメモが付いています。                                                                                                                                           |
+| `image_assets`                   | アセット レコード — メディア タイプ、役割、ステータス、タイトル/説明/代替テキスト、プロンプト、モデル、寸法、MIME タイプ、オブジェクト/サムネイル キー、系統                                               |
+| `image_generation_runs`          | 生成監査ログ — プロンプト、コンパイルされたプロンプト、モデル、参照、ステータス、エラー、およびそれをトリガーした `source` (`chat` / `ui` / `a2a`)                                                         |
+
+```an-schema title="Assets data model" summary="Libraries are the ownable container; collections, folders, and presets organize them. Sessions drive generate-and-choose; assets and runs hold output and the audit log. Table names keep the legacy image_* prefix but cover all media."
+{
+  "entities": [
+    { "id": "library", "name": "image_libraries", "note": "Top-level ownable container", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "custom_instructions", "type": "text", "nullable": true },
+      { "name": "style_brief", "type": "text", "nullable": true },
+      { "name": "logo_asset_id", "type": "id", "fk": "image_assets.id", "nullable": true },
+      { "name": "archived", "type": "boolean" }
+    ] },
+    { "id": "library_shares", "name": "image_library_shares", "note": "Framework shares table", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] },
+    { "id": "collections", "name": "image_collections", "note": "Style/category groupings", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "style_brief", "type": "text", "nullable": true },
+      { "name": "prompt_template", "type": "text", "nullable": true }
+    ] },
+    { "id": "folders", "name": "asset_folders", "note": "Nestable folders", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "parent_id", "type": "id", "fk": "asset_folders.id", "nullable": true }
+    ] },
+    { "id": "presets", "name": "image_generation_presets", "note": "Saved generation recipes", "fields": [
+      { "name": "media_type", "type": "text" },
+      { "name": "prompt_template", "type": "text" },
+      { "name": "model", "type": "text" }
+    ] },
+    { "id": "sessions", "name": "image_generation_sessions", "note": "Iterative generate-and-choose", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "status", "type": "text" },
+      { "name": "active_asset_id", "type": "id", "fk": "image_assets.id", "nullable": true }
+    ] },
+    { "id": "session_items", "name": "image_generation_session_items", "note": "Candidate assets in a session", "fields": [
+      { "name": "session_id", "type": "id", "fk": "image_generation_sessions.id" },
+      { "name": "asset_id", "type": "id", "fk": "image_assets.id" },
+      { "name": "role", "type": "text" }
+    ] },
+    { "id": "assets", "name": "image_assets", "note": "The asset record", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "media_type", "type": "text", "note": "image / video" },
+      { "name": "status", "type": "text" },
+      { "name": "prompt", "type": "text", "nullable": true },
+      { "name": "object_key", "type": "text", "nullable": true }
+    ] },
+    { "id": "runs", "name": "image_generation_runs", "note": "Generation audit log", "fields": [
+      { "name": "model", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "source", "type": "text", "note": "chat / ui / a2a" }
+    ] }
+  ],
+  "relations": [
+    { "from": "library", "to": "collections", "kind": "1-n" },
+    { "from": "library", "to": "folders", "kind": "1-n" },
+    { "from": "library", "to": "assets", "kind": "1-n" },
+    { "from": "sessions", "to": "session_items", "kind": "1-n" },
+    { "from": "library", "to": "library_shares", "kind": "1-n" }
+  ]
+}
+```
+
+### カスタマイズ
+
+Assets は、完全なクローン作成可能なテンプレートです。いくつかの実践的な拡張アイデア:
+
+- 「SKU で製品参照ショットを選択できるように、製品カタログ コネクタを追加します。」
+- 「生成されたアセットがマーケティングに使用可能とマークされる前に、厳格な承認キューを追加します。」
+- 「失敗した世代や評価の低い世代をモデルごとにフィルタリングするブランド レビュー ダッシュボードを追加します。」
+- 「ワークスペース全体のデフォルトのアセット ライブラリを作成し、それを通じてスライド画像の生成をルーティングします。」
+- 「最新のプロバイダーのドキュメントを確認した後、イメージ生成インターフェイスの背後に新しいプロバイダーを追加します。」
+
+エージェントは、必要に応じて、ルート、コンポーネント、actions、skills、および SQL をサポートするモデルを編集します。完全なクローン、カスタマイズ、デプロイのフローについては [Templates](/docs/cloneable-saas) を、アプリ間の生成については [A2A Protocol](/docs/a2a-protocol) を参照してください。
+
+### ピッカーを埋め込む
+
+人間が内部のアセットを選択または生成する場合は、ピッカー ルートを使用します
+another product. Image is the default media type; pass `mediaType=video` when
+ビデオの閲覧/選択を希望します:
+
+```tsx
+import { EmbeddedApp } from "@agent-native/embedding";
+
+<EmbeddedApp
+  url="https://assets.agent-native.com/picker?mediaType=image"
+  onMessage={(name, payload) => {
+    if (name === "chooseAsset") {
+      insertAsset((payload as { url: string }).url);
+    }
+  }}
+/>;
+```
+
+外部 MCP ホストは、これを構築する代わりに `open-asset-picker` を呼び出す必要があります
+iframe を手動で作成します。このアクションは、ブラウザーのフォールバック リンクと MCP アプリのメタデータを返します
+インライン ホストの場合。ユーザーがアセットを選択すると、ピッカーは `chooseAsset` を出力します。
+画像アセットの従来の `chooseImage` エイリアス、および MCP アプリ モデルの更新
+ホストがサポートするコンテキスト。ホストが
+MCP アプリをインラインでレンダリングする代わりに、通常のブラウザ タブでアセットを選択します
+ハンドオフ概要をコピーし、コピー可能なコンテキスト ブロックを表示します。その概要を貼り付けてください
+チャットに戻ると、外部エージェントが選択したメディア URL を使用できるようになります。
+アセットのメタデータ。
+
+Codex、Claude コード、および Claude デスクトップ コードはリンクアウト ホストとして扱う必要があります
+。 MCP アプリをインラインでレンダリングしたり、リモート CDN マークダウンをレンダリングしたりすることはできません
+画像はチャット記録に確実に表示されない可能性があります。エージェントは
+信頼できる情報源としてのアセット リンク。
+コード エディター チャット、選択した `previewUrl`/`downloadUrl` をローカルにダウンロードします
+イメージ ファイルを作成し、その絶対ローカル パスを埋め込みます。
+
+フローの生成と選択の場合は、`prompt` を使用して `open-asset-picker` を呼び出します。
+`autoGenerate: true`、および `count: 3` (1 ～ 6 までカスタマイズ可能)。ピッカーが開きます
+候補画像を使用して、ユーザーが数、アスペクト比、またはサイズを調整できるようにします
+最終アセット URL を選択する前に生成プリセットを実行します。
+
+別のエージェントがアセットを作成、検索、またはエクスポートする必要がある場合は、A2A を使用します
+人間ピッカー UI。
+
+### 開発者: アプリ スキルを配布します
+
+アセット アプリ スキルのアプリ ID は `assets` で、ホストされているのは MCP URL です
+`https://assets.agent-native.com/_agent-native/mcp`.
+
+```bash
+# Easiest hosted install: exported skill instructions plus MCP connector.
+npx @agent-native/core@latest skills add assets
+
+# Vercel/open Skills CLI install: exported instructions only, no MCP config.
+npx skills@latest add BuilderIO/agent-native --skill assets
+
+# Hosted install: URL-only MCP connector, no shared secrets in skill files.
+npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json
+
+# Local editable launch.
+npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent-native.app-skill.json --local --into ./assets-local
+
+# Marketplace package, including Claude Code marketplace and Vercel Labs skills adapters.
+npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
+
+# Install a local exported Assets bundle with the open skills CLI.
+npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
+
+# Install from the generated Claude Code marketplace adapter.
+claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
+claude plugin install agent-native-assets@agent-native-apps
+```
+
+エクスポートされたスキルは、人間参加型のピッカーの使用をエージェントに教えます
+選択、無人画像/ビデオ生成用の直接 actions、およびブラウザ
+インライン MCP アプリが利用できない場合のリンク。
+
+Claude マーケットプレイス アダプターには `.claude-plugin/marketplace.json` が含まれています
+カタログと `skills/assets/SKILL.md` プラスを備えた `agent-native-assets` プラグイン
+ホストされている `.mcp.json`。インタラクティブな Claude コードでも、同じフローが利用可能です
+`/plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace` として
+`/plugin install agent-native-assets@agent-native-apps`、`/reload-plugins`、および
+MCP 認証の場合は `/mcp`。
+
+`npx skills@latest` を使用して生のマーケットプレイス バンドルからインストールする場合は、
+ホストされた MCP コネクタにより、これらの命令でライブ アセット アプリを呼び出すことができます。
+
+```bash
+npx @agent-native/core@latest app-skill ensure --manifest ./dist/assets-skill/agent-native.app-skill.json --yes
+```
+
+## 次は何ですか
+
+- [**Templates**](/docs/cloneable-saas) — クローンして独自のモデル
+- [**Embedding SDK**](/docs/embedding-sdk) — iframe ピッカーとサイドカー パターン
+- [**A2A Protocol**](/docs/a2a-protocol) — 他のアプリがアセットを呼び出す方法
+- [**File Uploads**](/docs/file-uploads) — ストレージと認証されたアセットの提供
+- [**Sharing & Privacy**](/docs/sharing) — ライブラリレベルのアクセス制御