0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【OCI】Autonomous AI DatabaseのSelect AI AgentをA2Aで呼び出す(後編・Streamlit)

0
Last updated at Posted at 2026-11-18

はじめに

前編ではOracle Autonomous AI Database(ADB)に売上テーブルとSelect AI Agentを用意し、PostmanからA2A APIで質問して回答を取得しました。

後編では同じAPIをStreamlitにつなぎ、質問を入力すると回答まで表示されるチャット画面を作ります。「2026年10月の売上が2番目に高い担当者」を聞いた後に「1位は?」と続けて質問できるようにします。

前編の記事はこちら

1. 構成と前提

■構成
image.png

前編で作成した環境を使います。接続先とオブジェクトは次のとおりです。

項目 設定値
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> を前編で使った値に置き換えます。

.streamlit/secrets.toml
[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
app.py
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 を開きます。

チャット画面

image.png

最初に前編と同じ要領で連続した質問をします。
前編のサンプルデータで期待する結果は次のとおりです。

順番 入力する質問 期待する結果
最初の質問 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 を変更したときも終了し、同じ起動コマンドで再起動します。

実行結果例①

image.png

実行結果例②

image.png

実行結果例③

image.png

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位は?」のように省略した質問でも前の条件を踏まえた回答を得られます。

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?