2025/04/08 - APIエージェントによるテスト作成の早期アクセス – mablヘルプ

生成AIの力でAPIテストのワークフローを加速する新機能、APIテスト向けmablエージェントをご紹介できることを嬉しく思います。

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

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

早期アクセス

エージェントは現在、早期アクセス段階にあり、この期間中は追加費用なしでお試しいただけます。

透明性を確保するために、mablは現在、一般提供時にmablエージェントを高度な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テストエディターで確認します。ステップを実行し、その動作を検証し、必要に応じて調整を行ってください。

エージェントを試してAPIテストの取り組みを加速していただけることを嬉しく思います！詳細については、生成AIを使ったAPIテストの作成のドキュメントをご確認ください。

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

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