Agents docs

src/content/docs/docs/agentic-patterns.mdx

@@ -10,6 +10,12 @@ supportedLanguages:
 import Lang from '../../../components/Lang.astro';
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
+:::tip[Looking for the Agents API?]
+This page covers low-level composition patterns using flows and `generate()`.
+For the higher-level managed agent primitive with built-in session management,
+persistence, and streaming, see [Agents](/docs/agents).
+:::
+
 Building powerful AI systems involves more than just calling a model; it requires structuring interactions in a way that balances reliability with flexibility. This is the core idea behind the **agentic scale**.
 
 At one end of the scale, you have **Workflows**: structured, predictable sequences of tasks. They are highly reliable but less flexible. At the other end, you have **Agents**: autonomous systems that can reason, plan, and use tools to handle complex, unpredictable tasks. They are highly flexible but can be less reliable.