BuyerTwin

Applies a previously proposed buyer knowledge update through canonical mutation services with policy, idempotency, and concurrency enforcement.

apply_buyer_knowledge_update

ONLY for one specific buyer/persona: ask how that single buyer would think, react, answer, or respond. Do not use for cross-buyer aggregation, multi-buyer comparison, or workspace-wide summaries (including pains/triggers/factors/motivations/trends/context). Use get_buyer_pains, get_buying_triggers, get_buying_factors, get_buyer_motivations, get_buyer_trends, and get_buyer_context for workspace-level retrieval.

ask_buyer

Returns detailed BuyerTwin intelligence for one buyer/persona.

get_buyer

Use when the user asks which channels are effective or appropriate for reaching one or more buyers. Returns canonical reach-channel intelligence for either a specific buyer or all eligible buyers in the connected workspace.

get_buyer_channels

Use when the user asks for broader background or context across buyers, including responsibilities, influencers, software, alternatives considered, demographics, role background, personality/style, or operating environment. Returns broader contextual intelligence for all eligible buyers in the connected workspace.

get_buyer_context

Use when the user asks about buyer-specific knowledge learned beyond the standard profile, such as workflows, use cases, objections, terminology, buyer language, industry nuance, or decision dynamics. Can filter by buyer and insight type.

get_buyer_insights

Use when the user asks what motivates, drives, or influences desired outcomes across multiple buyers. Returns motivations for all eligible buyers in the connected workspace.

get_buyer_motivations

Use when the user asks about pains, challenges, problems, frustrations, or consequences across multiple buyers or the workspace. Returns pains and challenges for all eligible buyers in the connected BuyerTwin workspace, preserving buyer identity, segment, rank, description, confidence, and source context.

get_buyer_pains

Use when the user asks where buyers get information, what sources they trust, or where they learn and research. Returns canonical reach-source intelligence for either one buyer or all eligible buyers in the connected workspace.

get_buyer_sources

Use when the user asks about trends, changes, pressures, or external forces affecting multiple buyers. Returns trends affecting all eligible buyers in the connected workspace.

get_buyer_trends