Skip to main content
Version: 0.9.19

What runs in your account

AlphaAgent Studio is not a hosted service — it runs as a set of resources inside your own AWS account, and almost everything it does happens there. This page is the technical evaluator's map of those resources, how an agent run actually executes against the models, and what "Express" and "Deep Traversal" mean at a behavioral level. It is the foundation for the residency, sandboxing, and telemetry details in the rest of this section.

The single trust boundary

There is exactly one boundary that matters: your AWS account. Studio's web app, its services, your agent definitions, your conversations, your connector credentials, your workspaces and datasets, and your knowledge graphs all live inside it. The only traffic that ever leaves that boundary is the signed license and usage channel back to the AlphaAgent Console — covered in detail in Licensing and telemetry. The Console never reaches into your account and holds no credentials to it.

The resources AlphaAgent provisions and uses

When you deploy Studio (see Overview and architecture), it creates and then uses a standard set of AWS resources in your account:

ResourceWhat it isWhat it holds or does
VPC with private subnetsA network boundaryAll Studio compute runs inside it; outbound access is controlled
Application Load Balancer (ALB)The single HTTPS entry pointEvery request is authenticated at the load balancer before it reaches any service
Cognito user poolSign-in directoryFederated to your own identity provider over SAML; there is no self-signup
Studio application services (ECS Fargate)The running productThe agent, chat, connector, workflow, knowledge-base, code-execution, and notification capabilities
Per-environment code-execution Lambdasalphaagent-env-{environment_id} functionsWhere agent code actually runs, one function per execution environment
S3 workspaces bucketalphaagent-workspaces-{account}-{region}Per-session working files produced when agents run code
Other S3 bucketsUploads, results, and overflow storageDocument uploads, large workflow results, oversized message payloads
DynamoDB tablesThe operational data storesAgent and swarm definitions, conversations, runs, connector definitions, and the session-datasets table (see Datasets and data flow)
ElastiCache (Redis)A cacheSpeeds up configuration and conversation reads; not a system of record
Secrets ManagerThe credential storeConnector credentials, service configuration, and the license secret
Neo4j (self-hosted or external)A graph database in your accountStores the knowledge graphs built from your documents (see Knowledge graphs in depth)
Amazon BedrockThe model serviceRuns all AI inference, pinned to your residency zone

Neo4j stays in your account in either mode. Self-hosted runs single-node Neo4j Community as a Fargate service inside the Studio VPC, backed by encrypted multi-AZ EFS, and Studio reaches it internally at bolt://neo4j:7687. External points Studio at your own Neo4j over the network. AWS Bedrock is a managed AWS service that you enable model access for in your own account; Studio calls it but never routes inference outside your residency zone (see Data residency and security).

How an agent run executes against Bedrock

When a user sends a message to an agent, Studio resolves the agent's active configuration (its instructions, the data connectors it may use, the knowledge graph it is bound to, and the execution environment for code), then runs the agent against AWS Bedrock and streams the result back to the chat in real time.

The run is durable. Studio records each run and its event stream in DynamoDB so that a browser which disconnects mid-run can reconnect and replay what it missed, and so a long-running background run keeps going even after the user navigates away. Inference itself always goes to AWS Bedrock inside your residency zone — there are no calls to any third-party model API.

Express vs Deep Traversal

Studio offers two execution modes for a chat turn. The difference is behavioral — how much planning happens before the agent answers — not where anything runs. Both run entirely in your account against Bedrock.

ExpressDeep Traversal
BehaviorThe agent answers directly, streaming as it goesThe agent first produces a plan, then executes it as a multi-step graph
Knowledge graphNot usedUsed, and consulted first
ApprovalNone — the answer streams immediatelyThe plan is shown to the user and execution resumes only after the user approves it
Best forQuick questions and direct tasksComplex, multi-part research where you want to review the approach first

Express is the fast path: the agent goes straight to work. Deep Traversal is the deliberate path: the agent plans, pauses for your approval, then carries the plan out step by step, drawing on your knowledge graph. The user-facing experience of both modes is described in the Chat guide.

Where to go next