{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Real-time","type":"markdown"},"seo":{"title":"AI Skills for Real-Time Debugging","description":"Use Treasure AI skills to debug real-time activation failures, identity stitching issues, and journey execution problems.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ai-skills-for-real-time-debugging","__idx":0},"children":["AI Skills for Real-Time Debugging"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI Studio provides skills that generate diagnostic queries to help you quickly identify root causes of common real-time issues."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these skills when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["parent segment ID"]}," and need to investigate an issue."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need a quick read on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["activation failures"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["profile merges"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["stitching quality"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want a structured approach to diagnosing real-time problems."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Prerequisites"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/guide/td-skills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td-skills"]}]}," package to get started."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-skills","__idx":1},"children":["Available Skills"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following skills are available for real-time debugging:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Skill"},"children":["Skill"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What It Answers"},"children":["What It Answers"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Expected Output"},"children":["Expected Output"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Did the activation fire? Why did it fail?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fast summary of activation delivery errors and volume"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Did the event stitch to the right profile?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quick read on new, updated, and merged real-time profiles"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identify-top-key-values"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Are bad stitching values polluting the graph?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Surfaces dominant key values, including null or empty patterns that cause data quality issues"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-canonical-id-size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Are canonical groups becoming unusually large?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Helps spot possible over-stitching or \"mega-profile\" patterns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-ids-to-canonical-id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Is one ID mapping to multiple canonical IDs?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Helps detect inconsistent stitching and over-stitching cases"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt-journey-monitor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Is the journey running as expected? Where is it failing?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Journey execution monitoring and activation failure debugging"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"debugging-workflows","__idx":2},"children":["Debugging Workflows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the right skills based on the symptom you are investigating."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activation-not-firing","__idx":3},"children":["Activation Not Firing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a webhook, streaming egress, or downstream action did not execute as expected, start with these skills:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activations"]}]}," — Query activation logs for your parent segment to check whether the activation fired and identify delivery errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt-journey-monitor"]}]}," — If the activation is part of a journey, check whether the journey itself is executing correctly and where it might be failing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"missing-or-incorrect-profile-data","__idx":4},"children":["Missing or Incorrect Profile Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When personalization attributes are missing, incomplete, or returning unexpected values, the root cause is often related to identity resolution. Use these skills:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]}]}," — Check recent profile merges and stitching activity for your parent segment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identify-top-key-values"]}]}," — Inspect the distribution of stitching key values to find null, empty, or junk values that degrade data quality."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-canonical-id-size"]}]}," — Analyze canonical ID group sizes to detect over-stitching, where too many IDs collapse into a single profile."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-ids-to-canonical-id"]}]}," — Check whether a single ID maps to multiple canonical IDs, which indicates inconsistent stitching."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-prompts","__idx":5},"children":["Example Prompts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use a skill, provide it with your parent segment ID and the specific question you want to answer. The following examples use parent segment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["394649"]}," as a placeholder — replace it with your own."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activation-debugging","__idx":6},"children":["Activation debugging"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the activations skill to query activation logs for parent segment 394649.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identity-and-profile-debugging","__idx":7},"children":["Identity and profile debugging"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the identity skill to check recent profile merges for parent segment 394649.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the identify-top-key-values skill to debug stitching key distributions\nfor parent segment 394649.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"id-graph-analysis","__idx":8},"children":["ID graph analysis"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the id-graph-canonical-id-size skill to analyze canonical ID group sizes\nfor parent segment 394649.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Use the id-graph-ids-to-canonical-id skill to detect IDs mapping to multiple\ncanonical IDs.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":9},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before starting a debugging session, gather the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parent segment ID"]}," for the real-time configuration you are investigating."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A specific user or device ID"]}," that demonstrates the issue."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A recent time window"]}," when the issue occurred."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The symptom"]}," you are observing:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activation did not send"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Personalization returned empty or partial data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Profile stitched incorrectly"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Event counts or merges look suspicious"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then choose the smallest set of skills that match your symptom:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activation problem"]}," — Start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activations"]},", then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt-journey-monitor"]}," if the activation is journey-triggered."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity or merge problem"]}," — Start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Suspected junk IDs or over-stitching"]}," — Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identify-top-key-values"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-canonical-id-size"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id-graph-ids-to-canonical-id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Journey progression or delivery issue"]}," — Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt-journey-monitor"]},"."]}]}]},"headings":[{"value":"AI Skills for Real-Time Debugging","id":"ai-skills-for-real-time-debugging","depth":1},{"value":"Available Skills","id":"available-skills","depth":2},{"value":"Debugging Workflows","id":"debugging-workflows","depth":2},{"value":"Activation Not Firing","id":"activation-not-firing","depth":3},{"value":"Missing or Incorrect Profile Data","id":"missing-or-incorrect-profile-data","depth":3},{"value":"Example Prompts","id":"example-prompts","depth":2},{"value":"Activation debugging","id":"activation-debugging","depth":3},{"value":"Identity and profile debugging","id":"identity-and-profile-debugging","depth":3},{"value":"ID graph analysis","id":"id-graph-analysis","depth":3},{"value":"Best Practices","id":"best-practices","depth":2}],"frontmatter":{"seo":{"title":"AI Skills for Real-Time Debugging","description":"Use Treasure AI skills to debug real-time activation failures, identity stitching issues, and journey execution problems."}},"lastModified":"2026-05-14T21:23:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/real-time/real-time-ai-debugging-skills","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}