Hugging Face's logo

Spaces:
DLPO
/
level_bridge_chat
Sleeping

App Files Community
level_bridge_chat
File size: 3,821 Bytes
f636c5d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
---

title: Level Bridge Chat
emoji: 💬
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
---


# Level Bridge Chat

ダッシュボードに埋め込めるチャット型広告改善提案システム。

情報量（level1〜3）に応じた2種類の返答を自動生成します:
- **現在の提案**: 今ある情報で出せる最善提案
- **次レベル予告**: 追加情報で何が可能になるかの予告

## Embedding

```html

<!-- 基本埋め込み -->

<iframe

  src="https://your-space.hf.space?campaign_name=サマーセール&industry=EC&cvr=2.1"

  width="420"

  height="680"

  style="border:none; border-radius:12px;">

</iframe>

```

### URLパラメータ（初期化）

| パラメータ | 型 | 説明 | 例 |
|---|---|---|---|
| `campaign_name` | string | キャンペーン名 | `サマーセール` |
| `industry` | string | 業界 | `EC` |
| `cvr` | number | CVR (%) | `2.1` |
| `ctr` | number | CTR (%) | `0.8` |
| `cpa` | number | CPA (円) | `3500` |

## API Endpoint

```

POST /api/chat/bridge

Content-Type: application/json



{

  "session_id": null,

  "message": "",

  "dashboard_context": {

    "campaign_name": "サマーセール",

    "industry": "EC",

    "metrics": { "cvr": 2.1, "ctr": 0.8, "cpa": null },

    "image_base64": null

  }

}

```

### Response

```json

{

  "ok": true,

  "session_id": "uuid",

  "turn_number": 1,

  "inferred_level": "level2",

  "level_confidence": "high",

  "level_reason": "at least one metric present",

  "best_now": {

    "summary": "...",

    "actions": ["..."],

    "confidence": "mid",

    "reasoning_basis": ["cvr", "campaign_name"]

  },

  "next_level_preview": {

    "current_level": "level2",

    "next_level": "level3",

    "needed_info": [{"key": "image_base64", "label": "クリエイティブ画像", "example": "バナー画像"}],

    "what_will_be_possible": ["クリエイティブ要素の具体的改善提案"],

    "expected_impact": "..."

  },

  "follow_up_question": "..."

}

```

## Level Rules

| Level | 条件 | 今できること |
|---|---|---|
| level1 | campaign_name or industry のみ | 業界仮説ベースの提案 |

| level2 | CVR/CTR/CPA のいずれかあり | ファネル診断・優先度付き打ち手 |

| level3 | image_base64 あり | クリエイティブ視覚要素の改善提案 |

Level は会話内で上方向にのみ更新されます（情報は蓄積され続けます）。

## Environment Variables

| 変数 | デフォルト | 説明 |
|---|---|---|
| `MOCK_MODE` | `true` | `true` の間はモック応答を返す |
| `SESSION_TTL_SEC` | `1800` | セッション有効期間（秒） |
| `MAX_SESSIONS` | `1000` | 最大同時セッション数 |
| `MAX_IMAGE_SIZE_MB` | `5` | 画像の最大サイズ（MB） |
| `PORT` | `7860` | サーバーポート |

## Real Implementation

`mock_responses.py` の以下の関数を実装してください:

```python

def level1_propose(ctx: AccumulatedContext, history: list) -> BestNow:

    # Level 1 の実際のロジック（LLM呼び出しなど）

    ...



def level2_propose(ctx: AccumulatedContext, history: list) -> BestNow:

    # Level 2 の実際のロジック

    ...



def level3_propose(ctx: AccumulatedContext, history: list) -> BestNow:

    # Level 3 の実際のロジック（画像base64を ctx.image_base64 で参照）

    ...

```

実装後、`MOCK_MODE=false` に設定します。

## MCP Readiness

将来 MCP ツールとして公開する場合、`bridge_service.process_request()` を薄くラップするだけで対応できます。
Pydantic モデルがそのまま JSON Schema になります。

## Health Check

```

GET /healthz

→ {"ok": true, "sessions": 42}

```