Research usecase by Hikotty · Pull Request #1414 · aws-samples/generative-ai-use-cases

Hikotty · 2026-01-12T10:53:21Z

Description of Changes

This PR introduces a new Research Agent feature that enables users to conduct comprehensive research tasks using web search capabilities.

New Features

Research Agent Use Case: A new use case that performs various research tasks across industries using web search (Brave/Tavily) and generates detailed research reports
Bedrock AgentCore Integration: Leverages AWS Bedrock AgentCore Runtime for agent execution
Multiple Research Modes: Supports quick research, general research, and technical research modes

Technical Changes

CDK Infrastructure: Added ResearchAgentCoreStack and ResearchAgentCore construct for deploying the research agent runtime
Python Lambda Runtime: Added research agent core runtime with web search tools (Brave Search, Tavily)
Frontend Components: Added ResearchAgentPage.tsx, useResearchAgent.ts hook, and DiagramRenderer.tsx component
Configuration: Added new CDK context parameters:
- researchAgentEnabled (default: false)
- createResearchAgentCoreRuntime (default: false)
- researchAgentBraveApiKey (single string, not array)
- researchAgentTavilyApiKey (single string, not array)

Impact on Existing Users

No breaking changes: The feature is disabled by default
Opt-in activation: Users must explicitly enable the feature by setting researchAgentEnabled: true and providing API keys in cdk.json
New dependencies: Requires @aws-cdk/aws-bedrock-agentcore-alpha package (already included)

How to Enable

Set researchAgentEnabled: true in cdk.json
Set createResearchAgentCoreRuntime: true in cdk.json
Provide either researchAgentBraveApiKey or researchAgentTavilyApiKey (or both)
Deploy with npm run cdk:deploy

Checklist

Modified relevant documentation
Verified operation in local environment
Executed npm run cdk:test and if there are snapshot differences, execute npm run cdk:test:update-snapshot to update snapshots

Related Issues

Related to #1000

Sugi275 · 2026-01-17T12:05:50Z

Document について

Research を利用するために、GenU のデプロイをする方がどんな作業をすればいいのか説明する Document も追加をお願いできますでしょうか？
Marketplace で Brave の利用を開始いただく導線は用意をしたくて、そのための Document を準備いただけたら幸いです！

Document については、以下を意識していただけると幸いです。

以下の DEPLOY_OPTION は簡潔に記載する。
https://github.com/aws-samples/generative-ai-use-cases/blob/main/docs/ja/DEPLOY_OPTION.md

詳細な Document を用意する場合は、以下のような新しいドキュメントを用意する
https://github.com/aws-samples/generative-ai-use-cases/blob/main/docs/ja/<新しいドキュメント>.md

- リサーチエージェントデプロイガイドを追加（日本語/英語/韓国語） - DEPLOY_OPTION.mdにリサーチエージェントセクションを追加 - Brave Search API取得手順の画像8枚を追加

- Add isResearchAgent flag to StrandsStreamProcessor - Detect research agent by checking mode field (technical-research, mini-research, general-research) - Process <final_report> tags only for research agent (content inside tags -> chat, outside -> trace) - Keep backward compatibility for other AgentCore features (generic, agent builder, MCP) - No changes to Lambda/backend, only frontend processing

- Add name field to image ExtraData - Add null checks for block.image.source and block.document.source - Fix regex pattern (remove extra parenthesis) - Add default values for optional fields

- Restore all deleted translation keys in meetingMinutes section - generation_panel, hide_prompt, style_diagram, style_whiteboard, etc. - diagram options (flowchart, mindmap, sequence, timeline) - UI controls (both_panel, input_source, microphone, option, settings) - Add research section translations for all 6 languages - Fix Tavily API key injection for research agent backend - Update documentation with deployment instructions - Clean up MCP configuration and agent prompts

Hikotty · 2026-01-31T05:41:13Z

下記対応しました
・ドキュメントの追加
・MCP周辺の細かなバグの修正
・議事録ユースケースの誤った編集分のRestore

…me の 2 つ存在していたが、ほぼすべての状況でこちらは 1 個の変数のみ利用する形になるので、ユーザーへのわかりやすさを優先して 1 つにまとめる

Sugi275

各種指摘修正されているのを確認しました！ Approved です！

Sugi275 · 2026-01-13T11:38:22Z

packages/cdk/cdk.json

127 行目の "@aws-cdk" の後に追加するよりは、94 行目の "closedNetworkCreateResolverEndpoint" の後に記載いただくのが良いかなとおもいました。

https://github.com/aws-samples/generative-ai-use-cases/pull/1414/files#diff-6c87a1c3644d483b1634e8d5689d80c4bd3a93ca9f656019dbb934ced8ac9129R93

Sugi275 · 2026-01-13T11:41:14Z

packages/web/public/locales/translation/en.yaml

少し前の main ブランチからマージをされているような気がしています。議事録機能側の変更が少し前にデグレっています。最新のファイルに、議事録側を更新できますか？

Sugi275 · 2026-01-13T11:41:21Z

packages/web/public/locales/translation/ja.yaml

