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

---

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"
}