2025/04/08 - APIテスト生成早期アクセス – mablヘルプ

生成AIによるAPIテスト作成を導入しました。これは、生成AIの力を活用してAPIテストのワークフローを加速するために設計された新機能です。

包括的なAPIテストを構築するには、リクエスト、ヘッダー、ボディ、アサーションを手動で定義する必要があり、時間がかかることがあります。生成AIによるテスト作成は、あなたの意図とAPIの詳細に基づいてテストステップを自動的に生成することで、このプロセスを効率化します。

生成されたAPIテストのプレビュー

早期アクセス

生成AIによるテスト作成は現在、早期アクセス中で、この期間中は追加費用なしでお試しいただけます。

透明性を確保するために、mablは現在、生成AIによるテスト作成を高度なAIアドオンの一部として一般提供する予定です。このアプローチは変更される可能性があることに注意してください。

実際の手順

生成AIによるテスト作成を使用してAPIテストを開始するには、次のステップを実行してください。

新しいAPIテストを作成: 新しいテスト > APIテストに移動します。
意図を定義する: テスト作成フォームで、テストで達成したいことを記述します。具体的に記述することで、より良い結果が得られます。例えば、単に「ユーザーエンドポイントをテストする」ではなく、「/usersエンドポイントの完全なCRUD操作を検証する: ユーザーの作成、ユーザー詳細の取得、ユーザーのメール更新、ユーザーの削除」と記述してみてください。
API情報を提供する 表示される「API specification」セクションで、テスト対象のAPIに関する詳細を追加し、mablにそのAPIとのやり取り方法を教えます。
- ファイルをアップロード (Upload files): 最良の結果を得るために、OpenAPIやGraphQLスキーマのようなAPI仕様をアップロードしてください。また、Postmanコレクション、HARログ、コードファイル、さらにはテキストの説明をアップロードすることもできます。
- APIの説明 (API descriptions): テキストフィールドを使用して、認証手順、必要なヘッダー、またはサンプルのcURLリクエストなどの補足情報を追加してください。

意図とAPI仕様の提供

テストを生成する: テスト作成フォームの残りの情報を入力した後、テストを作成をクリックします。mablのAIが、あなたの入力に基づいてテストステップのプレビューアウトラインを生成します。
レビュー: 生成されたAPIテストのアウトラインを確認してください。問題がなければ、テストを作成を再度クリックして、ステップをAPIテストエディターに読み込みます。問題がある場合は、意図を修正して新しいアウトラインを生成をクリックしてください。
テストを構築する: 生成されたステップを確認してください。URL、メソッド、ヘッダー、ボディ、アサーション、変数を含むAPIテストエディターで確認します。ステップを実行し、その動作を検証し、必要に応じて調整を行ってください。

生成AIによるテスト作成を試して、APIテストの取り組みを加速させることを楽しみにしています！生成AIを使用したAPIテストの作成に関するドキュメントをご覧ください。

早期アクセス期間中の次の制限事項にご注意ください。

生成されたステップの品質は、提供されたAPI情報と意図の完全性と正確性に大きく依存します。複雑なスキーマや不完全な情報は、課題を引き起こす可能性があります。
生成されたステップには、複雑な検証やリクエスト前後のスクリプト用のスニペットは現在含まれていません。
OAuth 1.0認証の設定は自動的に生成されません。APIにOAuthが必要な場合は、手動で設定する必要があります。
生成AIによるテスト作成では、APIフローはまだサポートされていません。
生成AIによるテスト作成は英語に偏っています。テストの意図を非英語で定義した場合でも、APIテストエディターはタスクとアサーションを英語で生成する可能性があります。