How aws-solutions-library-samples/guidance-for-agentic-ai-research-platform-on-aws works
AI Research Platform is a browser-based research assistant with configurable agents, project and task management, and streamed responses. A user submits a research prompt; the platform routes execution to an AgentCore agent, which can use research and sandbox tools, while project/task state and conversations are persisted. The graph also includes the documented custom-agent, team, and knowledge-retrieval capabilities. README and sampled files support the product shape; some runtime wiring and unsampled feature internals are omitted where their callers are not evidenced.
Main entry points: router.ts Service router · agent.py Base agent · agent-base-runtime.ts Bedrock AgentCore · page.tsx Research chat
Components 24
Web experience
- Research chat
app/platform/src/app/(main)/thread/[id]/page.tsx - Chat streaming
app/platform/src/hooks/use-chat-orchestrator-stream.ts - Agent setup
app/platform/src/app/(main)/agents/create/page.tsx - Team setup
app/platform/src/app/(main)/teams/create/page.tsx
Platform services
- RPC endpoint
app/platform/src/app/rpc/[[...rest]]/route.ts - API endpoint
app/platform/src/app/api/[[...rest]]/route.ts - Service router
app/platform/src/server/router.ts - Execution routes
app/platform/src/server/routes/execute.ts - Thread routes
app/platform/src/server/routes/thread.ts - Agent routes
app/platform/src/server/routes/agents.ts - Team routes
app/platform/src/server/routes/teams.ts
Agent runtime
- Base agent
app/agents/base/agent.py - Orchestrator
app/agents/orchestrator/agent.py - Research tools
app/agents/base/tools/retrieve.py - Web search
app/agents/base/tools/web_search.py - Code sandbox
app/agents/base/tools/sandbox/agentcore_code_interpreter.py - Task tools
app/agents/orchestrator/tools/tasks.py - Task completion
app/agents/base/tools/tasks.py - Agent database access
app/agents/orchestrator/utils/db.py
AWS services
- PostgreSQL
lib/platform/database-stack.ts - Bedrock AgentCore
lib/platform/agent-base-runtime.ts - Knowledge base
lib/platform/knowledge-store-stack.ts
Other components
- Researcher
- Web sources
Connections 23
- Researcher → Research chat: asks research
- Research chat → Chat streaming: submits prompt
- Chat streaming → RPC endpoint: calls execution
- RPC endpoint → Service router: dispatches RPC
- API endpoint → Service router: dispatches API
- Service router → Execution routes: routes execution
- Service router → Thread routes: routes threads
- Service router → Agent routes: routes agents
- Service router → Team routes: routes teams
- Execution routes → Bedrock AgentCore: starts agent runtime
- Bedrock AgentCore → Base agent: runs base agent
- Bedrock AgentCore → Orchestrator: runs orchestrator
- Base agent → Research tools: uses retrieval
- Base agent → Web search: searches web
- Base agent → Code sandbox: runs code
- Orchestrator → Task tools: manages tasks
- Base agent → Task completion: marks task complete
- Task tools → Agent database access: accesses database
- Agent database access → PostgreSQL: reads and writes
- Research tools → Knowledge base: retrieves knowledge
- Web search → Web sources: searches
- Agent setup → Agent routes: configures agents
- Team setup → Team routes: configures teams