はじめに
前編ではOracle Autonomous AI Database(ADB)に売上テーブルとSelect AI Agentを用意し、PostmanからA2A APIで質問して回答を取得しました。
後編では同じAPIをStreamlitにつなぎ、質問を入力すると回答まで表示されるチャット画面を作ります。「2026年10月の売上が2番目に高い担当者」を聞いた後に「1位は?」と続けて質問できるようにします。
1. 構成と前提
前編で作成した環境を使います。接続先とオブジェクトは次のとおりです。
| 項目 | 設定値 |
|---|---|
| ADBのリージョン | 大阪 ap-osaka-1
|
| API認証に使うDBユーザー | ADMIN |
| 売上テーブル | APP_DATA.SALES |
| AIプロファイル | SALES_AI |
| チーム | SALES_TEAM |
Postmanで前編の message/send と tasks/get を実行し、Bobの1,050,000円が返るところまで確認しておきます。
Streamlitがトークンの取得、質問の送信、タスクの完了待ち、回答の表示を担当します。売上データの検索と集計、回答の生成はADB側のSelect AI Agentが行います。
2. Windowsで実行環境を用意する
Windows 11にPython 3.11以降がインストールされている前提で進めます。StreamlitとHTTP通信用のRequestsを使います。
コマンドプロンプトで次を実行します。
python --version
mkdir "%USERPROFILE%\streamlit_adb"
cd /d "%USERPROFILE%\streamlit_adb"
python -m venv .venv
.venv\Scripts\activate.bat
python -m pip install streamlit requests
mkdir .streamlit
実行すると作業フォルダーが%USERPROFILE%\streamlit_adbとして作成されます。
ファイルとフォルダーの構成
streamlit_adb/
├─ app.py ← チャットアプリのPythonコード
├─ .streamlit/
│ └─ secrets.toml ← ADBの接続設定
└─ .venv/ ← Pythonの仮想環境
streamlit_adb フォルダーに app.py、その中の .streamlit フォルダーに secrets.toml を作成します。どちらもUTF-8で保存します。Windowsで作成する際は拡張子も表示し、ファイル名をそれぞれ app.py と secrets.toml にします。 Streamlitのインストール手順
3. ADBの接続情報を設定する
.streamlit/secrets.toml に次を保存します。<ADB_OCID> と <ADB_ADMIN_PASSWORD> を前編で使った値に置き換えます。
[adb]
region = "ap-osaka-1"
adb_ocid = "<ADB_OCID>"
username = "ADMIN"
password = "<ADB_ADMIN_PASSWORD>"
team_name = "SALES_TEAM"
poll_interval_seconds = 2
poll_timeout_seconds = 300
設定例では2秒間隔で実行状態を確認し、1回の回答待ちの目安を300秒にしています。
secrets.toml はStreamlitの st.secrets から読み込みます。実際のパスワードを設定したファイルはPC内で管理します。Gitでソースを管理する場合は .streamlit/secrets.toml を .gitignore に追加します。 StreamlitのSecrets管理 / ADBのBearerトークン取得
4. チャットアプリを作る
app.py に次のコードを保存します。
message/send の応答が submitted または working なら、同じtaskIdで tasks/get を繰り返します。completed になったら artifacts のテキストを取り出します。HTTP 200のレスポンス本文にJSON-RPCの error がある場合も画面に表示します。
Bearerトークンはセッション内で再利用し、HTTP 401が返った場合は取得し直して1回再送します。回答待ちが時間切れになった場合もtaskIdを保持し、画面の「回答の取得を続ける」で同じ質問の結果を確認できます。
コード内で region、adb_ocid、team_name を組み合わせ、前編と同じ2つの下記URLが生成されます。
| 用途 | URL |
|---|---|
| トークン取得 | https://dataaccess.adb.<region>.oraclecloudapps.com/adb/auth/v1/databases/<ADB_OCID>/token |
| 質問の送信と回答の取得 | https://dataaccess.adb.<region>.oraclecloudapps.com/adb/a2a/v1/databases/<ADB_OCID>/agents/SALES_TEAM |
import time
from uuid import uuid4
import requests
import streamlit as st
st.set_page_config(page_title="営業売上チャット")
st.title("営業売上チャット")
try:
cfg = st.secrets["adb"]
region = cfg["region"]
adb_ocid = cfg["adb_ocid"]
username = cfg["username"]
password = cfg["password"]
team_name = cfg["team_name"]
poll_interval = float(cfg.get("poll_interval_seconds", 2))
poll_timeout = float(cfg.get("poll_timeout_seconds", 300))
if not 0 < poll_interval < poll_timeout:
raise ValueError("Invalid polling settings")
except (st.errors.StreamlitSecretNotFoundError, KeyError, TypeError, ValueError):
st.error(".streamlit/secrets.toml の [adb] 設定を確認してください。")
st.stop()
base_url = f"https://dataaccess.adb.{region}.oraclecloudapps.com/adb"
token_url = f"{base_url}/auth/v1/databases/{adb_ocid}/token"
a2a_url = f"{base_url}/a2a/v1/databases/{adb_ocid}/agents/{team_name}"
st.session_state.setdefault("history", [])
st.session_state.setdefault("context_id", None)
st.session_state.setdefault("pending_task", None)
def post_json(url, payload, *, token=None, timeout=30):
headers = {"Accept": "application/json"}
if token:
headers["Authorization"] = f"Bearer {token}"
response = requests.post(
url,
json=payload,
headers=headers,
timeout=timeout,
allow_redirects=False,
)
response.raise_for_status()
if response.is_redirect:
raise RuntimeError("APIの接続先URLを確認してください。")
try:
data = response.json()
except requests.exceptions.JSONDecodeError as exc:
raise RuntimeError("APIから有効なJSONを受け取れませんでした。") from exc
if not isinstance(data, dict):
raise RuntimeError("APIの応答形式を確認してください。")
return data
def get_token():
token = st.session_state.get("access_token")
if not token:
data = post_json(
token_url,
{
"grant_type": "password",
"username": username,
"password": password,
},
)
token = data.get("access_token")
if not token:
raise RuntimeError("トークン取得の応答に access_token がありません。")
st.session_state["access_token"] = token
return token
def rpc(method, params, *, timeout=30):
payload = {
"jsonrpc": "2.0",
"id": str(uuid4()),
"method": method,
"params": params,
}
for attempt in range(2):
token = get_token()
try:
reply = post_json(a2a_url, payload, token=token, timeout=timeout)
break
except requests.HTTPError as exc:
if exc.response.status_code != 401:
raise
st.session_state.pop("access_token", None)
if attempt == 1:
raise
if "error" in reply:
error = reply["error"]
raise RuntimeError(
f"A2Aエラー {error.get('code')}:{error.get('message')}"
)
result = reply.get("result")
if not isinstance(result, dict):
raise RuntimeError("A2Aの応答に result がありません。")
return result
def text_parts(parts):
return [
part["text"]
for part in parts
if part.get("kind") == "text" and part.get("text")
]
def send_question(question):
message = {
"kind": "message",
"role": "user",
"messageId": str(uuid4()),
"parts": [{"kind": "text", "text": question}],
}
if st.session_state["context_id"]:
message["contextId"] = st.session_state["context_id"]
task = rpc(
"message/send",
{
"configuration": {"acceptedOutputModes": ["text/plain"]},
"message": message,
},
)
if not task.get("id"):
raise RuntimeError("質問の送信結果にtaskIdがありません。")
st.session_state["pending_task"] = task
if task.get("contextId"):
st.session_state["context_id"] = task["contextId"]
def wait_for_answer():
task = st.session_state["pending_task"]
task_id = task["id"]
deadline = time.monotonic() + poll_timeout
while True:
status = task.get("status") or {}
state = status.get("state")
if task.get("contextId"):
st.session_state["context_id"] = task["contextId"]
if state == "completed":
st.session_state["pending_task"] = None
texts = []
for artifact in task.get("artifacts") or []:
texts.extend(text_parts(artifact.get("parts") or []))
if not texts:
message = status.get("message") or {}
texts = text_parts(message.get("parts") or [])
if not texts:
raise RuntimeError("タスクは完了しましたが回答テキストがありません。")
return "\n\n".join(texts)
if state not in {"submitted", "working"}:
st.session_state["pending_task"] = None
message = status.get("message") or {}
detail = "\n".join(text_parts(message.get("parts") or []))
raise RuntimeError(f"タスクの状態は {state} です。\n{detail}")
time.sleep(min(poll_interval, max(0, deadline - time.monotonic())))
remaining = deadline - time.monotonic()
if remaining <= 0:
raise TimeoutError(
"回答待ちが時間切れになりました。"
"「回答の取得を続ける」で同じタスクを確認できます。"
)
task = rpc(
"tasks/get",
{"id": task_id},
timeout=min(30, remaining),
)
st.session_state["pending_task"] = task
if st.sidebar.button("新しい会話を開始"):
st.session_state["history"] = []
st.session_state["context_id"] = None
st.session_state["pending_task"] = None
st.session_state.pop("notice", None)
st.rerun()
for item in st.session_state["history"]:
with st.chat_message(item["role"]):
st.markdown(item["text"])
notice = st.session_state.pop("notice", None)
if notice:
st.warning(notice)
resume = False
if st.session_state["pending_task"]:
resume = st.button("回答の取得を続ける")
question = st.chat_input(
"例:2026年10月の売上合計が2番目に高い担当者は?",
disabled=st.session_state["pending_task"] is not None,
)
if question or resume:
if question:
st.session_state["history"].append({"role": "user", "text": question})
with st.chat_message("user"):
st.markdown(question)
try:
with st.spinner("売上データを確認しています…"):
if question:
send_question(question)
answer = wait_for_answer()
except requests.HTTPError as exc:
st.session_state["notice"] = (
f"API通信エラー(HTTP {exc.response.status_code})"
)
except requests.RequestException:
st.session_state["notice"] = (
"APIとの通信に失敗しました。接続先とネットワークを確認してください。"
)
except (RuntimeError, TimeoutError) as exc:
st.session_state["notice"] = str(exc)
else:
st.session_state["history"].append(
{"role": "assistant", "text": answer}
)
st.rerun()
5. 起動して会話を確認する
コマンドプロンプトで次を実行します。
cd /d "%USERPROFILE%\streamlit_adb"
.venv\Scripts\activate.bat
python -m streamlit run app.py --server.address 127.0.0.1
ブラウザーで http://127.0.0.1:8501 を開きます。
チャット画面
最初に前編と同じ要領で連続した質問をします。
前編のサンプルデータで期待する結果は次のとおりです。
| 順番 | 入力する質問 | 期待する結果 |
|---|---|---|
| 最初の質問 | 2026年10月の売上合計が2番目に高い営業担当者と金額を教えて | Bob / 1,050,000円 |
| 続きの質問 | 1位は? | Alex / 1,250,000円 |
| さらに続ける | 9月の売上で見た場合は? | Cris / 2,000,000円 |
回答の文章は生成結果によって変わります。担当者名、金額、対象期間が合っていることを確認します。
登録したデータ
INTO APP_DATA.SALES VALUES (1, DATE '2026-10-03', 'Alex', 800000)
INTO APP_DATA.SALES VALUES (2, DATE '2026-10-19', 'Alex', 450000)
INTO APP_DATA.SALES VALUES (3, DATE '2026-10-08', 'Bob', 700000)
INTO APP_DATA.SALES VALUES (4, DATE '2026-10-22', 'Bob', 350000)
INTO APP_DATA.SALES VALUES (5, DATE '2026-10-10', 'Cris', 950000)
INTO APP_DATA.SALES VALUES (6, DATE '2026-10-25', 'Cris', 50000)
INTO APP_DATA.SALES VALUES (7, DATE '2026-09-29', 'Cris', 2000000)
集計したデータ
9月 Cris 200万
10月 Alex 125万 / Bob 105万 / Cris 100万
上記のチャットのやり取りで、前の質問の文脈を引き継いでいるかを確認できます。
終了するときはコマンドプロンプトで Ctrl+C を押します。secrets.toml を変更したときも終了し、同じ起動コマンドで再起動します。
実行結果例①
実行結果例②
実行結果例③
6. 続けて質問できる仕組み
前編の message/send のレスポンスには、taskIdと contextId が含まれていました。アプリでは次のように使い分けます。
| ID | 用途 | 扱い |
|---|---|---|
messageId |
送信するメッセージを識別する | 質問ごとにPythonの uuid4() で生成する |
taskId result.id
|
その質問の実行状態を確認する |
tasks/get の params.id に指定する |
contextId |
同じ会話に属する質問を結び付ける | 次の message/send の params.message.contextId に指定する |
Postmanの {{$guid}} に相当するID生成をPythonの uuid4() で行っています。
最初の質問では contextId を指定せず、ADBから返ってきた値を st.session_state に保存します。続きの質問では保存した値を次のように付けます。
if st.session_state["context_id"]:
message["contextId"] = st.session_state["context_id"]
同じ contextId で送ることで「2026年10月の売上について聞いていた会話」に続きの質問を関連付けます。前編のTaskには、期間が省略された質問で前の期間と集計条件を補う指示も設定しています。 A2Aの会話とタスク
画面の履歴は history、APIに渡す会話IDは context_id として st.session_state に保存します。サイドバーの「新しい会話を開始」を押すと、この2つと回答待ちの情報をクリアし、次の入力から新しい会話を始めます。ブラウザーの再読み込みなどでStreamlitのセッションが切れた場合も、新しい会話になります。 StreamlitのSession State
回答待ちをクリアしても、ADBで受け付け済みのタスクは処理を続ける場合があります。
7. 応答を確認するときのポイント
| 画面の表示や状況 | 確認する内容 |
|---|---|
secrets.toml の設定エラー |
.streamlit/secrets.toml の保存場所と [adb] 配下の項目を確認する |
| HTTP 400・401 | 前編のPostmanで同じADBのOCIDと ADMIN の資格情報によるトークン取得を確認する |
| HTTP 404 | 設定したリージョン、ADBのOCID、チーム名を前編の成功したURLと照合する |
Agent not found |
前編と同じ ADMIN で認証し、対象ADBの SALES_TEAM を指定しているか確認する |
| 回答待ちの時間切れ | 「回答の取得を続ける」を押して、保存したtaskIdの状態を再確認する |
| JSON-RPCのエラー | 表示されたコードとメッセージを確認する |
おわりに
前編のAPI呼び出しをStreamlitに組み込み、チャット画面で質問して回答を表示できる形にしました。contextId を引き継ぐことで前の質問を保ち、「1位は?」のように省略した質問でも前の条件を踏まえた回答を得られます。




