When auto-fill goes wrong, here is how to read the run trace.
Every property agent run is recorded with the trigger kind, the status, what the AI produced, the value that was written, the prior cell value, the duration, and any error message. Open a run from the agent panel to see the full trace, or right-click the cell in a table view and choose View AI runs for this cell to see the history for that exact record and property.
The run trace shows what the AI produced and the value that was written, not the full prompt that was sent. Use what the AI produced to see what it actually said when the written value looks unexpected.
Not every “no write” is a failure. With only-if-empty mode, a run succeeds with a “Skipped: property already has a value” note. With required properties configured, a run succeeds with a “Skipped: required property is empty” note (and no AI call) when a prerequisite property is empty. These are intentional skips, not errors.
If you change the prompt and want to re-evaluate, run the agent across a bounded set of records. Don’t run unbounded bulk reruns. The cost adds up quickly, and Custral processes large runs in batches.
Property agent runs use the same AI models as chat. Each run records how long it took, and your total workspace spend is visible in the Usage block.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Custral Docs","colors":{"primary":"#5E7CFF","light":"#5E7CFF","dark":"#5E7CFF"},"logo":{"light":"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=50b063929ddff7335cc4db8352ae694a","dark":"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/dark.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=4025f09bcbe60697aef60a5bb3f849f0"},"favicon":"https://mintcdn.com/custral/NGCdls_pt-1YDx5S/favicon.svg?fit=max\u0026auto=format\u0026n=NGCdls_pt-1YDx5S\u0026q=85\u0026s=3a0ce3e846a625e7bc5e70aafe82cffa","navbar":{"links":[{"href":"https://custral.com","label":"Get Started"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.custral.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/custral"},"links":[{"header":"Resources","items":[{"label":"Status Page","href":"https://status.custral.com"},{"label":"Blog","href":"https://blog.custral.com"}]},{"header":"Support","items":[{"label":"Get support","href":"/support"},{"label":"hello@custral.com","href":"mailto:hello@custral.com"}]}]},"search":{"prompt":"Search Custral docs..."},"seo":{"metatags":{"og:image":"/images/og-docs.png","og:image:width":"2400","og:image:height":"1260","twitter:card":"summary_large_image","twitter:image":"/images/og-docs.png"}},"banner":{"content":"New: Focus Mode sorts your inbox, records open in a peek, a rebuilt mobile app, and a daily brief. [See what's new](/product/updates)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"custral","hasAudioNarration":false,"actualSubdomain":"custral","customDomains":["docs.custral.com"],"gitSource":{"type":"github","owner":"custral","repo":"custral-mono","deployBranch":"master","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ade1ad5cc4d8fc7f4e59b84","collectionId":"a149e1a3-54d3-4769-89c2-5031be517fb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ade1ad5cc4d8fc7f4e59b84"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae601488b8badc2e429ed75","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Documentation","count":317},{"language":"default","tag":"Developer References","count":108},{"language":"default","tag":"Communications","count":66},{"language":"default","tag":"Data Structures","count":60},{"language":"default","tag":"API Reference","count":56},{"language":"default","tag":"Endpoints","count":49},{"language":"default","tag":"Blocks","count":46},{"language":"default","tag":"Properties","count":40},{"language":"default","tag":"Getting Started","count":37},{"language":"default","tag":"Embedded Components","count":35}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".cxh{--brand:#5E7CFF;--brand-ink:#3f57e6;--brand-soft:#eef1ff;--g1:#5E7CFF;--g2:#8b5cf6;--g3:#ff5f7a;--bg:#ffffff;--bg2:#fbfbfe;--card:#ffffff;--panel:#f6f7fb;--border:#e8e9f3;--border-soft:#f0f1f8;--text:#191b26;--muted:#5b5e73;--faint:#9a9db2;--code-bg:#0f1119;--code-text:#e7e9f5;--a1:#5E7CFF;--a2:#8b5cf6;--a3:#ff5f7a;--a4:#10b981;--k:#c4b5fd;--s:#86efac;--f:#93c5fd;--c:#6b7089;--p:#f0a4b8;--shadow-sm:0 1px 2px rgba(20,22,50,.05),0 3px 10px rgba(20,22,50,.05);--shadow-lg:0 2px 6px rgba(20,22,50,.06),0 20px 50px rgba(30,34,80,.13);--dot:rgba(94,124,255,.14);--radius:14px;--mono:ui-monospace,SFMono-Regular,\"SF Mono\",Menlo,Consolas,monospace;color:var(--text)}:root[data-theme=dark] .cxh,html.dark .cxh,html[data-theme=dark] .cxh{--brand:#7d90ff;--brand-ink:#a6b2ff;--brand-soft:#191c2e;--bg:#0c0d14;--bg2:#0a0b11;--card:#14161f;--panel:#111219;--border:#242738;--border-soft:#1b1e29;--text:#e9eaf2;--muted:#a0a3b8;--faint:#6f7288;--code-bg:#0a0b12;--code-text:#e7e9f5;--shadow-sm:0 1px 2px rgba(0,0,0,.4),0 3px 10px rgba(0,0,0,.35);--shadow-lg:0 2px 6px rgba(0,0,0,.5),0 24px 60px rgba(0,0,0,.6);--dot:rgba(125,144,255,.14)}.cxh *{box-sizing:border-box}.cxh a{color:inherit;text-decoration:none}.cxh .wrap{max-width:1120px;margin:0 auto;padding-inline:28px}.cxh .fullbleed{width:100%}.cxh .hero{position:relative;overflow:hidden;border-bottom:1px solid var(--border-soft);background:var(--bg)}.cxh .hero-bg,.cxh .hero-dots{position:absolute;inset:0;z-index:0}.cxh .hero-bg{background:radial-gradient(680px 360px at 80% -10%,color-mix(in srgb,var(--brand) 22%,transparent),transparent 70%),radial-gradient(560px 300px at 6% 0%,color-mix(in srgb,var(--g2) 13%,transparent),transparent 70%)}.cxh .hero-dots{opacity:.9;background-image:radial-gradient(var(--dot) 1px,transparent 1.4px);background-size:22px 22px;mask-image:linear-gradient(180deg,#000,transparent 80%);-webkit-mask-image:linear-gradient(180deg,#000,transparent 80%)}.cxh .hero-in{position:relative;z-index:1;display:grid;grid-template-columns:1fr 1fr;gap:48px;align-items:center;padding:66px 0 60px}.cxh .eyebrow{font-size:12px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--brand-ink)}.cxh h1{font-size:46px;line-height:1.04;letter-spacing:-.03em;margin:14px 0 0;font-weight:750;text-wrap:balance;color:var(--text)}.cxh .lead{font-size:17.5px;line-height:1.55;color:var(--muted);margin:18px 0 0;max-width:34ch}.cxh .cta{display:flex;align-items:center;gap:12px;margin-top:28px;flex-wrap:wrap}.cxh .btn{display:inline-flex;align-items:center;gap:7px;height:40px;padding:0 18px;border-radius:9px;font-size:14px;font-weight:600;border:1px solid transparent;cursor:pointer}.cxh .btn.primary{background:var(--brand);color:#fff;box-shadow:0 1px 2px rgba(63,87,230,.35)}.cxh .btn.ghost{background:0 0;color:var(--text);border-color:var(--border)}.cxh .btn.ghost:hover{border-color:color-mix(in srgb,var(--brand) 45%,var(--border))}.cxh .cta .clink{font-size:14px;font-weight:600;color:var(--brand-ink);display:inline-flex;align-items:center;gap:6px}.cxh .herovis{position:relative;padding:6px 8px 26px 0}.cxh .appwin{position:relative;z-index:1;background:var(--card);border:1px solid var(--border);border-radius:14px;box-shadow:var(--shadow-lg);overflow:hidden;transform:rotate(-.6deg)}.cxh .winbar{display:flex;align-items:center;gap:7px;padding:9px 13px;border-bottom:1px solid var(--border-soft);background:var(--panel)}.cxh .tl{width:10px;height:10px;border-radius:50%}.cxh .tl.r{background:#ff5f57}.cxh .tl.y{background:#febc2e}.cxh .tl.g{background:#28c840}.cxh .winbar .wt{margin-left:8px;font-size:12px;font-weight:600;color:var(--muted)}.cxh .winbar .wpill{margin-left:auto;font-size:10.5px;color:var(--brand-ink);background:var(--brand-soft);border-radius:20px;padding:2px 8px;font-weight:600}.cxh .winbody{display:flex;min-height:214px}.cxh .side,.cxh .tcol ul{display:flex;flex-direction:column;gap:2px}.cxh .side{flex:0 0 120px;background:var(--bg2);border-right:1px solid var(--border-soft);padding:10px 8px}.cxh .snav{display:flex;align-items:center;gap:8px;font-size:12px;color:var(--muted);padding:6px 8px;border-radius:7px;font-weight:500}.cxh .snav .g{width:15px;text-align:center;opacity:.85}.cxh .snav.on{background:var(--brand-soft);color:var(--brand-ink);font-weight:600}.cxh .main{flex:1;padding:6px 4px}.cxh .conv{display:flex;align-items:center;gap:10px;padding:9px 12px;border-radius:9px}.cxh .conv+.conv{border-top:1px solid var(--border-soft)}.cxh .conv .av{flex:0 0 auto;width:28px;height:28px;border-radius:50%;display:grid;place-items:center;color:#fff;font-size:11px;font-weight:700}.cxh .conv .av.a1{background:var(--a1)}.cxh .conv .av.a2{background:var(--a2)}.cxh .conv .av.a3{background:var(--a3)}.cxh .conv .av.a4{background:var(--a4)}.cxh .conv .ct{min-width:0;flex:1}.cxh .conv .cn{font-size:12.5px;font-weight:600;display:flex;align-items:center;gap:6px;color:var(--text)}.cxh .conv .ch{font-size:9.5px;font-weight:700;letter-spacing:.04em;text-transform:uppercase;color:var(--faint);border:1px solid var(--border);border-radius:5px;padding:0 4px}.cxh .conv .cs{display:block;font-size:11.5px;color:var(--muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-top:1px}.cxh .conv .cd{flex:0 0 auto;font-size:10.5px;color:var(--faint)}.cxh .conv .un{width:7px;height:7px;border-radius:50%;background:var(--brand);flex:0 0 auto}.cxh .codecard{position:absolute;z-index:2;right:-6px;bottom:-6px;width:290px;border-radius:12px;background:var(--code-bg);box-shadow:var(--shadow-lg);border:1px solid rgba(255,255,255,.07);overflow:hidden;transform:rotate(2.2deg)}.cxh .codebar{display:flex;align-items:center;gap:6px;padding:8px 11px;border-bottom:1px solid rgba(255,255,255,.07)}.cxh .codebar .tl{width:9px;height:9px}.cxh .codebar .name{margin-left:6px;font:11px/1 var(--mono);color:#8b8fa8}.cxh pre.code{margin:0;white-space:pre;text-align:left;padding:12px 13px 14px;font:11px/1.65 var(--mono);color:var(--code-text);overflow:hidden;background:0 0;border:0}.cxh .k{color:var(--k)}.cxh .s{color:var(--s)}.cxh .f{color:var(--f)}.cxh .c{color:var(--c)}.cxh .p{color:var(--p)}.cxh section{padding-block:56px}.cxh .pathsec{padding-block:48px 8px}.cxh .tasksec{padding-top:40px}.cxh .sechead{display:flex;align-items:baseline;justify-content:space-between;gap:16px;margin-bottom:26px}.cxh .path h4,.cxh h2{font-size:22px;letter-spacing:-.02em;font-weight:700;color:var(--text)}.cxh .path p,.cxh .sechead .sub{font-size:13.5px;color:var(--faint)}.cxh .paths{display:grid;grid-template-columns:1fr 1fr;gap:16px}.cxh .path{display:flex;gap:14px;align-items:flex-start;background:var(--card);border:1px solid var(--border);border-radius:var(--radius);padding:18px 20px;box-shadow:var(--shadow-sm)}.cxh .path:hover{border-color:color-mix(in srgb,var(--brand) 45%,var(--border))}.cxh .path .pic,.cxh .tcol h3 .ic{background:var(--brand-soft);display:grid;place-items:center}.cxh .path .pic{flex:0 0 auto;width:38px;height:38px;border-radius:10px;color:var(--brand-ink);font-size:17px}.cxh .path h4{margin:2px 0 4px;font-size:15.5px;font-weight:650;letter-spacing:-.01em}.cxh .path p{margin:0;color:var(--muted);line-height:1.5}.cxh .path .go{margin-top:10px;font-size:13px;font-weight:600;display:inline-flex;gap:6px}.cxh .tasks{display:grid;grid-template-columns:repeat(3,1fr);gap:34px}.cxh .tcol h3,.cxh .tcol li a{display:flex;align-items:center}.cxh .tcol h3{font-size:12.5px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;color:var(--faint);margin:0 0 14px;gap:8px}.cxh .tcol h3 .ic{width:22px;height:22px;border-radius:6px;font-size:11px}.cxh .tcol ul{list-style:none;margin:0;padding:0}.cxh .tcol li,.cxh h2{margin:0}.cxh .tcol li a{gap:9px;padding:7px 9px;margin:0 -9px;border-radius:8px;font-size:14px;color:var(--text);font-weight:450}.cxh .dgroup h3 .chip,.cxh .path .go,.cxh .tcol h3 .ic,.cxh .tcol li a:hover{color:var(--brand-ink)}.cxh .tcol li a .arw{color:var(--faint);font-size:12px;margin-left:auto;opacity:0;transition:.15s}.cxh .tcol li a:hover .arw{opacity:1}.cxh .dirwrap{background:var(--bg2);border-top:1px solid var(--border-soft);border-bottom:1px solid var(--border-soft)}.cxh .dir{display:grid;grid-template-columns:repeat(2,1fr);gap:14px 40px}.cxh .dgroup{padding:4px 0}.cxh .dgroup h3{gap:10px;font-size:14px;font-weight:700;margin:0 0 12px;letter-spacing:-.01em}.cxh .dgroup h3 .chip{width:26px;height:26px;border-radius:8px;display:grid;place-items:center;font-size:13px;background:var(--brand-soft)}.cxh .drow{display:flex;gap:12px;padding:9px 10px;margin:0 -10px;border-radius:10px;align-items:flex-start}.cxh .drow:hover,.cxh .tcol li a:hover{background:var(--panel)}.cxh .drow .di,.cxh .helprow a{font-size:13px;color:var(--muted)}.cxh .drow .di{flex:0 0 auto;width:30px;height:30px;border-radius:8px;border:1px solid var(--border);background:var(--card);display:grid;place-items:center;margin-top:1px}.cxh .drow .dt{font-size:14px;font-weight:600;letter-spacing:-.01em;color:var(--text)}.cxh .drow .dd{font-size:12.5px;color:var(--muted);line-height:1.45;margin-top:1px}.cxh .dgroup h3,.cxh .helprow{display:flex;align-items:center}.cxh .helprow{flex-wrap:wrap;gap:14px 22px;padding:26px 0 8px}.cxh .helprow a{font-weight:500}.cxh .dgroup h3,.cxh .helprow a:hover{color:var(--text)}.cxh .helprow .sep{color:var(--faint)}.cxh .helprow .lead-in{font-size:13px;color:var(--faint);margin-right:6px}.cxh .supportband{background:var(--bg2);border-top:1px solid var(--border);border-bottom:1px solid var(--border);margin-top:40px}.cxh .supportrow{display:grid;grid-template-columns:1fr auto;gap:32px;align-items:center;padding:34px 0}.cxh .supportrow h3{font-size:19px;font-weight:650;letter-spacing:-.01em;margin:0 0 6px}.cxh .supportrow p{font-size:14px;color:var(--muted);margin:0 0 12px;max-width:44ch}.cxh .supportcontacts{display:flex;gap:10px;flex-wrap:wrap}.cxh .scontact{display:flex;align-items:center;gap:11px;padding:12px 16px;border:1px solid var(--border);border-radius:11px;background:var(--bg);min-width:236px;transition:border-color .15s ease}.cxh .scontact:hover{border-color:var(--brand)}.cxh .scontact .si{width:30px;height:30px;flex:none;display:flex;align-items:center;justify-content:center;border-radius:8px;background:var(--brand-soft);color:var(--brand-ink);font-size:14px}.cxh .scontact .sl{display:block;font-size:11.5px;color:var(--faint);letter-spacing:.01em}.cxh .scontact .sv{display:block;font-size:14px;font-weight:600;color:var(--text)}@media (max-width:920px){.cxh .hero-in{grid-template-columns:1fr;gap:44px;padding:48px 0 56px}.cxh .herovis{padding:0 8px 20px 0;max-width:520px}.cxh .tasks{gap:26px}.cxh .paths,.cxh .tasks{grid-template-columns:1fr}.cxh .dir,.cxh .supportrow{grid-template-columns:1fr;gap:8px 0}.cxh h1{font-size:36px}.cxh .supportrow{gap:22px}.cxh .scontact{min-width:0;flex:1 1 100%}}.nav-tag-pill-text[data-nav-tag=OBJECT]{color:rgb(82 82 91);background:rgb(113 113 122/.14);font-size:.5rem;white-space:nowrap}.dark .nav-tag-pill-text[data-nav-tag=OBJECT]{color:rgb(161 161 170);background:rgb(161 161 170/.16)}div:has(>.nav-tag-pill>[data-nav-tag=OBJECT]){order:-1;width:2rem;margin-right:6px;overflow:visible}.update-container>div:first-child>div.break-words{display:none}.card-group .card>img.object-cover{aspect-ratio:16/10;height:auto;object-position:top center}"}],"page":{"pagePath":"ai/property-agents/troubleshooting","slug":"/ai/property-agents/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":"When auto-fill goes wrong, here is how to read the run trace.","icon":"stethoscope","href":"/ai/property-agents/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"When auto-fill goes wrong, here is how to read the run trace.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const Shot=({id,caption,gif=false,phone=false})=>{const base=`/images/screens/${id}`;const size={width:`100%`,maxWidth:phone?320:`100%`,height:`auto`};const img=`mx-auto rounded-xl border border-gray-950/10 dark:border-white/10`;return _jsxs(`figure`,{className:`mint-my-6`,\"data-shot\":id,children:[gif?_jsx(`img`,{src:`${base}.gif`,alt:caption,className:`mint-mx-auto mint-rounded-xl mint-border mint-border-gray-950/10 dark:mint-border-white/10`,style:size}):_jsxs(_Fragment,{children:[_jsx(`img`,{src:`${base}-light.png`,alt:caption,className:`${`mint-mx-auto mint-rounded-xl mint-border mint-border-gray-950/10 dark:mint-border-white/10`} mint-block dark:mint-hidden`,style:size}),_jsx(`img`,{src:`${base}-dark.png`,alt:caption,className:`${`mint-mx-auto mint-rounded-xl mint-border mint-border-gray-950/10 dark:mint-border-white/10`} mint-hidden dark:mint-block`,style:size})]}),caption\u0026\u0026_jsx(`figcaption`,{className:`mint-mt-2 mint-text-center mint-text-sm mint-text-gray-500 dark:mint-text-gray-400`,children:caption})]})};function _createMdxContent(props){const _components={p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every property agent run is recorded with the trigger kind, the status, what the AI produced, the value that was written, the prior cell value, the duration, and any error message. Open a run from the agent panel to see the full trace, or right-click the cell in a table view and choose `,_jsx(_components.strong,{children:`View AI runs for this cell`}),` to see the history for that exact record and property.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The run trace shows what the AI `,_jsx(_components.strong,{children:`produced`}),` and the value that was `,_jsx(_components.strong,{children:`written`}),`, not the full prompt that was sent. Use what the AI produced to see what it actually said when the written value looks unexpected.`]})}),`\n`,_jsx(_MdxComponentBoundary,{name:`Shot`,children:_jsx(Shot,{id:`ai/property-agent-runs`,caption:`Recent runs: click one to see what the AI produced.`})}),`\n`,_jsx(Heading,{level:`2`,id:`common-failures`,children:`Common failures`}),`\n`,_jsx(_components.p,{children:`A run is either successful or failed; failures carry a descriptive message.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Error that the AI’s output didn’t match the property type`}),_jsx(_components.td,{children:`The AI returned text that doesn’t fit the property type.`}),_jsx(_components.td,{children:`Tighten the prompt; for a select, list the valid options in the prompt.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Error that no value could be determined`}),_jsx(_components.td,{children:`The record (and the web, if enabled) didn’t contain enough to answer.`}),_jsx(_components.td,{children:`Add more context to the record, refine the instructions, or enable the web source.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Error that the AI declined to answer`}),_jsx(_components.td,{children:`The model refused.`}),_jsx(_components.td,{children:`Reword the prompt with more context; enable web research if appropriate.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Error about an image`}),_jsx(_components.td,{children:`An image auto-fill couldn’t find, validate, download, or attach a suitable image.`}),_jsx(_components.td,{children:`Refine the search hint in the instructions; the error message says which stage failed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cell updated but the value is wrong`}),_jsx(_components.td,{children:`The value passed validation but was plausible-but-wrong (rare).`}),_jsx(_components.td,{children:`Add validation on the property; consider a Classify kind with explicit options, or tighten the prompt.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`a-run-that-didn’t-write-a-value`,children:`A run that didn’t write a value`}),`\n`,_jsxs(_components.p,{children:[`Not every “no write” is a failure. With `,_jsx(_components.strong,{children:`only-if-empty`}),` mode, a run succeeds with a “Skipped: property already has a value” note. With `,_jsx(_components.strong,{children:`required properties`}),` configured, a run succeeds with a “Skipped: required property is empty” note (and no AI call) when a prerequisite property is empty. These are intentional skips, not errors.`]}),`\n`,_jsx(Heading,{level:`2`,id:`bulk-reruns`,children:`Bulk reruns`}),`\n`,_jsx(_components.p,{children:`If you change the prompt and want to re-evaluate, run the agent across a bounded set of records. Don’t run unbounded bulk reruns. The cost adds up quickly, and Custral processes large runs in batches.`}),`\n`,_jsx(Heading,{level:`2`,id:`cost`,children:`Cost`}),`\n`,_jsx(_components.p,{children:`Property agent runs use the same AI models as chat. Each run records how long it took, and your total workspace spend is visible in the Usage block.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{Shot,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":"When auto-fill goes wrong, here is how to read the run trace.","icon":"stethoscope","href":"/ai/property-agents/troubleshooting"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[140,1170,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Common failures","slug":"common-failures","depth":2,"children":[]},{"title":"A run that didn’t write a value","slug":"a-run-that-didn’t-write-a-value","depth":2,"children":[]},{"title":"Bulk reruns","slug":"bulk-reruns","depth":2,"children":[]},{"title":"Cost","slug":"cost","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/custral/17880bab12267dd5/index.js"],"dynamicCss":".mint-mx-auto {\n margin-left: auto;\n margin-right: auto\n}\n.mint-my-6 {\n margin-top: 1.5rem;\n margin-bottom: 1.5rem\n}\n.mint-mt-2 {\n margin-top: 0.5rem\n}\n.mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}\n.mint-border {\n border-width: 1px\n}\n.mint-border-gray-950\\/10 {\n border-color: rgb(3 7 18 / 0.1)\n}\n.mint-text-center {\n text-align: center\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-text-gray-500 {\n --tw-text-opacity: 1;\n color: rgb(107 114 128 / var(--tw-text-opacity, 1))\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}\n.dark\\:mint-border-white\\/10:is(.dark *) {\n border-color: rgb(255 255 255 / 0.1)\n}\n.dark\\:mint-text-gray-400:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(156 163 175 / var(--tw-text-opacity, 1))\n}","subdomain":"custral","siteName":"Custral Docs","title":"Troubleshooting - Custral Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T21:39:48.187Z","originalFileLocation":"ai/property-agents/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"When auto-fill goes wrong, here is how to read the run trace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Custral Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - Custral Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"When auto-fill goes wrong, here is how to read the run trace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Custral Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.custral.com/ai/property-agents/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://custral.mintlify.app/images/og-docs.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - Custral Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"When auto-fill goes wrong, here is how to read the run trace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://custral.mintlify.app/images/og-docs.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/custral/zNw7VJKFFusEr-3b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Custral Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5E7CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.custral.com/ai/property-agents/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai/property-agents/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.custral.com/#organization\",\"name\":\"Custral Docs\",\"url\":\"https://docs.custral.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/custral/9h_119tROzHTKUiS/assets/logos/light.svg?fit=max\u0026auto=format\u0026n=9h_119tROzHTKUiS\u0026q=85\u0026s=50b063929ddff7335cc4db8352ae694a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.custral.com#website\",\"name\":\"Custral Docs\",\"url\":\"https://docs.custral.com\",\"publisher\":{\"@id\":\"https://docs.custral.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.custral.com/ai/property-agents/troubleshooting#webpage\",\"url\":\"https://docs.custral.com/ai/property-agents/troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"When auto-fill goes wrong, here is how to read the run trace.\",\"dateModified\":\"2026-10-19T21:39:48.187Z\",\"isPartOf\":{\"@id\":\"https://docs.custral.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.custral.com/ai/property-agents/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.custral.com/ai/property-agents/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Property Auto-Fill Agents\",\"item\":\"https://docs.custral.com/ai/property-agents/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshooting\",\"item\":\"https://docs.custral.com/ai/property-agents/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.custral.com/ai/property-agents/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"When auto-fill goes wrong, here is how to read the run trace.\",\"url\":\"https://docs.custral.com/ai/property-agents/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.custral.com/ai/property-agents/troubleshooting#webpage\"},\"image\":\"https://docs.custral.com/images/og-docs.png\",\"dateModified\":\"2026-10-19T21:39:48.187Z\",\"publisher\":{\"@id\":\"https://docs.custral.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.custral.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Custral Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Custral Docs","nav":{"global":null,"products":[{"product":"Documentation","icon":"book-open","tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/start/introduction"}]},{"tab":"AI","groups":[{"group":"Getting started","pages":[{"title":"AI","sidebarTitle":"Overview","icon":"sparkles","mode":"wide","href":"/ai/overview"},{"title":"Get started with AI","icon":"rocket","href":"/ai/getting-started"},{"title":"Models \u0026 Providers","sidebarTitle":"Overview","icon":"microchip-ai","href":"/ai/models/overview"},{"title":"Best Practices","sidebarTitle":"Overview","icon":"lightbulb","href":"/ai/best-practices/overview"}]},{"group":"Stella","pages":[{"title":"What Stella can do","sidebarTitle":"Capability library","icon":"sparkles","href":"/ai/tools/library"},{"title":"Tools","sidebarTitle":"Overview","icon":"screwdriver-wrench","href":"/ai/tools/overview"},{"title":"Dashboard preview","icon":"chart-mixed","href":"/ai/dashboard-preview"},{"title":"Schema preview","icon":"table-columns","href":"/ai/schema-preview"},{"title":"Inspect the page","sidebarTitle":"Inspect the page","icon":"crosshairs","mode":"wide","href":"/ai/inspect"},{"title":"Permissions","icon":"shield-check","href":"/ai/permissions"}]},{"group":"Chat Agents","pages":[{"title":"Chat Agents","sidebarTitle":"Overview","icon":"comments","href":"/ai/chat-agents/overview"},{"title":"Instructions","icon":"pen","href":"/ai/chat-agents/instructions"},{"title":"Scoping","icon":"filter","href":"/ai/chat-agents/scoping"},{"title":"Tool Gating","icon":"screwdriver-wrench","href":"/ai/chat-agents/tools"}]},{"group":"Routines","pages":[{"title":"Routines","sidebarTitle":"Overview","icon":"repeat","href":"/ai/routines/overview"}]},{"group":"Property Auto-Fill Agents","pages":[{"title":"Property Auto-Fill Agents","sidebarTitle":"Overview","icon":"wand-magic-sparkles","href":"/ai/property-agents/overview"},{"title":"Triggers","icon":"bolt","href":"/ai/property-agents/triggers"},{"title":"Sources","description":"What data the agent reads before writing a value.","icon":"database","href":"/ai/property-agents/sources"},{"title":"Troubleshooting","icon":"stethoscope","href":"/ai/property-agents/troubleshooting"}]},{"group":"Extend the AI","pages":[{"title":"Modules","description":"Install starter kits (bundles of AI agents, commands, and rules) into your workspace in one click.","icon":"puzzle-piece","href":"/ai/modules"},{"title":"Rules \u0026 Skills","icon":"book-open","href":"/ai/rules-and-skills"},{"title":"Provider Tools","icon":"plug","href":"/ai/provider-tools"},{"title":"Connectors","icon":"plug","href":"/ai/mcp-connections"},{"title":"Use Custral in Claude or ChatGPT","sidebarTitle":"Claude \u0026 ChatGPT","icon":"comments","href":"/ai/use-in-claude-chatgpt"}]},{"group":"Recommendations","pages":[{"title":"Recommendations","sidebarTitle":"Recommendations","icon":"lightbulb","mode":"wide","href":"/ai/recommendations"},{"title":"Daily Brief","icon":"sun","href":"/ai/daily-brief"},{"title":"Living notes","icon":"wand-magic-sparkles","href":"/ai/living-notes"}]}]},{"tab":"Communications","pages":[{"title":"Communications","href":"/comms/overview"}]},{"tab":"Data Structures","pages":[{"title":"Data Structures","href":"/data/overview"}]},{"tab":"Surfaces","pages":[{"title":"Surfaces","href":"/surfaces/overview"}]},{"tab":"Blocks","pages":[{"title":"Blocks","href":"/blocks/overview"}]},{"tab":"Team","pages":[{"title":"Team","href":"/team/overview"}]},{"tab":"Automations","pages":[{"title":"Automations","href":"/automation/overview"}]},{"tab":"Business Intelligence","pages":[{"title":"Business Intelligence","href":"/bi/overview"}]},{"tab":"Revenue","pages":[{"title":"Revenue","href":"/revenue/overview"}]}]},{"product":"Developer References","icon":"square-terminal","pages":[{"title":"Developer References","href":"/dev/overview"}]},{"product":"Product Updates","icon":"crystal-ball","pages":[{"title":"Product Updates","href":"/product/overview"}]},{"product":"Integrations","icon":"flask-gear","pages":[{"title":"Integrations","href":"/integrations/overview"}]}]},"basePath":"","title":"Troubleshooting - Custral Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["10e4515597"],"chunks":["BannerMarkdown-CXEEkV6J.js","dist-lvhuD9Du.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D1Z-ELXV.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}