fetch
ChatGPTFetch one canonical Clozd knowledge record by ID after search returns it, such as deal:<uuid>, response:<uuid>, quote:<uuid>, theme:<uuid>, or competitor:<id>. Use when ChatGPT needs enough detail to cite, summarize, or continue analysis on a specific Clozd record. Returns a compact payload without raw transcripts, debug fields, emails, or internal implementation fields.
fetch
ChatGPTFetch one canonical Clozd knowledge record by ID after search returns it, such as deal:<uuid>, response:<uuid>, quote:<uuid>, theme:<uuid>, or competitor:<id>. Use when ChatGPT needs enough detail to cite, summarize, or continue analysis on a specific Clozd record. Returns a compact payload without raw transcripts, debug fields, emails, or internal implementation fields.
get_awe_deals
ChatGPTRetrieve deals flagged for action: At-Risk (likely to churn), Win Back (lost but recoverable), or Expansion (upsell opportunity). Use when the user asks "Which deals are at risk?" or "Show me win-back opportunities" or "How many expansion deals do we have?" Pass flag to filter to one type, or omit for all flagged deals. Returns deal list with flag type and optional counts per flag.
get_awe_deals
ChatGPTRetrieve deals flagged for action: At-Risk (likely to churn), Win Back (lost but recoverable), or Expansion (upsell opportunity). Use when the user asks "Which deals are at risk?" or "Show me win-back opportunities" or "How many expansion deals do we have?" Pass flag to filter to one type, or omit for all flagged deals. Returns deal list with flag type and optional counts per flag.
get_competitor_sentiment_drivers
ChatGPTGet the decision drivers filtered by sentiment (positive or negative) in deals involving a specific competitor. Use sentiment "positive" when the user asks "Why do we beat Competitor X?" or "What are our strengths against Competitor X?" Use sentiment "negative" when the user asks "Why do we lose to Competitor X?" or "What are our weaknesses against Competitor X?" Returns: an array of { driverName, driverId, sentimentCount, totalMentions } for the specified competitor and sentiment.
get_competitor_sentiment_drivers
ChatGPTGet the decision drivers filtered by sentiment (positive or negative) in deals involving a specific competitor. Use sentiment "positive" when the user asks "Why do we beat Competitor X?" or "What are our strengths against Competitor X?" Use sentiment "negative" when the user asks "Why do we lose to Competitor X?" or "What are our weaknesses against Competitor X?" Returns: an array of { driverName, driverId, sentimentCount, totalMentions } for the specified competitor and sentiment.
get_competitors
ChatGPTList competitors encountered across deals in a program, along with encounter counts and win/loss counts. Use when the user asks which competitors show up most often, or how often the team wins or loses against specific competitors. Returns: an array of { competitorName, encounterCount, winCount, lossCount }.
get_competitors
ChatGPTList competitors encountered across deals in a program, along with encounter counts and win/loss counts. Use when the user asks which competitors show up most often, or how often the team wins or loses against specific competitors. Returns: an array of { competitorName, encounterCount, winCount, lossCount }.
get_deals
ChatGPTRetrieve a paginated list of deals. Each deal includes: name, outcome (win/loss), amount, business type (new/existing), business type detail, industry, closed date, published date, product, headcount, sales rep, region, and segment. Use when the user wants to browse, search, or export deal records. Example queries: "Show me all deals we lost last quarter" or "List deals over $100K in the healthcare industry."
get_deals
ChatGPTRetrieve a paginated list of deals. Each deal includes: name, outcome (win/loss), amount, business type (new/existing), business type detail, industry, closed date, published date, product, headcount, sales rep, region, and segment. Use when the user wants to browse, search, or export deal records. Example queries: "Show me all deals we lost last quarter" or "List deals over $100K in the healthcare industry."
get_decision_driver_categories
ChatGPTList decision driver categories (high-level groupings of drivers such as "Product", "Pricing", "Support") with aggregated sentiment distribution across a four-point scale (strong negative, negative, positive, strong positive). Use when the user asks broad thematic questions like "Which category of feedback is most negative?" Returns: an array of categories, each with name, sentimentBreakdown, and totalMentions.
get_decision_driver_categories
ChatGPTList decision driver categories (high-level groupings of drivers such as "Product", "Pricing", "Support") with aggregated sentiment distribution across a four-point scale (strong negative, negative, positive, strong positive). Use when the user asks broad thematic questions like "Which category of feedback is most negative?" Returns: an array of categories, each with name, sentimentBreakdown, and totalMentions.
get_decision_driver_category_counts
ChatGPTCount how many decision driver mentions fall into each category. Use when the user asks "How many driver mentions are in the Pricing category?" or wants a category-level frequency breakdown. Returns: an array of { categoryName, driverCount } sorted by driverCount descending.
get_decision_driver_category_counts
ChatGPTCount how many decision driver mentions fall into each category. Use when the user asks "How many driver mentions are in the Pricing category?" or wants a category-level frequency breakdown. Returns: an array of { categoryName, driverCount } sorted by driverCount descending.
get_decision_drivers
ChatGPTList individual decision drivers with aggregated sentiment distribution across a four-point scale (strong negative, negative, positive, strong positive). Use when the user asks which specific drivers are mentioned most often or most negatively, "What are the most common decision drivers?", "Which drivers come up most often?", or "What is the sentiment breakdown per driver?" Returns an array of drivers with driverName, totalMentions, and a sentimentBreakdown object containing strongNegative, negative, positive, and strongPositive counts. Sorted by totalMentions descending. Pass limit to return only the top N drivers. Supports filtering by outcome, competitor, date range, and other shared filters.
get_decision_drivers
ChatGPTList individual decision drivers with aggregated sentiment distribution across a four-point scale (strong negative, negative, positive, strong positive). Use when the user asks which specific drivers are mentioned most often or most negatively, "What are the most common decision drivers?", "Which drivers come up most often?", or "What is the sentiment breakdown per driver?" Returns an array of drivers with driverName, totalMentions, and a sentimentBreakdown object containing strongNegative, negative, positive, and strongPositive counts. Sorted by totalMentions descending. Pass limit to return only the top N drivers. Supports filtering by outcome, competitor, date range, and other shared filters.
get_driver_quotes
ChatGPTRetrieve verbatim quotes from interview or survey responses linked to a specific decision driver or theme. Each quote includes the deal it came from plus respondent context such as title, channel, and publish date. Use when the user needs direct evidence, for example "Show me quotes about pricing" or "What did customers say about our support?" Provide either driverName for a case-insensitive text match or driverId for an exact UUID match.
get_driver_quotes
ChatGPTRetrieve verbatim quotes from interview or survey responses linked to a specific decision driver or theme. Each quote includes the deal it came from plus respondent context such as title, channel, and publish date. Use when the user needs direct evidence, for example "Show me quotes about pricing" or "What did customers say about our support?" Provide either driverName for a case-insensitive text match or driverId for an exact UUID match.
get_gong_driver_categories
ChatGPTList Gong-identified driver categories (high-level groupings) with aggregated sentiment distribution. Use when the user asks broad questions about Gong call themes at the category level, e.g. "What are the main themes in our Gong calls?" Returns: an array of categories, each with name, sentimentBreakdown, and totalMentions.
get_gong_driver_categories
ChatGPTList Gong-identified driver categories (high-level groupings) with aggregated sentiment distribution. Use when the user asks broad questions about Gong call themes at the category level, e.g. "What are the main themes in our Gong calls?" Returns: an array of categories, each with name, sentimentBreakdown, and totalMentions.
get_gong_driver_category_counts
ChatGPTCount how many Gong-identified driver mentions fall into each category. Use when the user wants a category-level frequency breakdown of Gong call insights. Returns: an array of { categoryName, driverCount } sorted by driverCount descending.
get_gong_driver_category_counts
ChatGPTCount how many Gong-identified driver mentions fall into each category. Use when the user wants a category-level frequency breakdown of Gong call insights. Returns: an array of { categoryName, driverCount } sorted by driverCount descending.
get_gong_driver_counts
ChatGPTRank Gong-identified drivers by frequency of mention across filtered deals. Use when the user asks "What Gong drivers come up most often?" or "Which Gong themes are most common?" Returns an array of drivers with driverName and count, sorted by count descending. Pass limit to return only the top N Gong drivers.
get_gong_driver_counts
ChatGPTRank Gong-identified drivers by frequency of mention across filtered deals. Use when the user asks "What Gong drivers come up most often?" or "Which Gong themes are most common?" Returns an array of drivers with driverName and count, sorted by count descending. Pass limit to return only the top N Gong drivers.
get_gong_driver_overlap
ChatGPTCompare Gong-identified drivers against Clozd interview-identified drivers to find agreement and gaps. Use when the user asks "How well do Gong insights align with our interview data?" or "Where do Gong and Clozd disagree?" Returns: { overlappingDealCount, nonOverlappingDealCount, totalDeals }.
get_gong_driver_overlap
ChatGPTCompare Gong-identified drivers against Clozd interview-identified drivers to find agreement and gaps. Use when the user asks "How well do Gong insights align with our interview data?" or "Where do Gong and Clozd disagree?" Returns: { overlappingDealCount, nonOverlappingDealCount, totalDeals }.
get_gong_drivers
ChatGPTList potential decision drivers automatically identified from Gong sales call recordings, with sentiment distribution. These are AI-detected signals from sales conversations, distinct from Clozd interview-based drivers. Use when the user asks about Gong call insights, e.g. "What themes are coming up in our sales calls?" Returns: an array of drivers, each with name, sentimentBreakdown, and totalMentions.
get_gong_drivers
ChatGPTList potential decision drivers automatically identified from Gong sales call recordings, with sentiment distribution. These are AI-detected signals from sales conversations, distinct from Clozd interview-based drivers. Use when the user asks about Gong call insights, e.g. "What themes are coming up in our sales calls?" Returns: an array of drivers, each with name, sentimentBreakdown, and totalMentions.
get_programs
ChatGPTList the Clozd programs available to the authenticated user. Call this first to discover programId values for later program-scoped tools.
get_programs
ChatGPTList the Clozd programs available to the authenticated user. Call this first to discover programId values for later program-scoped tools.
get_response_summaries
ChatGPTRetrieve AI-generated response summaries for published win-loss feedback. Pass responseId to fetch one response summary directly, or use shared deal and response filters to browse summaries in bulk with pagination.
get_response_summaries
ChatGPTRetrieve AI-generated response summaries for published win-loss feedback. Pass responseId to fetch one response summary directly, or use shared deal and response filters to browse summaries in bulk with pagination.
get_responses
ChatGPTRetrieve a paginated list of win-loss responses (interviews and surveys). Each response includes the linked deal, outcome, respondent role, channel, and publish date so the LLM can find specific feedback submissions without loading full transcripts.
get_responses
ChatGPTRetrieve a paginated list of win-loss responses (interviews and surveys). Each response includes the linked deal, outcome, respondent role, channel, and publish date so the LLM can find specific feedback submissions without loading full transcripts.
get_tags
ChatGPTList tags applied to deals with their usage counts. Tags are user-defined labels (e.g. "churn risk", "enterprise", "product gap") that categorize deals for filtering and analysis. Use when the user asks for a summary of tags, "What tags do we have?", "Which tags appear most often?", "Give me a breakdown of our tags", "Summarize deals by tag", or "How are deals tagged?" — even if they use words like "summary", "breakdown", or "overview". Do NOT use get_decision_drivers for tag-related questions. Set includeDeals=true to also return the deal IDs associated with each tag. Returns a paginated list of { tagName, count, dealIds? }.
get_tags
ChatGPTList tags applied to deals with their usage counts. Tags are user-defined labels (e.g. "churn risk", "enterprise", "product gap") that categorize deals for filtering and analysis. Use when the user asks for a summary of tags, "What tags do we have?", "Which tags appear most often?", "Give me a breakdown of our tags", "Summarize deals by tag", or "How are deals tagged?" — even if they use words like "summary", "breakdown", or "overview". Do NOT use get_decision_drivers for tag-related questions. Set includeDeals=true to also return the deal IDs associated with each tag. Returns a paginated list of { tagName, count, dealIds? }.
get_transcripts
ChatGPTRetrieve full-text transcripts of win-loss interviews or surveys. Returns the complete conversation content. WARNING: Transcripts can be very long. Prefer get_response_summaries for quick insights or get_driver_quotes for targeted evidence. Use when the user explicitly requests raw transcripts, e.g. "Show me the full transcript for deal X." Pass responseId for a single transcript, or use filters with pagination for bulk retrieval.
get_transcripts
ChatGPTRetrieve full-text transcripts of win-loss interviews or surveys. Returns the complete conversation content. WARNING: Transcripts can be very long. Prefer get_response_summaries for quick insights or get_driver_quotes for targeted evidence. Use when the user explicitly requests raw transcripts, e.g. "Show me the full transcript for deal X." Pass responseId for a single transcript, or use filters with pagination for bulk retrieval.
get_win_rates
ChatGPTCalculate win/loss rates for deals in a program. Returns the percentage of deals won vs. lost, with optional breakdown by a single dimension (e.g. industry, product, sales rep). Use when the user asks questions like "What is our win rate?" or "Which industry has the highest win rate?" Returns: overall winRate, lossRate, totalDeals, and a breakdown array when groupBy is specified.
get_win_rates
ChatGPTCalculate win/loss rates for deals in a program. Returns the percentage of deals won vs. lost, with optional breakdown by a single dimension (e.g. industry, product, sales rep). Use when the user asks questions like "What is our win rate?" or "Which industry has the highest win rate?" Returns: overall winRate, lossRate, totalDeals, and a breakdown array when groupBy is specified.
get_workflow_deal_participants
ChatGPTRetrieve participants for a specific deal in a workflow, including each participant's approval status (pending/approved/rejected), outreach status, and who approved or rejected them. Returns the deal's current workflow stage and a list of participants with their individual status details. Use after get_workflow_deals to drill into participant-level detail for a specific deal. Example queries: "Who are the participants for this deal?" or "Has anyone approved this deal yet?"
get_workflow_deal_participants
ChatGPTRetrieve participants for a specific deal in a workflow, including each participant's approval status (pending/approved/rejected), outreach status, and who approved or rejected them. Returns the deal's current workflow stage and a list of participants with their individual status details. Use after get_workflow_deals to drill into participant-level detail for a specific deal. Example queries: "Who are the participants for this deal?" or "Has anyone approved this deal yet?"
get_workflow_deals
ChatGPTRetrieve a paginated list of deals in a workflow with their stage, status, and participant count. Each deal includes: name, outcome, amount, sales rep, stage (needs_attention, needs_approval, ready_for_distribution, in_progress, completed), and a participant_count. To get full participant details (approval status, who approved/rejected), use the get_workflow_deal_participants tool with a specific dealId. Example queries: "Show me deals needing approval in this workflow" or "Which deals are ready for distribution?"
get_workflow_deals
ChatGPTRetrieve a paginated list of deals in a workflow with their stage, status, and participant count. Each deal includes: name, outcome, amount, sales rep, stage (needs_attention, needs_approval, ready_for_distribution, in_progress, completed), and a participant_count. To get full participant details (approval status, who approved/rejected), use the get_workflow_deal_participants tool with a specific dealId. Example queries: "Show me deals needing approval in this workflow" or "Which deals are ready for distribution?"
get_workflows
ChatGPTRetrieve all workflows in a program with their configuration, filter rules, settings, and deal/participant counts. Each workflow includes: name, status, feedback channel, interview type, deal rules, participant rules, outreach settings, contributor settings, and counts by stage (needs_attention, needs_approval, ready_for_distribution, in_progress, completed). Use when the user wants to understand the workflow pipeline for a program. Example queries: "Show me all active workflows" or "What are the outreach settings for our buyer workflows?"
get_workflows
ChatGPTRetrieve all workflows in a program with their configuration, filter rules, settings, and deal/participant counts. Each workflow includes: name, status, feedback channel, interview type, deal rules, participant rules, outreach settings, contributor settings, and counts by stage (needs_attention, needs_approval, ready_for_distribution, in_progress, completed). Use when the user wants to understand the workflow pipeline for a program. Example queries: "Show me all active workflows" or "What are the outreach settings for our buyer workflows?"
search
ChatGPTSearch Clozd win-loss knowledge for relevant deals, feedback summaries, themes, competitors, and quotes using a natural-language query plus optional filters. Use this first when the user asks to find, explore, cite, compare, or summarize Clozd feedback but does not already have a specific record ID. Returns compact canonical record IDs that can be passed to fetch for more detail.
search
ChatGPTSearch Clozd win-loss knowledge for relevant deals, feedback summaries, themes, competitors, and quotes using a natural-language query plus optional filters. Use this first when the user asks to find, explore, cite, compare, or summarize Clozd feedback but does not already have a specific record ID. Returns compact canonical record IDs that can be passed to fetch for more detail.