少し前の main ブランチからマージをされているような気がしています。議事録機能側の変更が少し前にデグレっています。最新のファイルに、議事録側を更新できますか？

Sugi275 · 2026-01-13T11:41:33Z

packages/web/public/locales/translation/ko.yaml

少し前の main ブランチからマージをされているような気がしています。議事録機能側の変更が少し前にデグレっています。最新のファイルに、議事録側を更新できますか？

Sugi275 · 2026-01-13T11:41:39Z

packages/web/public/locales/translation/th.yaml

少し前の main ブランチからマージをされているような気がしています。議事録機能側の変更が少し前にデグレっています。最新のファイルに、議事録側を更新できますか？

Sugi275 · 2026-01-17T12:10:05Z

packages/cdk/cdk.json

+    "researchAgentEnabled": false,
+    "createResearchAgentCoreRuntime": false,


researchAgentEnabled と createResearchAgentCoreRuntime を別に Flug を用意する必要はないのかなと思いました。
researchAgentEnabled は、フロントエンド側の表示を制御するためのもので、createResearchAgentCoreRuntime こちらは CDK 側で、AgentCore Runtime をデプロイするのかどうかのフラグだと理解しています。

Research のユースケースに関しては、1 個のフラグで管理することで問題ないかなと思っています。

createGenericAgentCoreRuntime について

createGenericAgentCoreRuntime に関しては、汎用的な AgentCore Runtime のデプロイをコントロールするもので、ユーザーが選択しても良いと思いますが、Research においては、2 つのフラグに分ける意図は思い浮かびませんでした～。

Sugi275 · 2026-01-17T13:04:03Z

packages/cdk/lambda-python/research-agent-core-runtime/.gitignore

+*$py.class
+.venv/
+.uv/
+uv.lock


uv.lock は、gitignore に入れてしまうと、GenU の Deploy に失敗してしまっていました。
uv.lock は、repository に入れる形になるかなと思っていますが、いかがでしょう？

エラーログ

Dockerfile:21 -------------------- 19 | 20 | # Copy dependency files 21 | >>> COPY pyproject.toml .python-version uv.lock ./ 22 | # Install Python dependencies 23 | RUN uv sync -------------------- ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref 3f5f5128-b8d9-41c0-92a2-a49a72017586::05e5lo44mff40m7ddu6djusiv: "/uv.lock": not found ResearchAgentCoreStack: fail: docker build --tag cdkasset-41f0e080dd905095131f2c326b011c98a063c4398180a2df0db231319a0829f0 . exited with error code 1: #0 building with "default" instance using docker driver #1 [internal] load build definition from Dockerfile #1 transferring dockerfile: 1.14kB done #1 DONE 0.0s #2 [internal] load metadata for public.ecr.aws/docker/library/python:3.13 #2 DONE 0.9s #3 [internal] load .dockerignore #3 transferring context: 201B done #3 DONE 0.0s #4 [internal] load build context #4 transferring context: 1.59kB done #4 DONE 0.0s #5 [ 3/11] RUN apt-get update -y && apt-get install curl nodejs npm -y #5 CACHED #6 [ 4/11] RUN curl -LsSf https://astral.sh/uv/install.sh | sh #6 CACHED #7 [ 2/11] WORKDIR /var/task #7 CACHED #8 [ 5/11] RUN npm install -g mcp-remote #8 CACHED #9 [ 6/11] COPY pyproject.toml .python-version uv.lock ./ #9 ERROR: failed to calculate checksum of ref 3f5f5128-b8d9-41c0-92a2-a49a72017586::05e5lo44mff40m7ddu6djusiv: "/uv.lock": not found #10 [ 1/11] FROM public.ecr.aws/docker/library/python:3.13@sha256:02865b3929f3910fc2d6ebbf745bf00504d316478dacaea7d9e230e134411bcb #10 resolve public.ecr.aws/docker/library/python:3.13@sha256:02865b3929f3910fc2d6ebbf745bf00504d316478dacaea7d9e230e134411bcb 0.0s done #10 sha256:02865b3929f3910fc2d6ebbf745bf00504d316478dacaea7d9e230e134411bcb 10.96kB / 10.96kB done #10 CANCELED ------ > [ 6/11] COPY pyproject.toml .python-version uv.lock ./: ------ Dockerfile:21 -------------------- 19 | 20 | # Copy dependency files 21 | >>> COPY pyproject.toml .python-version uv.lock ./ 22 | # Install Python dependencies 23 | RUN uv sync -------------------- ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref 3f5f5128-b8d9-41c0-92a2-a49a72017586::05e5lo44mff40m7ddu6djusiv: "/uv.lock": not found

Sugi275 · 2026-01-17T14:07:51Z

packages/cdk/lambda-python/research-agent-core-runtime/mcp-configs/mcp.json

