--- title: Serverless Days 2026 ハンズオン資料 tags: author: [Tadatoshi Sekiguchi](https://docswell.com/user/3335137) site: [Docswell](https://www.docswell.com/) thumbnail: https://bcdn.docswell.com/page/LJ3W4Y81J5.jpg?width=480 description: Serverless Days 2026 ハンズオン資料 by Tadatoshi Sekiguchi published: September 20, 26 canonical: https://docswell.com/s/3335137/Z3JND1-2026-09-20-042358 --- # Page. 1 ![Page Image](https://bcdn.docswell.com/page/LJ3W4Y81J5.jpg) ServerlessDays Tokyo 2026 Hermes Agent + TiDB Cloud Starter AIエージェントの作業と記憶を永続化するハンズオン PingCAP株式会社 TiDB Xエバンジェリスト 関⼝匡稔 # Page. 2 ![Page Image](https://bcdn.docswell.com/page/8JDKQ5MKEG.jpg) 本⽇使うURL⼀覧 ● TiDB Cloud Signup ○ ● TiDB Cloud Login ○ ● https://labs.tidb.io/ja TiDB Cloud Document ○ ● https://tidbcloud.com/login TiDB Labs ○ ● https://tidbcloud.com/signup https://docs.pingcap.com/ja/tidbcloud/ Hermes Agent Document ○ https://hermes-agent.nousresearch.com/docs # Page. 3 ![Page Image](https://bcdn.docswell.com/page/VEPKLGR378.jpg) TiDB Labsの紹介 〜お手軽実験環境〜 # Page. 4 ![Page Image](https://bcdn.docswell.com/page/27VVQ6RN7Q.jpg) TiDB Labsとは ● ハンズオンシナリオと実⾏環境 が⼀体になったTiDBの演習環境 ● TiDB CloudのアカウントでSSO ● ⾃分のクラスタを使って演習も 可能（演習後データが残る） # Page. 5 ![Page Image](https://bcdn.docswell.com/page/5JGLWNM57L.jpg) TiDB Cloudサインアップ TiDB Labsのログインに必要 https://tidbcloud.com/signup ● Sign up with Emailから ● サインアップ後、Emailの確認 メールが届きます。確認必須で すのでメール中のボタンを押し てください。 サインアップの⽅法もご覧ください https://pingcap-japan.storylane.io/sh are/rtttoansipnl # Page. 6 ![Page Image](https://bcdn.docswell.com/page/47QY3QRLEP.jpg) TiDB Labsログイン https://labs.tidb.io/ ● 右上のサインアップから ● TiDB Cloudのアカウントでログイン # Page. 7 ![Page Image](https://bcdn.docswell.com/page/KE4W1N85J1.jpg) バウチャーの引き換え バウチャーは、特定のハンズオンを 実⾏できるようにします 1. 右上の個⼈メニューから 「クーポン」を選択 2. バウチャーコードを⼊⼒ 3. 「ワークショップ」メ ニューに、実⾏可能なワー クショップが登録される 4. このメニューからハンズオ ンを実⾏する 本日のコード : F7KAWA # Page. 8 ![Page Image](https://bcdn.docswell.com/page/L71YG522JG.jpg) ハンズオン（レクチャー） 利用技術の紹介 # Page. 9 ![Page Image](https://bcdn.docswell.com/page/G7WGK5R2E2.jpg) TiDB Cloud Filesystem の動機 Sandboxes are disposable. Workspaces should not be. ● ランタイムでコントロールできるクラウド ワークスペース ● どのサンドボックスからもマウントでき、 競合検出や並⾏試⾏をサポートする ● エージェントに新しいツールを使わせな い。Unix Toolsやgitがそのまま利⽤できる Sandbox /mnt TiFS :/project Sandbox /mnt # Page. 10 ![Page Image](https://bcdn.docswell.com/page/4JZLZNR4E3.jpg) TiDB Cloud Filesystem 全体像 # Page. 11 ![Page Image](https://bcdn.docswell.com/page/YE6WZ8RGEV.jpg) Filesystem in Userspace (FUSE) 概要 https://en.wikipedia.org/wiki/Filesystem_in_Userspace カーネルコードを書き換えることなく、ユーザー空間で独⾃ファイルシステムを実装する仕組み FUSEの主な特徴 ● 安全な開発: カーネルモジュールのビルドや 特権変更が不要 ● 柔軟な拡張性: 仮想ファイルシステムやクラ ウドストレージの作成に最適 ● マルチプラットフォーム: Linux, macOS, Windows(WinFsp)等で対応 ユーザーアプリからは通常のAPIコール(read/write) で、カーネル側でユーザーアプリケーションをコー ルバックする。 ユーザー空間 (User Space) ユーザーアプリ FUSE Daemon (ls, cat, etc.) (Hander Program) カーネル空間 (Kernel Space) VFS FUSE Kernel (Virtual File System) Module # Page. 12 ![Page Image](https://bcdn.docswell.com/page/GE5MW98XE4.jpg) Hermes Agent 概要 https://hermes-agent.nousresearch.com/ Nous Researchが開発した、成⻑するオープンソースAIエージェント #1 #2 #3 マルチプラットフォーム 永続メモリ & スキル学習 サンドボックス & 委任 CLI、Telegram、Discord、Slackなど 多様なUIで動作。1つのメモリを共 有。 プロジェクトを学習し、⾃動でスキル を⽣成。解決策を記憶して⾃⼰成⻑。 DockerやModal等の独⽴環境で安全に 実⾏。サブエージェントへタスク委 任。 主な特徴‧提供形態: ● ● ● MITライセンスのオープンソース（Mac OS, Windows, Linux対応） ⾃然⾔語による⾃動スケジュール実⾏やWeb検索、コード実⾏機能を標準搭載 Nous Portalによるエージェントの活動に必要なモデル‧ツールの⼀括提供 # Page. 13 ![Page Image](https://bcdn.docswell.com/page/9729Q2KQJR.jpg) Hermes Agent アーキテクチャ ここをサンドボックスで実行 できて（比較的）安心！ # Page. 14 ![Page Image](https://bcdn.docswell.com/page/DJY4WYNY7M.jpg) ハンズオン紹介 # Page. 15 ![Page Image](https://bcdn.docswell.com/page/V7NY9PXRE8.jpg) ハンズオン概要 https://labs.tidb.io/ja/labs/demo_901 TiDB Cloud Filesystem(TiFS)の⼊⾨コースです。 HermesとTiFSを組み合わせた演習です。 ● TiDB CLI（tiコマンド）のセットアッ プと利⽤ ● Hermes tui インターフェースの利⽤ ● TiFSスキルの導⼊ ● TiFSへのファイルの保存、利⽤ ※ ⾃分のTiDB CloudのAPI KEYが必要にな ります。 # Page. 16 ![Page Image](https://bcdn.docswell.com/page/YJ9P238Z73.jpg) ハンズオン詳細：モジュール１ TiDB Cloud Filesystem(TiFS)のセットアップ ● TiDB CLI（tiコマンド）はTiDB Cloud StarterとTiFSの両⽅を扱えます ※重要※ ● ステップ2でTiDB CloudのAPI Keyが 必要です（次ページ参照） ● TiFSはTiDBを使いますが、TiDBクラ スタとは別で管理されており、Webコ ンソール上からは⾒えません # Page. 17 ![Page Image](https://bcdn.docswell.com/page/GJ8D5MZYJD.jpg) TiDB CloudでのAPIキーの発⾏ https://pingcap-japan.storylane.io/share/fbvbu1wcwoax 1. TiDB Cloudにログイン 2. 「Organization Settings」から「API Keys」を選択 3. 「Create API Key」を選択 4. 「Description」にキーの名前を⼊⼒し、 そのまま「Generate API Key」を押す 5. 出⼒されたPublic KeyとPrivate Keyをメ モ # Page. 18 ![Page Image](https://bcdn.docswell.com/page/LJLMY3D9ER.jpg) ハンズオン詳細：モジュール２ HermesとTiFSを組み合わせる ※通常、Hermesのサンドボックスはローカルのディレクトリをバインドマ ウントするため、データはローカルに永続化されます。 この演習ではSandboxが使い捨てと想定して、TiFSで異なるコンテナでも データが共有できる（引き継げる）ことを確かめるものです※ 【Tips】 ● LLMモデルはBedrockのDeepseek v3.2 ○ ちょっと賢さが⾜らないので例の通りにならないこともありま す。 ● docker commitで、現在までのセットアップを焼き込んで新しい dockerイメージを作る ○ Hermesの実⾏コンテナをここで作ったものに切り替えています。 モジュール1の⼿順を繰り返さなくて良いようにしています。 # Page. 19 ![Page Image](https://bcdn.docswell.com/page/47MYNDPV7W.jpg) ハンズオン詳細：モジュール３ TiDB Cloud StarterをHermesエージェントから利⽤する ● エージェントを使ったサービスを作る際には、なんらかのデータベー スを使うことが⼀般的です。このモジュールはTiDBでエージェントか らデータベースを使う演習です。 ● TiDBは⽐較的新しいデータベースですが、現代のLLMだと前提知識な しでも扱えるのが分かると思います。 ○ DeepSeek v3.2だとたまに失敗することもありますが、その場合 は「TiDBで」と明⽰的にDBを指定するとうまくいくと思います。 # Page. 20 ![Page Image](https://bcdn.docswell.com/page/P7R9D41WE9.jpg) ハンズオン詳細：モジュール4 後⽚付け ● 終了を忘れずに！ ○ インスタンス等は時間で削除 されるが、履修状態はそのま ま ● 同時に実⾏できるLabは⼀つだけ なので、別のLabを実⾏する前に 終了します # Page. 21 ![Page Image](https://bcdn.docswell.com/page/PJXQ12YV7X.jpg) TiDB Cloud Starter 紹介 https://labs.tidb.io/ja/labs/demo_201 TiDB Cloud Starter(旧Serverless) の⼊⾨コースで す。CLIからの使い⽅や、HTAPを体験できます。 ● MySQL CLIを使ったDBアクセス ● Python（mysql.connector）を使った アクセス ● HTAP（TiFlash）の設定と利⽤ ● ベクトル検索 ⾃分のTiDB Cloudアカウント内にStarter を作成します 時間が余ったらこちらもやってみ てください # Page. 22 ![Page Image](https://bcdn.docswell.com/page/3JK92M35JD.jpg) Appendix A TiDB Cloud Filesystem 諸機能 # Page. 23 ![Page Image](https://bcdn.docswell.com/page/LE3W4YG1E5.jpg) TiDB Cloud Filesystem：仕組み ● FUSEを使った仮想ファイルシステム ● 通常のファイル同様にread/write。Unix コマンドなどもそのまま利⽤可能 ● ファイルはローカルキャッシュに書か れ、⾮同期でサーバに送信 ● ファイルタイプに応じたメタデータ付与 ● ⾮構造化ファイルもLLMによりメタデー タ⽣成 ● Sandbox側 / ti-client Agent / Unix Tools Linux VFS / FUSE Local Cache drive9-server API LLM / Embedding データファイル本体はS3などに書かれる Metadata DB + S3 # Page. 24 ![Page Image](https://bcdn.docswell.com/page/8EDKQ51K7G.jpg) スコープの制御 ● Drive9はテナントと呼ばれるスコープ を持つ ○ ● Agent-2 テナント毎に名前空間も別 エージェント作業⽤に、短期のサブコ ンテキスト（トークン）を作成するこ とができる ○ ● Agent-1 このとき、パス単位でアクセス制 御を付与できる エージェントの役割に応じて細かいア クセス制御を可能にすることが可能 /repo /src /docs drive9 token issue agent-2 --ttl 1h \ --allow /repo/docs:read,list,search,write # Page. 25 ![Page Image](https://bcdn.docswell.com/page/V7PKLGQ3J8.jpg) 楽観ロックによる競合検知 ● drive9は競合検知の仕組みを持つ ● ファイルのメタ情報としてバージョン 番号を持つ ○ この番号は更新時に増加する ● Openの際にこの番号を読み、Writeの 際に番号を指定して更新する ● サーバ側のバージョンがそれより進ん でいた場合は競合発⽣としてエラー ● 失敗側には失敗したファイルが残る ① ⭕ Write report.md v1 Sandbox /mnt ② v1 → v2 drive9 :/project Sandbox /mnt ③ ❌ Write report.md v1 # Page. 26 ![Page Image](https://bcdn.docswell.com/page/2JVVQ65NJQ.jpg) 試⾏をサポートするレイヤー機能 ● ● ● Copy-on-Writeにより元のデータに オーバーレイするレイヤーを作成 main v1 レイヤーを指定してマウントできる レイヤー上の更新は元のデータに反映 されず、レイヤーに限定される ● レイヤーは複数作成でき、エージェン トの試⾏などに役⽴つ ● レイヤーは最終的に元（main）に commit、または廃棄（rollback） layer-A layer-B 更新 更新 rollback 更新 commit main v2 # Page. 27 ![Page Image](https://bcdn.docswell.com/page/5EGLWN65JL.jpg) Appendix B Hermes Agent # Page. 28 ![Page Image](https://bcdn.docswell.com/page/4JQY3Q4L7P.jpg) Hermes Agentの活⽤ ● Hermes AgentはGUIバージョンもあり 簡単にセットアップ可能です ● モデルプロバイダをOrcaRouterにす ることも可能 ○ hermes model でモデル選択 ○ custom > base URL , API Key, モ デル (orcarouter/free等) 設定 ○ https://docs.orcarouter.ai/ja/int egrations/hermes-agent ● TelegramやDiscord botも簡単に 作成できます ○ hermes gateway setup ○ ⾃分の好きなサービスを選択 # Page. 29 ![Page Image](https://bcdn.docswell.com/page/K74W1NQ5E1.jpg) Thank you Chapter Title Confidential, do not distribute / 29