Skip to main content
Space Bob is the creative specialist. It analyzes ad creative performance, compares variants, generates ad copy, manages creative reports, and connects to Creative Studio for visual exports.

​
Capabilities

Pull top-performing creatives ranked by spend, ROAS, CPA, or CTR. Group by creative asset, ad name, headline, copy text, or landing page. Results render as visual cards in the chat with images and key metrics.Tools used: get_creative_performance, get_creative_insights
Compare creative variants side by side. Filter to specific ad names or groups and see how they stack up across all metrics. Useful for evaluating test results and deciding what to scale.Tools used: analyze_creative_ab_test
When you share an image of a creative, Space Bob analyzes it visually:
  • Visual hook — what grabs attention in the first 1-3 seconds
  • Emotional appeal — what emotion the creative triggers
  • CTA clarity — whether the call-to-action is clear and compelling
  • Audience signals — who the creative targets and how
  • Product presentation — how the product/service is showcased
  • Design elements — color psychology, typography, composition
Every observation is connected to the performance metrics.
Generate high-performing ad copy using the Cassidy AI writing assistant. Provide an ad name, performance context, and desired tone — Space Bob sends it to Cassidy and returns polished copy with references.Tools used: write_ad_copy
Requires Cassidy AI configuration (assistant ID and API key) in ChatBot Settings.
Save, list, and reload creative analyses as named reports. All filters, date ranges, and groupings are preserved. Loading a saved report re-runs the analysis with the exact saved parameters.Tools used: list_creative_reports, load_creative_report, save_creative_report
After pulling creative performance data, Space Bob includes an Open in Creative Studio link. This navigates to the full Creative Reporting page with filters pre-applied and auto-opens the Creative Studio dialog for:
  • Exporting cards as PNG, JPEG, or animated GIF
  • Customizing grid layout, colors, and typography
  • Selecting which metrics to highlight on each card
  • Adjusting scale and background for presentations
Tools used: creative_studio_link (included in all creative tool responses)
When you ask Space Bob to analyze creatives, it walks you through setup with clickable buttons:
  1. Which platform? — Facebook Ads, Google Ads, TikTok Ads
  2. What time period? — 7, 14, 30, or 90 days
  3. How to group? — Ad Name, Creative, Headline, Copy, Landing Page
  4. What to focus on? — ROAS, Spend, CPA, CTR
  5. Confirm and run
Tools used: gather_creative_params
Generate charts from creative data — compare spend across creatives, visualize ROAS distribution, etc.Tools used: create_visualization
Backed by the Creative Analytics pipeline, Bob has 8 deep-dive tools that operate on the persisted analysis layer — vision tags, embeddings, exhaustion snapshots, named concept clusters, and the daily Creative Brief.Use these when the user asks “what should I make next?”, “is my creative tired?”, “find ads like this one”, or “what concepts am I testing?”Tools used: find_similar_creatives, search_creatives_semantic, analyze_hook_exhaustion, creative_diversity_score, creative_concept_clusters, compare_creatives, top_creatives_by_archetype, recommend_next_creative_brief

​
Creative deep-dive tools

These 8 tools sit on top of the Creative Analytics pipeline — every ingested creative is auto-analyzed (multi-frame vision + Whisper transcript), tagged across an 8-category taxonomy, embedded into pgvector, and rolled into hook-exhaustion snapshots and named concept clusters.

​
When to call which

1

User asks "what should I make next?"

Call recommend_next_creative_brief first — that’s the canonical answer. It already aggregates exhaustion + diversity + top performers into a structured recommendation.Optionally enrich with analyze_hook_exhaustion + creative_concept_clusters if the user wants the supporting context.
2

User asks "is my creative tired?"

Call analyze_hook_exhaustion and surface any is_exhausted=True rows with their recommended_alternatives. If everything is healthy, call creative_diversity_score — concentration without exhaustion is still a signal.
3

User shares a creative_id and asks for context

Call find_similar_creatives with kind='analysis_text' (concept similarity). Optionally also kind='image' if the user wants to find visual twins specifically.
4

User asks for free-text search

Call search_creatives_semantic with the user’s phrase. Default kind='analysis_text' for “ads about X”; switch to kind='image' for “ads that look like Y”.
5

User wants to see the concept landscape

Call creative_concept_clusters. Returns named clusters with spend + ROAS. If empty, the response includes a hint to refresh — pass it through.

​
Tenant scoping

Every tool reads from RunnableConfig.client_id (propagated from the JWT) and resolves accessible clients via shared.auth.get_accessible_client_ids. Cross-tenant queries are impossible — the source-creative lookup, the kNN query, and any aggregation all filter on client_id__in=accessible.

​
Tool reference

​
Creative analysis tools

​
Creative report tools

​
Copywriting tools

​
Visualization tools

​
Creative insight rules

Space Bob follows specific rules when analyzing creatives:
1

Connect visuals to metrics

Every visual observation is tied to performance data. “The bold red CTA button likely drives the 2.3% CTR, significantly above the 1.1% average.”
2

Explain why top performers work

Don’t just rank — explain what creative attributes drive performance.
3

Suggest A/B tests

Recommend test ideas based on what’s working. “Consider testing a version with a lifestyle image vs. this product-only shot.”
4

Flag creative fatigue

If a high-spend creative has declining CTR, call it out as potential fatigue.
5

Compare creative approaches

Proactively compare formats. “Your video ads average 1.8x ROAS vs. 1.2x for static images.”

​
Available metrics

Creative analysis includes these performance metrics:

​
Example prompts