The data Pearl reads and writes, the concepts it works with, and how its agents decide.
This section explains the concepts behind Pearl: the data it uses, what it produces, and how its agents decide.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pearl","colors":{"primary":"#7071FF","light":"#8485FF","dark":"#514BAB"},"favicon":"https://mintcdn.com/pearl-c33a713b/lQibWyCdk2YmP92O/images/favicon.svg?fit=max\u0026auto=format\u0026n=lQibWyCdk2YmP92O\u0026q=85\u0026s=ec0f79c432d3d4a40368713d3aa17e64","background":{"color":{"light":"#FCFCFC","dark":"#242629"}},"fonts":{"family":"Inter"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pearl-c33a713b","hasAudioNarration":false,"actualSubdomain":"pearl-c33a713b","customDomains":["docs.heypearl.ai"],"gitSource":{"type":"github","owner":"heypearl-ai","repo":"pearl","deployBranch":"docs-prod","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":"","_id":"6af61730791617e36b708461"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af6ebb1e766df7985e5d1e4","clientVersion":"0.0.4131","searchFilterCounts":[{"language":"default","tag":"Build on Pearl","count":1},{"language":"default","tag":"Configuration","count":1},{"language":"default","tag":"Get started","count":1},{"language":"default","tag":"How Pearl works","count":1},{"language":"default","tag":"Integrations","count":1},{"language":"default","tag":"Release notes","count":1},{"language":"default","tag":"Troubleshooting","count":1},{"language":"default","tag":"Use Pearl","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* vietnamese */\n@font-face {\n font-family: 'Cal Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/calsans/v2/fdN99sWUv3gWqXxqqRBTtFs04A.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Cal Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/calsans/v2/fdN99sWUv3gWqXxqqRBStFs04A.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Cal Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/calsans/v2/fdN99sWUv3gWqXxqqRBctFs.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n#page-title{font-family:\"Cal Sans\", sans-serif;font-weight:600;letter-spacing:1px}"}],"page":{"pagePath":"how-pearl-works","slug":"/how-pearl-works","pageMetadata":{"title":"How Pearl works","description":"The data Pearl reads and writes, the concepts it works with, and how its agents decide.","href":"/how-pearl-works/index"},"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: \"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`This section explains the concepts behind Pearl: the data it uses, what it produces, and how its agents decide.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"How Pearl works","description":"The data Pearl reads and writes, the concepts it works with, and how its agents decide.","href":"/how-pearl-works/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"pearl-c33a713b","siteName":"Pearl","title":"How Pearl works - Pearl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T19:45:27.423Z","originalFileLocation":"how-pearl-works/index.md"},"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=\"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pearl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How Pearl works - Pearl\">\u003cmeta data-mint-head property=\"og:description\" content=\"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pearl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.heypearl.ai/how-pearl-works\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pearl-c33a713b.mintlify.site/_mintlify/api/og/v2?division=How+Pearl+works\u0026amp;title=How+Pearl+works\u0026amp;description=The+data+Pearl+reads+and+writes%2C+the+concepts+it+works+with%2C+and+how+its+agents+decide.\u0026amp;theme=d6f9ee39561446959c578762\u0026amp;signature=10f33a84a116041903cc0f82abe6e5728f9baa899e369df711038dfbdf767952\">\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=\"How Pearl works - Pearl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pearl-c33a713b.mintlify.site/_mintlify/api/og/v2?division=How+Pearl+works\u0026amp;title=How+Pearl+works\u0026amp;description=The+data+Pearl+reads+and+writes%2C+the+concepts+it+works+with%2C+and+how+its+agents+decide.\u0026amp;theme=d6f9ee39561446959c578762\u0026amp;signature=10f33a84a116041903cc0f82abe6e5728f9baa899e369df711038dfbdf767952\">\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/pearl-c33a713b/_kPdvRbnJ8b3S47O/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pearl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7071FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.heypearl.ai/how-pearl-works\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/how-pearl-works.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.heypearl.ai/#organization\",\"name\":\"Pearl\",\"url\":\"https://docs.heypearl.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.heypearl.ai#website\",\"name\":\"Pearl\",\"url\":\"https://docs.heypearl.ai\",\"publisher\":{\"@id\":\"https://docs.heypearl.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.heypearl.ai/how-pearl-works#webpage\",\"url\":\"https://docs.heypearl.ai/how-pearl-works\",\"name\":\"How Pearl works\",\"description\":\"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\",\"dateModified\":\"2026-11-12T19:45:27.423Z\",\"isPartOf\":{\"@id\":\"https://docs.heypearl.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.heypearl.ai/how-pearl-works#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.heypearl.ai/how-pearl-works#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Pearl\",\"item\":\"https://docs.heypearl.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How Pearl works\",\"item\":\"https://docs.heypearl.ai/how-pearl-works\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.heypearl.ai/how-pearl-works#article\",\"headline\":\"How Pearl works\",\"name\":\"How Pearl works\",\"description\":\"The data Pearl reads and writes, the concepts it works with, and how its agents decide.\",\"url\":\"https://docs.heypearl.ai/how-pearl-works\",\"mainEntityOfPage\":{\"@id\":\"https://docs.heypearl.ai/how-pearl-works#webpage\"},\"dateModified\":\"2026-11-12T19:45:27.423Z\",\"publisher\":{\"@id\":\"https://docs.heypearl.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.heypearl.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pearl\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pearl\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/how-pearl-works.md","siteName":"Pearl","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Get started","description":"What Pearl is, how to set up your organization, and what to do on your first day.","href":"/get-started/index"}]},{"group":"How Pearl works","pages":[{"title":"How Pearl works","href":"/how-pearl-works/index"}]},{"group":"Use Pearl","pages":[{"title":"Use Pearl","description":"The daily routine with Pearl, from actions and meetings to chat, Slack and Teams.","href":"/use-pearl/index"}]},{"group":"Configuration","pages":[{"title":"Configuration","href":"/configuration/index"}]},{"group":"Build on Pearl","pages":[{"title":"Build on Pearl","href":"/build-on-pearl/index"}]},{"group":"Integrations","pages":[{"title":"Integrations","href":"/integrations/index"}]},{"group":"Troubleshooting","pages":[{"title":"Troubleshooting","href":"/troubleshooting/index"}]},{"group":"Release notes","pages":[{"title":"Release notes","href":"/release-notes/index"}]}]},"basePath":"","title":"How Pearl works - Pearl","buildId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","deploymentId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","dynamics":[],"chunks":[]}