+    "brave-search-1": {
+      "command": "npx",
+      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "env": {
+        "BRAVE_API_KEY": ""
+      },
+      "metadata": {
+        "category": "Search",
+        "description": "Primary web search capabilities powered by Brave Search (API Key 1)"
+      }
+    },
+    "brave-search-2": {
+      "command": "npx",
+      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "env": {
+        "BRAVE_API_KEY": ""
+      },
+      "metadata": {
+        "category": "Search",
+        "description": "Secondary web search capabilities powered by Brave Search (API Key 2)"
+      }
+    },
+    "brave-search-3": {
+      "command": "npx",
+      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "env": {
+        "BRAVE_API_KEY": ""
+      },
+      "metadata": {
+        "category": "Search",
+        "description": "Tertiary web search capabilities powered by Brave Search (API Key 3)"
+      }
+    },
+    "brave-search-4": {
+      "command": "npx",
+      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "env": {
+        "BRAVE_API_KEY": ""
+      },
+      "metadata": {
+        "category": "Search",
+        "description": "Quaternary web search capabilities powered by Brave Search (API Key 4)"
+      }


こちらって、MCP Server 4 つ起動する背景ってありそうですか？ API Key は 1 個しか指定できないので、MCP Server も 1 個でいいんじゃないかなと思いました。

Sugi275 · 2026-01-25T05:46:05Z

packages/cdk/lambda-python/research-agent-core-runtime/src/tools.py

+        brave_api_key = os.getenv("BRAVE_API_KEY", "")
+        if brave_api_key:
+            # Inject into brave-search server
+            if "brave-search" in servers:
+                if "env" not in servers["brave-search"]:
+                    servers["brave-search"]["env"] = {}
+                servers["brave-search"]["env"]["BRAVE_API_KEY"] = brave_api_key
+                logger.info("Injected Brave API Key into brave-search MCP server")


ここの Brave の API key を挿入する実装なのですが、mcp-configs/mcp.json の brave-search-1, brave-search-2, brave-search-3, brave-search-4 の指定とずれていて、API キーが挿入されていないように見えています。

mcp-configs/mcp.json は、brave は 1 個だけでいいかなという気がしています。

Sugi275 · 2026-02-01T05:07:42Z

packages/web/src/utils/strandsUtils.ts

-    case 'video':
-      return {
-        video: {
-          format: getVideoFormatFromMimeType(data.source.mediaType),
-          source: {
-            bytes: base64Data,
-          },
-        },
-      };
-


こちら、video を削除された背景はありますでしょうか？

Sugi275

LGTM です！各種修正されていることを確認しました。

Hikotty added 3 commits January 12, 2026 07:39

feat: integrate research agent feature

8dbae5d

fix: API input

7b74c4e

test: update CDK snapshots for research agent feature

7bde82f

Sugi275 added the auto-deploy 自動的に検証用 AWS アカウントにデプロイするための Label label Jan 13, 2026

Hikotty and others added 2 commits January 21, 2026 19:51

Merge branch 'aws-samples:main' into research-usecase

2fd5d63

Hikotty force-pushed the research-usecase branch from 00a6468 to 79cb1a8 Compare January 27, 2026 07:50

Hikotty added 4 commits January 27, 2026 10:53

Revert Meeting Minutes changes to keep only research feature changes

731dc53

fix: resolve TypeScript errors in strandsUtils

beb085c

- Add name field to image ExtraData - Add null checks for block.image.source and block.document.source - Fix regex pattern (remove extra parenthesis) - Add default values for optional fields

Hikotty force-pushed the research-usecase branch from e6eeb82 to c2fc6e2 Compare January 30, 2026 07:46

Sugi275 and others added 12 commits February 1, 2026 03:05

cdk.json の順番を変更

1bdae3a

Research に不要なファイルの削除。おそらく、誤マージの影響で不要なファイルが混じってしまった想定

a758004

uv.lock を dockerignore から削除

e0446fd

uv.lock の追加

c775847

タイムアウトを追加

ac62b1f

fix:add mistakenly deleted video input feature

4da0813

Merge branch 'aws-samples:main' into research-usecase

aefed80

Merge branch 'aws-samples:main' into research-usecase

0e645ac

Merge branch 'aws-samples:main' into research-usecase

7266e21

Add Experimental label to Research use case in frontend navigation

b4761be

Merge branch 'aws-samples:main' into research-usecase

6eb1b2f

Sugi275 self-requested a review February 12, 2026 06:07

Sugi275 previously approved these changes Feb 12, 2026

View reviewed changes

タイムアウトを追加

33a4590

Sugi275 dismissed their stale review via 33a4590 February 13, 2026 15:25

不要なファイルを削除

cb3ca6d

Sugi275 approved these changes Feb 13, 2026

View reviewed changes

Sugi275 merged commit ce7904e into aws-samples:main Feb 13, 2026
3 checks passed

		"researchAgentEnabled": false,
		"createResearchAgentCoreRuntime": false,

Conversation

Hikotty commented Jan 12, 2026

Description of Changes

New Features

Technical Changes

Impact on Existing Users

How to Enable

Checklist

Related Issues

Uh oh!

Sugi275 commented Jan 17, 2026

Document について

Uh oh!

Hikotty commented Jan 31, 2026

Uh oh!

Sugi275 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

createGenericAgentCoreRuntime について

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Sugi275 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants