- The gap that exists when a foundation model must take real-world actions.
- What Bedrock Agents provide to bridge that gap.
- How your application interacts with Bedrock Agents.
- Expected results and a key takeaway.
Problem statement
Foundation models (for example Anthropic Claude, Meta Llama, or other large models) excel at generating text, images, or other modalities. However, they do not by themselves perform side-effecting operations—such as invoking external APIs, updating databases, or orchestrating multi-step processes. To accomplish those tasks today, you typically add custom orchestration code that:- Calls the model and inspects its output.
- Constructs API requests (URLs, headers, payloads).
- Sends requests to external services.
- Parses responses and feeds results back into the model for further reasoning.

What Bedrock Agents provide
A Bedrock Agent centralizes orchestration. Your application sends a single request to the agent runtime specifying:- Which foundation model(s) to use for reasoning.
- Which agent configuration to invoke (an agent is a configured entity with instructions and access to tools).
- The user task or instruction the agent should complete.
- One or more foundation models (the reasoning engine).
- Instructions that define the agent’s behavior and goals.
- Access to tools and APIs, organized into action groups.
- Builds a plan.
- Selects appropriate tools.
- Executes calls to external services.
- Parses responses and iterates—feeding intermediate results back into the model—until the instruction is satisfied.

Key components of a Bedrock Agent
- Agent orchestrator: managed orchestration logic inside the agent runtime that coordinates planning, decision-making, and tool usage. This is provided by the service—you do not implement it yourself.
- Foundation model: the model the agent uses for reasoning and deciding when/how to call tools.
- Instructions: static guidance configured at agent creation (for example, “You are a customer support assistant; be concise and professional”) that shape behavior before any user prompt.
- Action groups: named collections of external services and tools (APIs, databases, etc.) the agent may call to fulfill tasks.

Agent workflow and your application
A typical end-to-end flow:- The end user interacts with your application (web UI, chat, voice, etc.).
- Your application calls the Bedrock Agent Runtime (this is the agent runtime endpoint, not the standard Bedrock model endpoint).
- The app invokes the agent using the
InvokeAgentmethod and supplies the user’s prompt/instruction. - The agent uses its configured foundation model, action groups (tools/APIs), and optional knowledge base to plan and execute steps.
- The agent returns a final, consolidated response to your application, which renders it to the user.
getOrder(), updateOrder(), or updateInventory()—the agent may call several actions and iterate with the foundation model before returning a final answer.

How your application invokes an agent
- Do not call the foundation model directly if you require tool use or orchestration.
- Call the Bedrock Agent Runtime and use the
InvokeAgentAPI method, sending the prompt/instruction to the configured agent. - The agent runtime mediates access to the foundation model, action groups, and an optional knowledge base (automated RAG) to provide context during reasoning.
Invoke agents via the agent runtime using
InvokeAgent. Let the agent manage tool selection, API calls, and iteration—don’t call the foundation model directly when you need orchestration.
Summary and takeaway
Bedrock Agents remove the burden of writing and maintaining custom orchestration code by combining a foundation model with explicit instructions and configured tools (action groups). Your application invokes the agent via the agent runtime (usingInvokeAgent), and the agent determines how best to use available models, tools, and knowledge bases to complete the assigned task—returning a single, consolidated response to your application.
Next lesson: building and configuring an agent—defining instructions, registering action groups, and exposing the external APIs and data sources that the agent can call.