AI ツール
AI エージェントは当て推量で答えることはありません — 固定された一連の機能を通じて動作します。それぞれの機能は、何かを読み取るか、開けるビューを提示するか、コミット用に変更をステージングするかのいずれかです。このページは信頼のリファレンスです。エージェントができることと、各機能がどのように制御されるかを説明します。
操作はどのように制御されるか
DynoTable は デフォルトで安全です。すべての機能は、いくつかのアクセスクラスのいずれかに分類されます。
- 読み取り（黙って実行） — 軽量で読み取り専用の参照で、主にローカルまたはテーブルのメタデータが対象です。プロンプトはなく、そのまま実行されます。このうちいくつかは DynamoDB からアイテムを読み取ります。ローカルインデックスのないテーブルでは、最初のスキーマやサンプル値の参照が
Scanで最大 100 アイテムをサンプリングし（読み取りキャパシティを消費）、ベクトル検索は検索したバイト数で課金されます。 - 読み取り（制御あり） — AWS にアクセスしてキャパシティを消費する読み取り（クエリ、単一アイテムの読み取り）。エージェントは最初の1回の前に確認し、その後は許可モードに従ってあなたの選択を記憶します。ビジュアルフィルターのクエリは、クエリビルダーで組み立てるのと同じインデックスとキー条件を使います。
- 提案 — エージェントは、クリックするとタブを開く チップ を出します。クリックするまでタブは開きませんが、チップを用意する際に読み取りが発生することがあります。ローカルインデックスのないテーブルは列を選ぶために（最大 100 アイテム）サンプリングされ、Smart Table のチップは結合が解決できるかを確かめるために結合値のサンプルを読み取ります。
- 開く（制御あり） — タブをすぐに開いたり変更したりしますが、許可ゲートの背後にあります。
- 書き込み（ステージング経由） — ステージングを通じて処理されます。あなたがレビューしてコミットします。エージェントが DynamoDB に直接書き込むことはありません。
- エクスポート（制御あり） — 結果をファイルに取り出します。S3 へのエクスポートは、Full Auto でも毎回確認を求めます。
制御されたすべての操作は、プロファイルごとに設定する 許可モード — Manual、Auto、Full Auto — に従って承認されます（AI チャット → AI のセットアップを参照）。制御されたすべての判断は、常時オンのローカル 監査ログ に記録されます。
できること
テーブルと保存した作業を理解する
エージェントは質問に答えるために schema を読み取ります。アクティブなプロファイルにあるテーブル、そのキースキーマ、DynamoDB のインデックス、課金モード、保存した Smart Table と Workbench のスペック、宣言したリレーションシップ、そして開いているタブです。
ローカルのテーブルインデックスもコンテキストとして使います。これらはすべて 読み取り（黙って実行） で、プロンプトはありません。読み取りはローカルで行いますが、テーブルにまだローカルインデックスがない場合は例外で、スキーマの参照がインデックスを作るために DynamoDB から最大 100 アイテムをサンプリングします。その読み取りを自分で判断したい場合は、先にテーブルダイアログの インデックス セクションからテーブルをインデックスしてください。
データを読み取る
ライブデータが必要なときは、読み取り専用の PartiQL または Workbench SQL（SELECT のみ — JOIN、GROUP BY、集計を含む）を実行し、キーで単一アイテムを読み取り、またはクエリに一致するアイテムを数えます。これらは 読み取り（制御あり） です — DynamoDB にアクセスしてキャパシティを消費するため、エージェントは最初の1回の前に確認します。例外はベクトル検索で、読み取り（黙って実行） としてプロンプトなしで実行されます。DynamoDB は検索が調べて返したバイト数で課金し、既存のアイテムを基準に検索するときはさらにアイテム 1 件の読み取りが加わります。
テーブル全体で正確に計算する
テーブル全体 にわたるカウント、合計、平均、内訳を求めると、エージェントが直接計算します — 先に自分でデータをエクスポートする必要はありません。結果は テーブル全体にわたって正確 です。1〜2ページをサンプリングするのではなく、一致するすべてのアイテムを読み取るため、「先月の注文は何件か？」や「リージョン別の総売上」といった答えは、部分的な推測ではなく実際のデータを反映します。同じことを 変換したエクスポート の作成にも使えます — テーブル全体を1ステップで再構成、フィルタ、または集計して新しいファイルにします。これは 制御あり です — 全件処理はテーブルを読み取って読み取りキャパシティを消費するため、エージェントは先に確認します。
求めたビューを開く
エージェントは、ワークスペースを乗っ取るのではなく、ビューを 提示 することを優先します。クリックするとテーブル（必要に応じてフィルタ済み）、既存の行または新しい行のアイテムエディタ、Smart Table、または SQL を事前に入れた Workbench タブを開いたりフォーカスしたりする チップ を出します — これが 提案 で、クリックするまで何も開きません。今すぐ開いてほしいと明確に求めた場合は、代わりにタブをすぐに開いたり絞り込んだりできます。これが 開く（制御あり） です。
書き込みをステージングする — 直接書き込むことは決してない
エージェントがデータを変更する方法は 1つ だけです。ステージングエリアに変更を ステージング し、あなたがレビューしてコミットします。これが 書き込み（ステージング経由） です。エージェントは作成・更新・削除を 1 アイテムずつステージングするか、最大 10,000 アイテムの一括編集または一括削除を 1 回の呼び出しでステージングします。
ターンが終わると、エージェントはそのターンでステージングしたすべての変更について、確認用のチップ — ステージされた変更 N 件を確認 — を 1 つ表示し、保留中の変更がステージ済みの行を表示した状態で開きます。
エクスポートとファイルの操作
エージェントは、開いているタブまたは1回限りの SELECT を CSV、JSON、NDJSON にエクスポートし、進行中のエクスポートを追跡できます。また、すでにエクスポートした（またはチャットに添付した）ファイルに対して、検査、読み取り、または SQL 変換の実行もできます — 作業したいデータがライブテーブルではなくローカルファイルの場合に便利です。エクスポートと変換は 制御あり です。エクスポートの確認やファイルの読み取りは黙って実行されます。
テーブルタブを S3 へエクスポートすることもできます。タブのビジュアルクエリを、エージェントが指定したバケット、プレフィックス、時点、形式で書き出します。S3 へのエクスポートは AWS で実行・課金され、キャンセルできないため、Full Auto でも、以前にエクスポートを許可していても、呼び出しのたびに 必ず確認 を求めます。確認では出力先、形式、時点、読み取る範囲が示され、その 1 回の呼び出しに対する 拒否 か 許可 だけを選べます。選択は記憶されません。エージェントが書き込めるのは、あなた自身のアカウントのバケットだけです。MCP サーバーは S3 へのエクスポートを拒否します。
リクエストが曖昧なときは確認する
何を意味するのか確信が持てないとき、エージェントは名前付きの少数の選択肢を添えた確認の質問をし、あなたが答えるまでターンを一時停止します。
