Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.
Purpose
This guide covers the recommended setup for teams moving from build to production on Affinda Extract - how to structure workspaces, manage model memory, and handle changes safely without disrupting live processing.
These are recommendations, not hard requirements. Adapt the structure to fit your team size, governance model, and rollout cadence.
Recommended workspace structure
We recommend separating your organization into three workspaces, each with a clear purpose. Keeping them separate makes it easy to control access, isolate change, and keep production predictable.
1
Training workspace
The source of truth for what the model has learned. All model memory documents live here.
All confirmed model memory documents stored here
Annotations updated here when fields or behavior change
New document variations added here first
Access restricted to configuration owners
2
Dev & Test workspace
A staging environment for validating changes before they reach production. Also used for UAT.
Document types configured in Training are linked here
Integration testing space
No independent model memory; inherits the Model memory that lives in Train config
Safe to experiment and break things here
3
Production workspace
Live document processing only. No training activity happens here.
Model memory toggle turned off
Document types promoted here only after testing
All documents processed via API from here
No direct schema edits — go through Training first
Access control: keeping workspaces separate lets you control who sees what. Only configuration owners need access to Training. Your operations team works in Production. Dev/Test is for internal QA and integration testing.
Use “Duplicate Document type” to easily set up Test and Production workspaces from your Training workspace.
Making changes whilst in production
Once your workflow is live in production, you may still need to update your document types or workflow settings from time to time. Identify the type of change you want to make, then follow the recommended approach below.Document types are shared across workspaces, so any change to a document type’s fields or descriptions applies immediately in every workspace that uses it, including Production.
Edits can’t be undone. Changes to fields and descriptions save immediately and there is no version history. Record the current settings before you make a change so you can revert if needed.
Duplicating a document type. When you duplicate a document type, you can copy up to 50 of the original’s model memory documents into a workspace you choose. This lets you test changes or edit annotations without starting from scratch.
Scenario A — New document variation
The model is seeing a new version or variation of a document type already set up in the platform. It may not be performing well due to no closely matching example in the model’s model memory set.Approach: Add to model memory → Training workspace
1
Upload to Training
Upload the new variation to the Training workspace.
2
Annotate and confirm
Annotate all fields correctly and confirm the document as model memory.
3
Remove outdated examples
Remove model memory documents for variations that are no longer relevant.
4
No deployment needed
Performance improves in production automatically — no deployment step required.
Adding a new variation to a model’s Model Memory can be done safely without pausing production. Only newly processed documents that are more similar to the new variation than others in your model memory set will be impacted.
Keep the model memory set small and curated, for example 10 to 15 documents per document type. A smaller set is easier to review and keep accurate.
Scenario B — Field descriptions, new fields or post-processors
Adding a field, editing a field description, or changing a post-processor.
Option 1: Edit in place (low-risk changes)
Approach: Edit in place → Training
1
Edit the schema in Training
Edit the schema directly in the Training workspace.
2
Re-predict and reconfirm
Re-predict the new or changed field on the model memory document, then reconfirm it.
3
Takes effect immediately
Changes take effect in production straight away.
Check first: confirm that the change won’t break or affect any downstream integrations before proceeding.
Option 2: Test on a copy (recommended when the impact is uncertain)
1
Duplicate with copied model memory
Duplicate the document type and copy the original’s model memory documents into the Training workspace.
2
Make the change in Dev & Test
Add the copy to the Dev & Test workspace and make your change on it. For a new field, annotate it on the copied documents.
3
Test directly on the copy
Upload test documents directly to the copy, not to the workspace, so they aren’t classified to the original. Check the results.
4
Apply to the original
Make the same change to the original document type, including annotating any new field on its model memory documents.
5
Delete the copy
Delete the copy and its copied documents from the Settings tab of the document type editor.
Scenario C — Significant schema change
Groups, nesting, a field changing from a single value to multiple values, or anything that requires integration retesting.Approach: Duplicate → Dev/Test → Production
1
Leave production untouched
Leave the existing production document type in place while you build the new version.
2
Duplicate and copy model memory
Duplicate the document type and choose to copy the original’s model memory documents (up to 50) into the Training workspace.
3
Update annotations
Make the schema change on the duplicate, then update the annotations on the copied documents in Training to match the new schema. Add new examples if needed.
4
Test in Dev/Test
Link the duplicate to the Dev/Test workspace to test the integration flow and make adjustments.
5
Validate end-to-end
Validate the full API payload end-to-end against the new schema.
6
Promote to Production
Once sign-off is complete, unlink the old version from production and link the new one.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Affinda Extract Documentation","description":"Affinda Extract is a document AI platform that turns unstructured documents into structured, validated data through extraction, classification, splitting, and human review. Guides, API reference, and configuration playbooks for building and integrating Affinda models.","colors":{"primary":"#1F3339","light":"#A6FFFB","dark":"#A6FFFB"},"logo":{"light":"https://mintcdn.com/affinda-44/nvZZjc-QOoHXzSQ7/images/affindaextract-inkwell.png?fit=max\u0026auto=format\u0026n=nvZZjc-QOoHXzSQ7\u0026q=85\u0026s=a3e52ff1e274ac5509589a6350b41496","dark":"https://mintcdn.com/affinda-44/lcBcXTOY4DEPcniI/images/affindaextract-greenmist.png?fit=max\u0026auto=format\u0026n=lcBcXTOY4DEPcniI\u0026q=85\u0026s=318f55893ae70c89849919adbbc1a545","href":"https://www.affinda.com/"},"favicon":"https://mintcdn.com/affinda-44/zzz2NA-YwjYcDdgi/Affinda_GreenMist_inkwell_Favicon.png?fit=max\u0026auto=format\u0026n=zzz2NA-YwjYcDdgi\u0026q=85\u0026s=c83f557178ec0b196bef5bafec9b9faf","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"],"prefill":false}},"appearance":{"default":"system","strict":false},"background":{"decoration":"gradient","color":{"light":"#FFF9F0","dark":"#102A2F"}},"navbar":{"links":[{"href":"https://www.affinda.com/pricing-plans","label":"Pricing"},{"href":"https://trust.affinda.com/","label":"Security"},{"href":"https://www.affinda.com/contact","label":"Contact"},{"href":"/support","label":"Support"}],"primary":{"type":"button","label":"Log in","href":"https://app.affinda.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/affinda","youtube":"https://www.youtube.com/@affinda","github":"https://github.com/affinda"}},"seo":{"metatags":{"og:image":"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/68ae96fe8f3fdbbe0ae04c73_Affinda%20Open%20Graph%20image%20for%20website%20previews.png","og:site_name":"Affinda","twitter:site":"@affinda"}},"fonts":{"heading":{"family":"NeuSans","weight":500,"source":"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/685b584938c8018fa3d2e9da_NeuSans-Bold.woff2","format":"woff2"},"body":{"family":"NeuSans","weight":400,"source":"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/685b5849e08b8110997b8e4f_NeuSans-Regular.woff2","format":"woff2"}},"integrations":{"gtm":{"tagId":"GTM-NCW6M2B"}},"banner":{"content":"New to resume parsing? Start with the [Resume Parser console](https://resume-parser.affinda.com/). (Existing resume parsing integrations continue to be supported by Affinda Extract.)","color":{"light":"#102A2F","dark":"#102A2F"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"affinda-44","hasAudioNarration":false,"actualSubdomain":"affinda-44","customDomains":["docs.affinda.com"],"gitSource":{"type":"github","owner":"affinda","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe91b1cc20f084f3641cde","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Endpoints","count":108},{"language":"default","tag":"Deprecated Versions","count":45},{"language":"default","tag":"v2 Endpoints (Legacy)","count":45},{"language":"default","tag":"Configuration Guide","count":26},{"language":"default","tag":"Deprecated End Points","count":25},{"language":"default","tag":"Search \u0026 Match","count":24},{"language":"default","tag":"Extract Handbook","count":13},{"language":"default","tag":"Additional Resources","count":10},{"language":"default","tag":"Data Sources","count":10}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@affinda.com","showHelpButton":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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark{--tw-prose-body: #FFF9F0;--tw-prose-headings: #FFFFFF;--tw-prose-bullets: #FFFFFF}html.dark .mdx-content{color:#FFF9F0}span.text-white.z-10{color:#000000!important}#navbar-primary-cta,#navbar-primary-cta *,a[href=\"https://app.affinda.com\"],a[href=\"https://app.affinda.com\"] *,#navbar a[href*=\"app.affinda.com\"],#navbar a[href*=\"app.affinda.com\"] *{color:#000000!important}"}]}
{"page":{"pagePath":"handbook/production-best-practices","slug":"/handbook/production-best-practices","pageMetadata":{"title":"Setting up and managing Affinda in production","description":"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.","sidebarTitle":"Production Best Practices","href":"/handbook/production-best-practices"},"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: \"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\"\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];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Info,OptimizedImage,Step,Steps,Tip,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`purpose`,children:`Purpose`}),`\n`,_jsxs(_components.p,{children:[`This guide covers the recommended setup for teams moving from build to production on Affinda Extract - how to structure workspaces, manage `,_jsx(_components.a,{href:`/configuration/model-memory`,children:`model memory`}),`, and handle changes safely without disrupting live processing.`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`These are recommendations, not hard requirements. Adapt the structure to fit your team size, governance model, and rollout cadence.`})}),`\n`,_jsx(Heading,{level:`2`,id:`recommended-workspace-structure`,children:`Recommended workspace structure`}),`\n`,_jsx(_components.p,{children:`We recommend separating your organization into three workspaces, each with a clear purpose. Keeping them separate makes it easy to control access, isolate change, and keep production predictable.`}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{alt:`Workflows Best Practices`,title:`Workflows Best Practices`,lightAlt:`Workflows Best Practices`,darkAlt:`Workflows Best Practices`,src:`https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=4960e87cff593598f0bcd9a7fd14b2e2`,className:`dark:mint-hidden`,\"data-og-width\":`1562`,width:`1562`,\"data-og-height\":`729`,height:`729`,\"data-path\":`images/Workflows-best-practises.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=280\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=c8d6eaa3256b7554fe5e292398463281 280w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=560\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=fac7940b8a5606b6d382f4dd0969a65b 560w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=840\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=f27336097615f47913be707eedd3331d 840w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=8fff874d5ff4ac1dfcd59c52f89f4ad4 1100w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=8336ef4d69d284dd086dd38a64916c69 1650w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflows-best-practises.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=887d0209eafef75310fe987b7419bbe6 2500w`}),_jsx(OptimizedImage,{alt:`Workflows Best Practices`,title:`Workflows Best Practices`,lightAlt:`Workflows Best Practices`,darkAlt:`Workflows Best Practices`,src:`https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=a4d62f5cb0c13d3703ea85caa78c8be4`,className:`mint-hidden dark:mint-block`,\"data-og-width\":`1685`,width:`1685`,\"data-og-height\":`734`,height:`734`,\"data-path\":`images/Workflow-best-practise-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=7239ed521b6aa9f0e9762d3448c7e822 280w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=899da5c049c6ada11de24cd940d7f8b8 560w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=f0fbcd624b4a7e6df0b2095f8ce22110 840w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=30c030db27c2ec509b6b36c79d36d47b 1100w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=1c355e43d2c8fd3d33c3b8d81e4341e0 1650w, https://mintcdn.com/affinda-44/yUevVHiIaD2KWcP_/images/Workflow-best-practise-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yUevVHiIaD2KWcP_\u0026q=85\u0026s=8ad2a8fb45b998d3c69bd0d22b53ddbe 2500w`})]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Training workspace`,children:[_jsxs(_components.p,{children:[`The source of truth for what the model has learned. All `,_jsx(_components.a,{href:`/configuration/model-memory`,children:`model memory`}),` documents live here.`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`All confirmed model memory documents stored here`}),`\n`,_jsx(_components.li,{children:`Annotations updated here when fields or behavior change`}),`\n`,_jsx(_components.li,{children:`New document variations added here first`}),`\n`,_jsx(_components.li,{children:`Access restricted to configuration owners`}),`\n`]})]}),_jsxs(Step,{title:`Dev \u0026 Test workspace`,children:[_jsx(_components.p,{children:`A staging environment for validating changes before they reach production. Also used for UAT.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Document types configured in Training are linked here`}),`\n`,_jsx(_components.li,{children:`Integration testing space\\xA0`}),`\n`,_jsx(_components.li,{children:`No independent model memory; inherits the Model memory that lives in Train config`}),`\n`,_jsx(_components.li,{children:`Safe to experiment and break things here`}),`\n`]})]}),_jsxs(Step,{title:`Production workspace`,children:[_jsx(_components.p,{children:`Live document processing only. No training activity happens here.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Model memory toggle turned off`}),`\n`,_jsx(_components.li,{children:`Document types promoted here only after testing`}),`\n`,_jsx(_components.li,{children:`All documents processed via API from here`}),`\n`,_jsx(_components.li,{children:`No direct schema edits — go through Training first`}),`\n`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Access control:`}),` keeping workspaces separate lets you control who sees what. Only configuration owners need access to Training. Your operations team works in Production. Dev/Test is for internal QA and integration testing.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`“Duplicate Document type”`}),` to easily set up Test and Production workspaces from your Training workspace.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`making-changes-whilst-in-production`,children:`Making changes whilst in production`}),`\n`,_jsx(_components.p,{children:`Once your workflow is live in production, you may still need to update your document types or workflow settings from time to time. Identify the type of change you want to make, then follow the recommended approach below.`}),`\n`,_jsx(_components.p,{children:`Document types are shared across workspaces, so any change to a document type’s fields or descriptions applies immediately in every workspace that uses it, including Production.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Edits can’t be undone.`}),` Changes to fields and descriptions save immediately and there is no version history. Record the current settings before you make a change so you can revert if needed.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Duplicating a document type.`}),` When you duplicate a document type, you can copy up to 50 of the original’s model memory documents into a workspace you choose. This lets you test changes or edit annotations without starting from scratch.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-a-—-new-document-variation`,children:`Scenario A — New document variation`}),`\n`,_jsx(_components.p,{children:`The model is seeing a new version or variation of a document type already set up in the platform. It may not be performing well due to no closely matching example in the model’s model memory set.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Approach:`}),` Add to model memory → Training workspace`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Upload to Training`,children:_jsx(_components.p,{children:`Upload the new variation to the Training workspace.`})}),_jsx(Step,{title:`Annotate and confirm`,children:_jsx(_components.p,{children:`Annotate all fields correctly and confirm the document as model memory.`})}),_jsx(Step,{title:`Remove outdated examples`,children:_jsx(_components.p,{children:`Remove model memory documents for variations that are no longer relevant.`})}),_jsx(Step,{title:`No deployment needed`,children:_jsx(_components.p,{children:`Performance improves in production automatically — no deployment step required.`})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Adding a new variation to a model’s Model Memory can be done safely without pausing production. Only newly processed documents that are more similar to the new variation than others in your model memory set will be impacted.`})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Keep the model memory set small and curated, for example 10 to 15 documents per document type. A smaller set is easier to review and keep accurate.`})}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-b-—-field-descriptions-new-fields-or-post-processors`,children:`Scenario B — Field descriptions, new fields or post-processors`}),`\n`,_jsx(_components.p,{children:`Adding a field, editing a field description, or changing a post-processor.`}),`\n`,_jsx(Heading,{level:`4`,id:`option-1-edit-in-place-low-risk-changes`,children:`Option 1: Edit in place (low-risk changes)`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Approach:`}),` Edit in place → Training`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Edit the schema in Training`,children:_jsx(_components.p,{children:`Edit the schema directly in the Training workspace.`})}),_jsx(Step,{title:`Re-predict and reconfirm`,children:_jsx(_components.p,{children:`Re-predict the new or changed field on the model memory document, then reconfirm it.`})}),_jsx(Step,{title:`Takes effect immediately`,children:_jsx(_components.p,{children:`Changes take effect in production straight away.`})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Check first:`}),` confirm that the change won’t break or affect any downstream integrations before proceeding.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`option-2-test-on-a-copy-recommended-when-the-impact-is-uncertain`,children:`Option 2: Test on a copy (recommended when the impact is uncertain)`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Duplicate with copied model memory`,children:_jsx(_components.p,{children:`Duplicate the document type and copy the original’s model memory documents into the Training workspace.`})}),_jsx(Step,{title:`Make the change in Dev \u0026 Test`,children:_jsx(_components.p,{children:`Add the copy to the Dev \u0026 Test workspace and make your change on it. For a new field, annotate it on the copied documents.`})}),_jsx(Step,{title:`Test directly on the copy`,children:_jsx(_components.p,{children:`Upload test documents directly to the copy, not to the workspace, so they aren’t classified to the original. Check the results.`})}),_jsx(Step,{title:`Apply to the original`,children:_jsx(_components.p,{children:`Make the same change to the original document type, including annotating any new field on its model memory documents.`})}),_jsx(Step,{title:`Delete the copy`,children:_jsxs(_components.p,{children:[`Delete the copy and its copied documents from the `,_jsx(_components.strong,{children:`Settings`}),` tab of the document type editor.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-c-—-significant-schema-change`,children:`Scenario C — Significant schema change`}),`\n`,_jsx(_components.p,{children:`Groups, nesting, a field changing from a single value to multiple values, or anything that requires integration retesting.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Approach:`}),` Duplicate → Dev/Test → Production`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Leave production untouched`,children:_jsx(_components.p,{children:`Leave the existing production document type in place while you build the new version.`})}),_jsx(Step,{title:`Duplicate and copy model memory`,children:_jsx(_components.p,{children:`Duplicate the document type and choose to copy the original’s model memory documents (up to 50) into the Training workspace.`})}),_jsx(Step,{title:`Update annotations`,children:_jsx(_components.p,{children:`Make the schema change on the duplicate, then update the annotations on the copied documents in Training to match the new schema. Add new examples if needed.`})}),_jsx(Step,{title:`Test in Dev/Test`,children:_jsx(_components.p,{children:`Link the duplicate to the Dev/Test workspace to test the integration flow and make adjustments.`})}),_jsx(Step,{title:`Validate end-to-end`,children:_jsx(_components.p,{children:`Validate the full API payload end-to-end against the new schema.`})}),_jsx(Step,{title:`Promote to Production`,children:_jsx(_components.p,{children:`Once sign-off is complete, unlink the old version from production and link the new one.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":"Setting up and managing Affinda in production","description":"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.","sidebarTitle":"Production Best Practices","href":"/handbook/production-best-practices"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Purpose","slug":"purpose","depth":2,"children":[]},{"title":"Recommended workspace structure","slug":"recommended-workspace-structure","depth":2,"children":[]},{"title":"Making changes whilst in production","slug":"making-changes-whilst-in-production","depth":2,"children":[{"title":"Scenario A — New document variation","slug":"scenario-a-—-new-document-variation","depth":3,"children":[]},{"title":"Scenario B — Field descriptions, new fields or post-processors","slug":"scenario-b-—-field-descriptions-new-fields-or-post-processors","depth":3,"children":[]},{"title":"Option 1: Edit in place (low-risk changes)","slug":"option-1-edit-in-place-low-risk-changes","depth":4,"children":[]},{"title":"Option 2: Test on a copy (recommended when the impact is uncertain)","slug":"option-2-test-on-a-copy-recommended-when-the-impact-is-uncertain","depth":4,"children":[]},{"title":"Scenario C — Significant schema change","slug":"scenario-c-—-significant-schema-change","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"affinda-44","siteName":"Affinda Extract Documentation","title":"Setting up and managing Affinda in production - Affinda Extract Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T09:50:45.916Z","originalFileLocation":"handbook/production-best-practices.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=\"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Affinda Extract Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_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/affinda-44/tl-77mmsQTlzqSAp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Setting up and managing Affinda in production - Affinda Extract Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Affinda\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.affinda.com/handbook/production-best-practices\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/68ae96fe8f3fdbbe0ae04c73_Affinda%20Open%20Graph%20image%20for%20website%20previews.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=\"Setting up and managing Affinda in production - Affinda Extract Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/68ae96fe8f3fdbbe0ae04c73_Affinda%20Open%20Graph%20image%20for%20website%20previews.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/affinda-44/tl-77mmsQTlzqSAp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Affinda Extract Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1F3339\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.affinda.com/handbook/production-best-practices\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/handbook/production-best-practices.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.affinda.com/#organization\",\"name\":\"Affinda Extract Documentation\",\"url\":\"https://docs.affinda.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/affinda-44/nvZZjc-QOoHXzSQ7/images/affindaextract-inkwell.png?fit=max\u0026auto=format\u0026n=nvZZjc-QOoHXzSQ7\u0026q=85\u0026s=a3e52ff1e274ac5509589a6350b41496\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.affinda.com#website\",\"name\":\"Affinda Extract Documentation\",\"url\":\"https://docs.affinda.com\",\"publisher\":{\"@id\":\"https://docs.affinda.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.affinda.com/handbook/production-best-practices#webpage\",\"url\":\"https://docs.affinda.com/handbook/production-best-practices\",\"name\":\"Setting up and managing Affinda in production\",\"description\":\"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\",\"dateModified\":\"2026-11-09T09:50:45.916Z\",\"isPartOf\":{\"@id\":\"https://docs.affinda.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.affinda.com/handbook/production-best-practices#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.affinda.com/handbook/production-best-practices#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Advanced Playbooks\",\"item\":\"https://docs.affinda.com/handbook/schema-design\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Setting up and managing Affinda in production\",\"item\":\"https://docs.affinda.com/handbook/production-best-practices\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.affinda.com/handbook/production-best-practices#article\",\"headline\":\"Setting up and managing Affinda in production\",\"name\":\"Setting up and managing Affinda in production\",\"description\":\"Recommended workspace architecture and change management practices for teams moving from build to production on Affinda Extract.\",\"url\":\"https://docs.affinda.com/handbook/production-best-practices\",\"mainEntityOfPage\":{\"@id\":\"https://docs.affinda.com/handbook/production-best-practices#webpage\"},\"image\":\"https://cdn.prod.website-files.com/6854ccfd1a7ab92f392b474d/68ae96fe8f3fdbbe0ae04c73_Affinda%20Open%20Graph%20image%20for%20website%20previews.png\",\"dateModified\":\"2026-11-09T09:50:45.916Z\",\"publisher\":{\"@id\":\"https://docs.affinda.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.affinda.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Affinda Extract Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Affinda Extract Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/handbook/production-best-practices.md","siteName":"Affinda Extract Documentation","nav":{"global":null,"tabs":[{"tab":"Extract Handbook","pages":[{"title":"Affinda Extract docs: document AI guides and API reference","mode":"wide","sidebarTitle":"Welcome","href":"/home"},{"group":"Foundation Tutorials","pages":[{"title":"Getting started with Affinda Extract","sidebarTitle":"Getting Started with Affinda Extract","href":"/handbook/getting-started"},{"title":"Creating a new model","sidebarTitle":"Creating a New Model","href":"/handbook/model-creation"},{"title":"Improving accuracy: a deep dive into extraction models","sidebarTitle":"Improving Model Accuracy","href":"/handbook/improving-accuracy"}]},{"group":"User Validation 101","pages":[{"title":"User validation of extracted data","sidebarTitle":"User Validation of Extracted Data","href":"/handbook/review-extraction"},{"title":"Edit extracted tables in the table editor","sidebarTitle":"Table Editor","href":"/handbook/table-editor"},{"title":"Reviewing splitting and classification results","href":"/handbook/split-classify"}]},{"group":"Advanced Playbooks","pages":[{"title":"Schema design and field configuration best practices","href":"/handbook/schema-design"},{"title":"Achieving straight-through processing","sidebarTitle":"Achieve Straight Through Processing","href":"/handbook/straight-through-processing"},{"title":"Integration workflows and solution design patterns","href":"/handbook/solution-design"},{"title":"Create your integration with the Affinda Agent","description":"Use the Affinda Agent to build no-code data exports to downstream applications like ATS, ERP, and CRM systems using natural language.","href":"/handbook/agent-integrations"},{"title":"Setting up and managing Affinda in production","sidebarTitle":"Production Best Practices","href":"/handbook/production-best-practices"},{"title":"Writing field descriptions","sidebarTitle":"Writing Field Descriptions","description":"Write Affinda Extract field descriptions that resolve ambiguous fields for the extraction model, using eight concrete patterns and a checklist.","href":"/handbook/field-descriptions"}]}]},{"tab":"Configuration Guide","pages":[{"title":"Configuration Guide","href":"/configuration/workflow"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/getting-started"}]},{"tab":"AI Integrations","pages":[{"title":"AI Integrations","href":"/integrations/mcp-connector"}]},{"tab":"Additional Resources","pages":[{"title":"Additional Resources","href":"/resources"}]}]},"basePath":"","title":"Setting up and managing Affinda in production - Affinda Extract Documentation","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["10e4515597","07c022d89b","a74be98ba7"],"chunks":["BannerMarkdown-DnSAhvaM.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}