Dictionaryツール & 画像ツール

AIエージェント間でURLやPlaywrightロケーター等のセレクター情報を共有するためのツールです。エントリはアクセストークンが紐づくプロジェクトスコープで管理されます。

create_dictionary_entry

入力:

パラメータ	型	必須	説明
key	String	✓	ユニークなキー名（英数字・アンダースコア・ハイフン・ドット、最大100文字）。例: login_email_input
value	String	✓	値（Playwrightロケーター形式やURLを推奨）。例: [data-testid="email-input"]
description	String	-	説明（最大500文字）
author	String	-	操作者署名

出力: DictionaryEntry

---

list_dictionary_entries

入力パラメータなし（アクセストークンが紐づくプロジェクト配下の全エントリを返します）。

入力:

パラメータ	型	必須	説明
author	String	-	操作者署名

出力: DictionaryEntry[]

---

get_dictionary_entry

入力:

パラメータ	型	必須	説明
key	String	✓	取得するエントリのキー名
author	String	-	操作者署名

出力: DictionaryEntry

---

update_dictionary_entry

入力:

パラメータ	型	必須	説明
key	String	✓	更新するエントリのキー名
value	String	✓	新しい値
description	String	-	新しい説明
author	String	-	操作者署名

出力: DictionaryEntry

---

delete_dictionary_entry

キー名でDictionaryエントリを削除します。カスケード削除はされません — このキーを参照しているテストケースは未定義参照になります。この操作は取り消せません。

入力:

パラメータ	型	必須	説明
key	String	✓	削除するエントリのキー名
author	String	-	操作者署名

出力:

Copy{ "success": true, "key": "login_email_input" }

---

upload_test_case_image

テストケースに画像（jpg/png）を添付します。Base64エンコードされた画像データを渡してください。サーバー側でMIMEタイプ（magic bytes）とサイズ（最大5MB）を検証します。

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
caseNumber	Integer	✓	画像を添付するテストケースの安定ID（1以上の整数）
imageData	String (Base64)	✓	Base64エンコードされた画像データ（data:image/...;base64, プレフィックスは不要）
mimeType	String	✓	image/jpeg または image/png
description	String	-	画像の説明
author	String	-	操作者署名

出力: TestCaseImage

Copy{
  "id": "image-uuid",
  "testCaseId": "test-case-uuid",
  "mimeType": "image/png",
  "description": "ログイン画面のスクリーンショット",
  "downloadUrl": "https://cdn.katatan.com/...",
  "createdAt": "2026-01-01T00:00:00.000Z"
}

---

delete_test_case_image

テストケースに添付された画像を削除します。ストレージ上の実ファイルも削除されます（同一ファイルを参照する他のスナップショットが存在する場合は実ファイル削除をスキップ）。この操作は取り消せません。

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
caseNumber	Integer	✓	画像が添付されているテストケースの安定ID（1以上の整数）
imageId	String	✓	削除する画像のID
author	String	-	操作者署名

出力:

Copy{ "success": true, "imageId": "image-uuid" }