Tool Composition Patterns
Orchestrate multiple tools into sophisticated, powerful agent workflows
Your Progress
0 / 5 completedConditional Logic: Adaptive Tool Selection
Not every workflow is fixed. Sometimes you need to choose different tools based on runtime conditions—user permissions, data quality, resource availability, or previous results.
Conditional composition makes agents intelligent—they adapt their behavior based on context instead of blindly executing the same sequence every time.
Interactive: Conditional Tool Selection
Change user type to see how the agent adapts its tool choices
Select User Type:
Common Conditional Patterns
If-Then-Else
Choose between two tool paths based on condition
Pseudocode:
if (condition) { use_tool_A } else { use_tool_B }
Example: If premium user → advanced_search, else → basic_search
Switch/Case
Select from multiple tools based on categorical value
Pseudocode:
switch (type) { case A: tool1; case B: tool2; default: tool3 }
Example: Payment method: credit → stripe, paypal → paypal_api, crypto → blockchain
Guard Clauses
Skip tools if conditions aren't met
Pseudocode:
if (!precondition) return; run_tool()
Example: If no auth token → skip API call, return cached data
Fallback Chain
Try tools in sequence until one succeeds
Pseudocode:
try tool_A catch → try tool_B catch → use_default
Example: Try premium API → try free API → use cached data
What to Condition On
👤
User Context
→ Subscription tier
→ User location
→ Language preference
→ Device type
📊
Data Quality
→ Completeness
→ Freshness
→ Confidence score
→ Source reliability
⚙️
System State
→ API availability
→ Resource usage
→ Queue length
→ Time of day
📈
Previous Results
→ Tool success/failure
→ Result quality
→ Execution time
→ Error type
Best Practices for Conditional Logic
Make conditions explicit
Clear logic is easier to debug and maintain
✅ Do:
if (user.tier === "premium" && credits > 0)
❌ Avoid:
if (canAccess())
Provide default fallbacks
Prevents workflow failures from unexpected states
✅ Do:
switch (type) { ... default: use_safe_default }
❌ Avoid:
Unhandled switch cases
Log decision paths
Essential for understanding agent behavior
✅ Do:
log("Using premium_tool because: user_tier=premium")
❌ Avoid:
Silent decision making
Test all branches
Ensure every conditional path works
✅ Do:
Test: free, premium, enterprise, expired
❌ Avoid:
Only testing happy path