## 概要：コーディングエージェントのための統合ストレージレイヤ

コーディングエージェントはコードの作成、コマンドの実行、複雑なタスクの分解に優れていますが、通常一時的な計算環境で動作しています。エージェントのメモリは圧縮・消失・消去されることもあり、コンテナは削除され、タスク終了とともにサンドボックス環境自体が失われることもあります。
また、コーディングエージェントは多数の小さなファイルを生成・変更するため、分散型かつ永続的なストレージが非常に重要になります。これは、分散データベースおよびクラウドネイティブストレージを専門とする TiDB が特に得意とする課題です。

```mermaid
---
title: コーディングエージェントのための統合ストレージレイヤ
---
flowchart LR
  subgraph region["クラウドリージョン"]
    style region stroke-dasharray: 5 5
    subgraph temporary["短期レイヤ - エージェントのサンドボックス"]
      FS_CLIENT["ファイル"]
      DB_CLIENT["データ"]
    end
    subgraph persistent["TiDB Cloud 永続レイヤ - スケーラブル＆常時稼働"]
      FS["ファイルシステム"]
      DB["Starter"]
    end
    FS_CLIENT -->|FUSE & POSIX| FS
    DB_CLIENT -->|SQL| DB
  end
```

<!-- markdownlint-disable MD032 -->
> [!IMPORTANT]
> ハンズオンを始める前に、以下の情報を必ずお読みください。
> - この演習はChromeブラウザのみサポートされています。
> - この演習は必要なモデルを呼び出すために Amazon Bedrock への一時的なアクセス権を付与します。演習資料に記載の利用ガイドラインに厳格に従い、このアクセス権を他の目的で使用しないでください。不正利用により金銭的損失が発生した場合、法的措置を取る場合があります。
> - この演習では、代表的なAIエージェントとして [Hermes Agent](https://hermes-agent.nousresearch.com/) を使用しますが、本演習で紹介する方法は他のエージェントにも応用できます。

### この入門ハンズオン演習であなたが達成すること

- TiDB Cloud コマンドラインツール **`ti`** のインストール、設定、使い方に慣れる
- Hermes Agent を設定し、TiDB Cloud Filesystem インスタンスをサンドボックス内の通常のPOSIXファイルシステムとしてマウントし、作業ディレクトリの永続化を実現する
- ファイルシステムだけでなく、Hermes Agent にシンプルかつ信頼できる分散データベースアクセス機能を提供する
- 「いつでも、どこでも、どのサンドボックスからも利用できる」堅牢なエージェント用ストレージレイヤを設計・構築する

> [!TIP]
> - この演習で使用する TiDB Cloud Filesystem と Starter サービスは、どちらも無料枠内で利用できます。
> - 左ナビゲーションバーに **「引き換え」** ボタンが表示されている場合、最初にクリックし、演習クレジットで演習を引き換えてください。もしくは、画面右上の個人メニューからインストラクター提供の演習コードを入力できます。
> - **「開始」** をクリックして演習環境を起動してください。
> - 約1～2分で環境準備が整ったら、下部ツールバーの **「次のモジュール」** をクリックして **「次のモジュール」** へ進みます。
> - その後、演習ガイドの手順に従ってハンズオン環境に接続し、作業を始めましょう。