Main
A clean way to adopt the SDK:
- Start with a single agent and one or two small tools (I/O, search, DB query) so you can observe the loop.
- Add hooks for logging/tracing early—multi-agent systems are hard to debug without visibility.
- When you need more structure, move to Graph/Swarm patterns from the README and keep each agent’s responsibility narrow.
- Treat model provider switches as configuration: Bedrock for AWS-native deployments, OpenAI for quick iteration, and pin model IDs for reproducibility.
The SDK’s value is “explicit wiring” — tools and orchestration are code, not hidden prompts.
FAQ
Q: Do I have to use Bedrock? A: No. Bedrock is the default, but the README includes an OpenAI provider example.
Q: What Node version do I need? A: The README calls for Node.js 20+.
Q: How do I keep runs reproducible? A: Pin model IDs and keep tool interfaces stable; log tool inputs/outputs via hooks early.