[{"data":1,"prerenderedAt":3563},["ShallowReactive",2],{"navigation_docs":3,"-engineering-contributing-back-end-llm-prompts":449,"-engineering-contributing-back-end-llm-prompts-surround":3558},[4,8,72,102,248,294,331,352,445],{"title":5,"path":6,"stem":7},"Introduction","\u002Fintroduction","0.introduction",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":67},"Company","i-lucide-building-2","\u002Fcompany","1.company",[14,18,22,26,30,34,38,42,46,50,54,68],{"title":15,"path":16,"stem":17},"About","\u002Fcompany\u002Fabout","1.company\u002F0.about",{"title":19,"path":20,"stem":21},"Values","\u002Fcompany\u002Fvalues","1.company\u002F1.values",{"title":23,"path":24,"stem":25},"Communication","\u002Fcompany\u002Fcommunication","1.company\u002Fcommunication",{"title":27,"path":28,"stem":29},"Competition","\u002Fcompany\u002Fcompetition","1.company\u002Fcompetition",{"title":31,"path":32,"stem":33},"Hybrid Working","\u002Fcompany\u002Fhybrid-working","1.company\u002Fhybrid-working",{"title":35,"path":36,"stem":37},"Manchester Office","\u002Fcompany\u002Foffice","1.company\u002Foffice",{"title":39,"path":40,"stem":41},"Operations","\u002Fcompany\u002Foperations","1.company\u002Foperations",{"title":43,"path":44,"stem":45},"Policies","\u002Fcompany\u002Fpolicies","1.company\u002Fpolicies",{"title":47,"path":48,"stem":49},"Problem Statement","\u002Fcompany\u002Fproblem-statement","1.company\u002Fproblem-statement",{"title":51,"path":52,"stem":53},"Product Strategy","\u002Fcompany\u002Fproduct-strategy","1.company\u002Fproduct-strategy",{"title":55,"path":56,"stem":57,"children":58,"page":67},"Products","\u002Fcompany\u002Fproducts","1.company\u002Fproducts",[59,63],{"title":60,"path":61,"stem":62},"Capability Exchange","\u002Fcompany\u002Fproducts\u002Fcapability-exchange","1.company\u002Fproducts\u002Fcapability-exchange",{"title":64,"path":65,"stem":66},"ESProfiler Platform","\u002Fcompany\u002Fproducts\u002Fesprofiler","1.company\u002Fproducts\u002Fesprofiler",false,{"title":69,"path":70,"stem":71},"Security","\u002Fcompany\u002Fsecurity","1.company\u002Fsecurity",{"title":73,"icon":74,"path":75,"stem":76,"children":77,"page":67},"People Ops","i-lucide-users","\u002Fpeople-ops","2.people-ops",[78,82,86,90,94,98],{"title":79,"path":80,"stem":81},"Compensation","\u002Fpeople-ops\u002Fcompensation","2.people-ops\u002Fcompensation",{"title":83,"path":84,"stem":85},"Education","\u002Fpeople-ops\u002Feducation","2.people-ops\u002Feducation",{"title":87,"path":88,"stem":89},"Expenses","\u002Fpeople-ops\u002Fexpenses","2.people-ops\u002Fexpenses",{"title":91,"path":92,"stem":93},"Holiday & Leave","\u002Fpeople-ops\u002Fleave","2.people-ops\u002Fleave",{"title":95,"path":96,"stem":97},"Onboarding","\u002Fpeople-ops\u002Fonboarding","2.people-ops\u002Fonboarding",{"title":99,"path":100,"stem":101},"Recruitment","\u002Fpeople-ops\u002Frecruitment","2.people-ops\u002Frecruitment",{"title":103,"icon":104,"path":105,"stem":106,"children":107,"page":67},"Engineering","i-lucide-rocket","\u002Fengineering","3.engineering",[108,168,189,210,232,240,244],{"title":109,"path":110,"stem":111,"children":112,"page":67},"Contributing","\u002Fengineering\u002Fcontributing","3.engineering\u002Fcontributing",[113,117,121,125,129,133,146,155],{"title":114,"path":115,"stem":116},"Development Setup","\u002Fengineering\u002Fcontributing\u002Fdevelopment-setup","3.engineering\u002Fcontributing\u002F1.development-setup",{"title":118,"path":119,"stem":120},"Engineering Operations","\u002Fengineering\u002Fcontributing\u002Fengineering-operations","3.engineering\u002Fcontributing\u002F2.engineering-operations",{"title":122,"path":123,"stem":124},"Documentation","\u002Fengineering\u002Fcontributing\u002Fdocumentation","3.engineering\u002Fcontributing\u002F3.documentation",{"title":126,"path":127,"stem":128},"Agentic Coding","\u002Fengineering\u002Fcontributing\u002Fagentic-coding","3.engineering\u002Fcontributing\u002F4.agentic-coding",{"title":130,"path":131,"stem":132},"Coding Standards","\u002Fengineering\u002Fcontributing\u002Fcoding-standards","3.engineering\u002Fcontributing\u002F5.coding-standards",{"title":134,"path":135,"stem":136,"children":137,"page":67},"Back End","\u002Fengineering\u002Fcontributing\u002Fback-end","3.engineering\u002Fcontributing\u002Fback-end",[138,142],{"title":139,"path":140,"stem":141},"API Guidelines","\u002Fengineering\u002Fcontributing\u002Fback-end\u002Fapi-guidelines","3.engineering\u002Fcontributing\u002Fback-end\u002Fapi-guidelines",{"title":143,"path":144,"stem":145},"LLM Prompts & Langfuse Integration","\u002Fengineering\u002Fcontributing\u002Fback-end\u002Fllm-prompts","3.engineering\u002Fcontributing\u002Fback-end\u002Fllm-prompts",{"title":147,"path":148,"stem":149,"children":150,"page":67},"Database","\u002Fengineering\u002Fcontributing\u002Fdatabase","3.engineering\u002Fcontributing\u002Fdatabase",[151],{"title":152,"path":153,"stem":154},"Database Volumes","\u002Fengineering\u002Fcontributing\u002Fdatabase\u002Fdatabase-refresh","3.engineering\u002Fcontributing\u002Fdatabase\u002Fdatabase-refresh",{"title":156,"path":157,"stem":158,"children":159,"page":67},"Front End","\u002Fengineering\u002Fcontributing\u002Ffront-end","3.engineering\u002Fcontributing\u002Ffront-end",[160,164],{"title":161,"path":162,"stem":163},"Data Attributes","\u002Fengineering\u002Fcontributing\u002Ffront-end\u002Fdata-attributes","3.engineering\u002Fcontributing\u002Ffront-end\u002Fdata-attributes",{"title":165,"path":166,"stem":167},"Testing","\u002Fengineering\u002Fcontributing\u002Ffront-end\u002Ftesting","3.engineering\u002Fcontributing\u002Ffront-end\u002Ftesting",{"title":169,"path":170,"stem":171,"children":172},"Deployment","\u002Fengineering\u002Fdeployment","3.engineering\u002Fdeployment\u002F0.index",[173,174,177,181,185],{"title":169,"path":170,"stem":171},{"title":60,"path":175,"stem":176},"\u002Fengineering\u002Fdeployment\u002Fcapability-exchange","3.engineering\u002Fdeployment\u002Fcapability-exchange",{"title":178,"path":179,"stem":180},"Langfuse Deployment","\u002Fengineering\u002Fdeployment\u002Fecs-langfuse-deployment","3.engineering\u002Fdeployment\u002Fecs-langfuse-deployment",{"title":182,"path":183,"stem":184},"ESP Platform Configuration","\u002Fengineering\u002Fdeployment\u002Fesp-platform-configuration","3.engineering\u002Fdeployment\u002Fesp-platform-configuration",{"title":186,"path":187,"stem":188},"Platform","\u002Fengineering\u002Fdeployment\u002Fplatform","3.engineering\u002Fdeployment\u002Fplatform",{"title":190,"path":191,"stem":192,"children":193,"page":67},"Github","\u002Fengineering\u002Fgithub","3.engineering\u002Fgithub",[194,198,202,206],{"title":195,"path":196,"stem":197},"Packages","\u002Fengineering\u002Fgithub\u002Fpackages","3.engineering\u002Fgithub\u002Fpackages",{"title":199,"path":200,"stem":201},"Personal Access Token","\u002Fengineering\u002Fgithub\u002Fpersonal-access-token","3.engineering\u002Fgithub\u002Fpersonal-access-token",{"title":203,"path":204,"stem":205},"Troubleshooting","\u002Fengineering\u002Fgithub\u002Ftroubleshooting","3.engineering\u002Fgithub\u002Ftroubleshooting",{"title":207,"path":208,"stem":209},"Workflows","\u002Fengineering\u002Fgithub\u002Fworkflows","3.engineering\u002Fgithub\u002Fworkflows",{"title":211,"path":212,"stem":213,"children":214},"Platform Ops","\u002Fengineering\u002Fplatform-ops","3.engineering\u002Fplatform-ops\u002F0.index",[215,216,220,224,228],{"title":211,"path":212,"stem":213},{"title":217,"path":218,"stem":219},"Production Database","\u002Fengineering\u002Fplatform-ops\u002Fdatabase-connection","3.engineering\u002Fplatform-ops\u002Fdatabase-connection",{"title":221,"path":222,"stem":223},"New Tenant Creation","\u002Fengineering\u002Fplatform-ops\u002Fnew-tenant-creation","3.engineering\u002Fplatform-ops\u002Fnew-tenant-creation",{"title":225,"path":226,"stem":227},"Releases","\u002Fengineering\u002Fplatform-ops\u002Frelease","3.engineering\u002Fplatform-ops\u002Frelease",{"title":229,"path":230,"stem":231},"Versioning","\u002Fengineering\u002Fplatform-ops\u002Fversioning","3.engineering\u002Fplatform-ops\u002Fversioning",{"title":186,"path":233,"stem":234,"children":235,"page":67},"\u002Fengineering\u002Fplatform","3.engineering\u002Fplatform",[236],{"title":237,"path":238,"stem":239},"useAPI","\u002Fengineering\u002Fplatform\u002Fuse-api","3.engineering\u002Fplatform\u002Fuse-api",{"title":241,"path":242,"stem":243},"Project Management","\u002Fengineering\u002Fproject-management","3.engineering\u002Fproject-management",{"title":245,"path":246,"stem":247},"Tools","\u002Fengineering\u002Ftools","3.engineering\u002Ftools",{"title":249,"icon":250,"path":251,"stem":252,"children":253,"page":67},"Design","i-lucide-palette","\u002Fdesign","4.design",[254,275,279,283,287,290],{"title":255,"path":256,"stem":257,"children":258,"page":67},"Personas","\u002Fdesign\u002Fpersonas","4.design\u002F0.personas",[259,263,267,271],{"title":260,"path":261,"stem":262},"CISO - Simon","\u002Fdesign\u002Fpersonas\u002F01-ciso-simon","4.design\u002F0.personas\u002F01-ciso-simon",{"title":264,"path":265,"stem":266},"Head of Cyber - Harry","\u002Fdesign\u002Fpersonas\u002F02-head-of-cyber-harry","4.design\u002F0.personas\u002F02-head-of-cyber-harry",{"title":268,"path":269,"stem":270},"Security Architect - Sasha","\u002Fdesign\u002Fpersonas\u002F03-security-architect-sasha","4.design\u002F0.personas\u002F03-security-architect-sasha",{"title":272,"path":273,"stem":274},"Procurement Officer - Paige","\u002Fdesign\u002Fpersonas\u002F04-procurement-officer-paige","4.design\u002F0.personas\u002F04-procurement-officer-paige",{"title":276,"path":277,"stem":278},"Design Thinking","\u002Fdesign\u002Fdesign-thinking","4.design\u002F1.design-thinking",{"title":280,"path":281,"stem":282},"Design & Development","\u002Fdesign\u002Fdesign-and-development","4.design\u002F3.design-and-development",{"title":284,"path":285,"stem":286},"Branding","\u002Fdesign\u002Fbranding","4.design\u002F4.branding",{"title":245,"path":288,"stem":289},"\u002Fdesign\u002Ftools","4.design\u002F5.tools",{"title":291,"path":292,"stem":293},"Customer Success","\u002Fdesign\u002Fworking-with-customers","4.design\u002F6.working-with-customers",{"title":295,"icon":296,"path":297,"stem":298,"children":299,"page":67},"Sales","i-lucide-dollar-sign","\u002Fsales","4.sales",[300,320,324,328],{"title":301,"path":302,"stem":303,"children":304,"page":67},"Process","\u002Fsales\u002Fprocess","4.sales\u002F0.process",[305,309,313,317],{"title":306,"path":307,"stem":308},"Lead","\u002Fsales\u002Fprocess\u002Flead","4.sales\u002F0.process\u002F0.lead",{"title":310,"path":311,"stem":312},"Deal Qualification","\u002Fsales\u002Fprocess\u002Fqualification","4.sales\u002F0.process\u002F1.qualification",{"title":314,"path":315,"stem":316},"Close","\u002Fsales\u002Fprocess\u002Fclose","4.sales\u002F0.process\u002F2.close",{"title":95,"path":318,"stem":319},"\u002Fsales\u002Fprocess\u002Fonboarding","4.sales\u002F0.process\u002Fonboarding",{"title":321,"path":322,"stem":323},"Meetings","\u002Fsales\u002Fmeetings","4.sales\u002Fmeetings",{"title":325,"path":326,"stem":327},"Metrics","\u002Fsales\u002Fmetrics","4.sales\u002Fmetrics",{"title":245,"path":329,"stem":330},"\u002Fsales\u002Ftools","4.sales\u002Ftools",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":67},"Marketing","i-lucide-book-image","\u002Fmarketing","5.marketing",[337,341,345,348],{"title":338,"path":339,"stem":340},"Content","\u002Fmarketing\u002Fcontent","5.marketing\u002Fcontent",{"title":342,"path":343,"stem":344},"Messaging","\u002Fmarketing\u002Fmessaging","5.marketing\u002Fmessaging",{"title":245,"path":346,"stem":347},"\u002Fmarketing\u002Ftools","5.marketing\u002Ftools",{"title":349,"path":350,"stem":351},"Website","\u002Fmarketing\u002Fwebsite","5.marketing\u002Fwebsite",{"title":353,"icon":354,"path":355,"stem":356,"children":357,"page":67},"AI & Data Ops","i-lucide-database","\u002Fdata-ops","6.data-ops",[358,362,370,395,416,420],{"title":359,"path":360,"stem":361},"Account Portal (CAS)","\u002Fdata-ops\u002Faccount-portal","6.data-ops\u002Faccount-portal",{"title":60,"path":363,"stem":364,"children":365,"page":67},"\u002Fdata-ops\u002Fcapability-exchange","6.data-ops\u002Fcapability-exchange",[366],{"title":367,"path":368,"stem":369},"Leaderboard Calculation","\u002Fdata-ops\u002Fcapability-exchange\u002Fleaderboard-calculation","6.data-ops\u002Fcapability-exchange\u002Fleaderboard-calculation",{"title":371,"path":372,"stem":373,"children":374,"page":67},"Data Management","\u002Fdata-ops\u002Fdata-management","6.data-ops\u002Fdata-management",[375,379,383,387,391],{"title":376,"path":377,"stem":378},"Adding Products","\u002Fdata-ops\u002Fdata-management\u002Fadding-products","6.data-ops\u002Fdata-management\u002Fadding-products",{"title":380,"path":381,"stem":382},"Adding Vendors","\u002Fdata-ops\u002Fdata-management\u002Fadding-vendors","6.data-ops\u002Fdata-management\u002Fadding-vendors",{"title":384,"path":385,"stem":386},"Framework Mapping","\u002Fdata-ops\u002Fdata-management\u002Fframework-mapping","6.data-ops\u002Fdata-management\u002Fframework-mapping",{"title":388,"path":389,"stem":390},"Refreshing Vendors","\u002Fdata-ops\u002Fdata-management\u002Frefreshing-vendors","6.data-ops\u002Fdata-management\u002Frefreshing-vendors",{"title":392,"path":393,"stem":394},"Reviewing Draft Vendors","\u002Fdata-ops\u002Fdata-management\u002Freviewing-draft-vendors","6.data-ops\u002Fdata-management\u002Freviewing-draft-vendors",{"title":396,"path":397,"stem":398,"children":399,"page":67},"LLM Ops","\u002Fdata-ops\u002Fllm-ops","6.data-ops\u002Fllm-ops",[400,404,408,412],{"title":401,"path":402,"stem":403},"Agents","\u002Fdata-ops\u002Fllm-ops\u002Fagents","6.data-ops\u002Fllm-ops\u002F1.agents",{"title":405,"path":406,"stem":407},"ESPi Architecture & Query Flow","\u002Fdata-ops\u002Fllm-ops\u002Fespi-architecture","6.data-ops\u002Fllm-ops\u002F2.espi-architecture",{"title":409,"path":410,"stem":411},"Evaluating Agents","\u002Fdata-ops\u002Fllm-ops\u002Fevaluations","6.data-ops\u002Fllm-ops\u002F3.evaluations",{"title":413,"path":414,"stem":415},"Benchmarking ESPi","\u002Fdata-ops\u002Fllm-ops\u002Fbenchmarking-espi","6.data-ops\u002Fllm-ops\u002F4.benchmarking-espi",{"title":417,"path":418,"stem":419},"Message Queues","\u002Fdata-ops\u002Fmessage-queues","6.data-ops\u002Fmessage-queues",{"title":421,"path":422,"stem":423,"children":424,"page":67},"Models","\u002Fdata-ops\u002Fmodels","6.data-ops\u002Fmodels",[425,429,433,437,441],{"title":426,"path":427,"stem":428},"Universal Framework Mapper Vision","\u002Fdata-ops\u002Fmodels\u002Funiversal-framework-mapper-vision","6.data-ops\u002Fmodels\u002F1.universal-framework-mapper-vision",{"title":430,"path":431,"stem":432},"Framework Description Model (FDM)","\u002Fdata-ops\u002Fmodels\u002Fframework-description-model","6.data-ops\u002Fmodels\u002F2.framework-description-model",{"title":434,"path":435,"stem":436},"Relationship Definition Model (RDM)","\u002Fdata-ops\u002Fmodels\u002Frelationship-definition-model","6.data-ops\u002Fmodels\u002F3.relationship-definition-model",{"title":438,"path":439,"stem":440},"Relationship Mapping Model (RMM)","\u002Fdata-ops\u002Fmodels\u002Frelationship-mapping-model","6.data-ops\u002Fmodels\u002F4.relationship-mapping-model",{"title":442,"path":443,"stem":444},"Platform Framework Matrix V2","\u002Fdata-ops\u002Fmodels\u002Fplatform-framework-matrix-v2","6.data-ops\u002Fmodels\u002F5.platform-framework-matrix-v2",{"title":446,"path":447,"stem":448},"Glossary","\u002Fglossary","glossary",{"id":450,"title":143,"body":451,"description":3552,"extension":3553,"links":3554,"meta":3555,"navigation":831,"path":144,"seo":3556,"stem":145,"__hash__":3557},"docs\u002F3.engineering\u002Fcontributing\u002Fback-end\u002Fllm-prompts.md",{"type":452,"value":453,"toc":3515},"minimark",[454,459,463,468,473,538,541,545,548,552,555,567,590,598,605,641,649,659,666,689,693,700,764,771,790,1198,1202,1222,1744,1748,1757,1759,1766,1774,1778,1781,1807,1823,1829,1835,1852,1860,1871,1892,1894,1898,1901,1946,1948,1952,1958,1961,1984,1991,2043,2049,2068,2070,2074,2077,2137,2158,2160,2164,2173,2176,2179,2181,2185,2189,2192,2215,2219,2226,2254,2256,2265,2278,2309,2315,2317,2321,2351,2353,2357,2406,2412,2426,2428,2432,2435,2453,2537,2547,2549,2553,2557,2560,2694,2698,2704,2754,2758,2807,2811,2860,2862,2864,2868,2872,2881,2979,2993,2995,2999,3002,3027,3031,3068,3070,3074,3078,3166,3170,3173,3226,3228,3232,3379,3381,3387,3393,3435,3437,3441,3511],[455,456,458],"h2",{"id":457},"overview-architecture","Overview & Architecture",[460,461,462],"p",{},"We maintain a strict separation between application code, prompt definitions, and observability:",[464,465],"mermaid",{":zoom":466,"code":467},"1","graph TD\n    A(\"\u003Cdiv align='left'>\u003Cb>platform-api \u002F api-cps\u003C\u002Fb>\u003C\u002Fdiv>\"):::client\n    B(\"\u003Cdiv align='left'>\u003Cb>esp-prompts\u003C\u002Fb> (Git Repo)\u003C\u002Fdiv>\"):::client\n    C(\"\u003Cdiv align='left'>\u003Cb>Langfuse LLMOps Platform\u003C\u002Fb>\u003Cbr\u002F>https:\u002F\u002Fesplf.esprofiler.com\u003Cbr\u002F>• Prompt Versioning & Storage\u003Cbr\u002F>• Environment Labels (staging vs production)\u003Cbr\u002F>• Traces & Generation Spans\u003C\u002Fdiv>\"):::agent\n    D(\"\u003Cdiv align='left'>\u003Cb>Spring Boot: LangfusePromptService\u003C\u002Fb>\u003Cbr\u002F>• Startup Ingestion (ApplicationReadyEvent)\u003Cbr\u002F>• Scheduled Quartz Sweep (Every 20 mins)\u003Cbr\u002F>• Instant Ingestion API (PATCH \u002Fschedules\u002Frun)\u003Cbr\u002F>• Dual-Layer Cache (In-Memory RAM + Disk)\u003Cbr\u002F>• StringTemplate Raw Compilation\u003C\u002Fdiv>\"):::domain\n\n    A -->|Fallback Classpath .st| C\n    B -->|Automated GitHub Actions| C\n    C -->|Dynamic HTTP Fetch & Caching| D\n",[469,470,472],"h3",{"id":471},"core-principles","Core Principles",[474,475,476,495,513,523,532],"ol",{},[477,478,479,483,484,494],"li",{},[480,481,482],"strong",{},"Git is the Single Source of Truth:"," All prompts live in the ",[485,486,490],"a",{"href":487,"rel":488},"https:\u002F\u002Fgithub.com\u002FES-Profiler\u002Fesp-prompts",[489],"nofollow",[491,492,493],"code",{},"esp-prompts"," repository.",[477,496,497,500,501,504,505,508,509,512],{},[480,498,499],{},"Dynamic Ingestion via Langfuse:"," At runtime, services query Langfuse (",[491,502,503],{},"https:\u002F\u002Fesplf.esprofiler.com",") for the prompt version tagged with their target environment label (",[491,506,507],{},"production"," by default, or ",[491,510,511],{},"staging"," in test environments).",[477,514,515,518,519,522],{},[480,516,517],{},"Resilient Local Fallbacks:"," Every prompt declared in code includes a local classpath fallback file (e.g. ",[491,520,521],{},"src\u002Fmain\u002Fresources\u002Fintelligence\u002Fprompts\u002F*.st",") to ensure services start reliably even if Langfuse is unreachable.",[477,524,525,528,529,531],{},[480,526,527],{},"Testing on Staging Before Production:"," Changes must always be verified on Staging before being promoted to ",[491,530,507],{},".",[477,533,534,537],{},[480,535,536],{},"Benchmarking & Evaluation (Future \u002F TBD):"," Automated evaluation pipelines and benchmark datasets by the Data\u002FAI team are planned for future releases. Developers can log data-tasks to contribute to this future benchmark suite.",[539,540],"hr",{},[455,542,544],{"id":543},"adding-new-prompts","Adding New Prompts",[460,546,547],{},"Follow these steps when creating a brand new prompt that has never existed in the platform or Langfuse.",[469,549,551],{"id":550},"workflow-summary","Workflow Summary",[464,553],{":zoom":466,"code":554},"graph TD\n    S1(\"\u003Cdiv align='left'>\u003Cb>1. Backend Implementation\u003C\u002Fb> (platform-api \u002F api-cps)\u003Cbr\u002F>• Create classpath fallback prompt (.st file)\u003Cbr\u002F>• Inject LangfusePromptService and wire ChatClient\u003Cbr\u002F>• Add LangfusePromptObservationAdvisor\u003Cbr\u002F>• Create PR and obtain review approval\u003C\u002Fdiv>\"):::infra\n    S2(\"\u003Cdiv align='left'>\u003Cb>2. Create Prompt in esp-prompts Repository\u003C\u002Fb>\u003Cbr\u002F>• Add prompt markdown file in platform\u002F or cps\u002F\u003Cbr\u002F>• Open PR in esp-prompts referencing backend PR\u003Cbr\u002F>• Merge to main → auto-syncs to Langfuse with staging label\u003C\u002Fdiv>\"):::infra\n    S3(\"\u003Cdiv align='left'>\u003Cb>3. Staging Verification & Testing\u003C\u002Fb>\u003Cbr\u002F>• Deploy\u002Ftest backend on Staging (ESP_LANGFUSE_PROMPTS_LABEL=staging)\u003Cbr\u002F>• Verify generation spans and traces in Langfuse\u003C\u002Fdiv>\"):::infra\n    S4(\"\u003Cdiv align='left'>\u003Cb>4. Open Data-Task for Benchmarking\u003C\u002Fb> (Optional \u002F TBD)\u003Cbr\u002F>• Create GitHub Issue with Data and Back-End labels\u003Cbr\u002F>• Log golden dataset \u002F test scenarios for future AI benchmark suite\u003C\u002Fdiv>\"):::infra\n    S5(\"\u003Cdiv align='left'>\u003Cb>5. Promote Prompt to Production & Release Backend\u003C\u002Fb>\u003Cbr\u002F>• Run 'Promote Prompts to Production' GitHub Action in esp-prompts\u003Cbr\u002F>• Reviewer approves production environment gate in GitHub\u003Cbr\u002F>• Prompt version is labelled production\u003Cbr\u002F>• Merge and release the backend service PR\u003C\u002Fdiv>\"):::client\n\n    S1 --> S2 --> S3 --> S4 --> S5\n",[469,556,558,559,562,563,566],{"id":557},"step-1-backend-implementation-platform-api-api-cps","Step 1: Backend Implementation (",[491,560,561],{},"platform-api"," \u002F ",[491,564,565],{},"api-cps",")",[568,569,571,574,575,578,579,581,582,585,586,589],"callout",{"icon":570},"i-lucide-lightbulb",[480,572,573],{},"Local Development Independence:"," As a backend developer, you do ",[480,576,577],{},"not"," need to wait for ",[491,580,493],{}," or Langfuse to start coding or running unit tests. The backend service is completely functional locally because ",[491,583,584],{},"LangfusePromptService"," uses your local static classpath ",[491,587,588],{},".st"," file whenever a remote prompt is not found or when running offline.",[591,592,594,595,597],"h4",{"id":593},"_1-add-the-static-fallback-prompt-st-file","1. Add the Static Fallback Prompt (",[491,596,588],{}," file)",[460,599,600,601,604],{},"Static fallback prompt templates live under ",[491,602,603],{},"src\u002Fmain\u002Fresources\u002F"," in your backend application:",[606,607,608,627],"ul",{},[477,609,610,615,616,619,620,619,623,626],{},[480,611,612],{},[491,613,614],{},"src\u002Fmain\u002Fresources\u002Fintelligence\u002Fprompts\u002F"," — Standard copilot, insight, and platform agents (e.g., ",[491,617,618],{},"insights\u002Fsignal-evaluation.st",", ",[491,621,622],{},"agent-copilot.st",[491,624,625],{},"agent-notebook.st",").",[477,628,629,634,635,619,638,626],{},[480,630,631],{},[491,632,633],{},"src\u002Fmain\u002Fresources\u002Fagent-tasks\u002F"," — Workflow-specific agents (e.g., ",[491,636,637],{},"agent-tasks\u002Fgeneral\u002F",[491,639,640],{},"agent-tasks\u002Fproduct-comparison\u002F",[460,642,643],{},[480,644,645,646],{},"Example: ",[491,647,648],{},"src\u002Fmain\u002Fresources\u002Fintelligence\u002Fprompts\u002Finsights\u002Fsignal-evaluation.st",[650,651,657],"pre",{"className":652,"code":654,"language":655,"meta":656},[653],"language-text","You are an expert Cybersecurity Intelligence Analyst. Your task is to map a new observation (Finding) to the single best matching high-level trend (Signal) from a provided list of candidate Signals.\n\nStrict Rule: A Finding can only belong to AT MOST ONE Signal.\n\nHere is the Finding to evaluate:\nTitle: \u003Cfinding.title>\nDescription: \u003Cfinding.description>\n\nHere are the candidate Signals:\n\u003CcandidateSignals:{s |\n- ID: \u003Cs.id>\n  Title: \u003Cs.title>\n  Description: \u003Cs.description>\n  Type: \u003Cs.type>\n}>\n","text","",[491,658,654],{"__ignoreMap":656},[460,660,661,662,531],{},"The variables injected are injected into the prompt when ",[485,663,665],{"href":664},"#3-calling-the-agent-service-in-java","calling the agent service in Java",[568,667,669,672,673,676,677,680,681,684,685,688],{"icon":668},"i-lucide-info",[480,670,671],{},"StringTemplate Syntax:"," Prompts support ",[491,674,675],{},"{variable}"," and ",[491,678,679],{},"\u003Cvariable>"," placeholders, object property access (",[491,682,683],{},"\u003Cfinding.title>","), and collection iterations (",[491,686,687],{},"\u003CcandidateSignals:{s | ...}>","). Prompts are synchronized raw so that Spring Boot's StringTemplate engine compiles them directly.",[591,690,692],{"id":691},"understanding-the-prompt-resolution-cache-hierarchy","Understanding the Prompt Resolution & Cache Hierarchy",[460,694,695,696,699],{},"When ",[491,697,698],{},"langfusePromptService.getPrompt(PROMPT_NAME, fallbackPrompt)"," is called at runtime, it resolves the prompt through a 4-tier hierarchy:",[474,701,702,712,731,753],{},[477,703,704,711],{},[480,705,706,707,710],{},"RAM Cache (",[491,708,709],{},"memoryCache"," Map):"," Checked first (0ms latency, zero disk I\u002FO).",[477,713,714,717,718,721,722,725,726,728,729,626],{},[480,715,716],{},"Remote Langfuse Ingestion:"," If online and configured (",[491,719,720],{},"ESP_LLM_OBSERVATION_OTLP_ENDPOINT","), fetches the version tagged with ",[491,723,724],{},"ESP_LANGFUSE_PROMPTS_LABEL"," (",[491,727,507],{}," or ",[491,730,511],{},[477,732,733,744,745,748,749,752],{},[480,734,735,736,739,740,743],{},"Disk Cache (",[491,737,738],{},"resources\u002Fprompts\u002F\u003Cprompt>.st"," & ",[491,741,742],{},".version","):"," Persisted on the container filesystem (configured via ",[491,746,747],{},"esp.langfuse.prompts.cache-dir",", defaults to ",[491,750,751],{},"resources\u002Fprompts\u002F",") so prompts survive network blips.",[477,754,755,758,759,761,762,531],{},[480,756,757],{},"Local Classpath Fallback:"," If Langfuse is unreachable, disabled, or if the prompt hasn't been created in Langfuse yet, it falls back to your local ",[491,760,588],{}," resource in ",[491,763,603],{},[591,765,767,768,770],{"id":766},"_2-wire-langfusepromptservice-and-chatclient-advisor","2. Wire ",[491,769,584],{}," and ChatClient Advisor",[460,772,773,774,777,778,781,782,785,786,789],{},"In your Spring configuration class (e.g., ",[491,775,776],{},"SignalGenerationAgentConfig.java"," in ",[480,779,780],{},"esp-platform"," project), declare a ",[491,783,784],{},"ChatClient"," bean wrapped in ",[491,787,788],{},"ReloadableChatClient",". This binds your feature to Langfuse, attaches OpenTelemetry tracing, and allows the prompt to be hot-reloaded dynamically at runtime:",[650,791,795],{"className":792,"code":793,"filename":776,"language":794,"meta":656,"style":656},"language-java shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","@Configuration\npublic class SignalGenerationAgentConfig {\n\n  private static final String SIGNAL_EVALUATION_PROMPT_NAME = \"signal-evaluation\";\n\n  @Bean\n  public ChatClient signalEvaluationAgent(\n      @Value(\"classpath:intelligence\u002Fprompts\u002Finsights\u002Fsignal-evaluation.st\") Resource systemPrompt,\n      GoogleGenAiChatModel chatModel,\n      ObservedChatClientBuilder observedChatClientBuilder,\n      LangfusePromptService langfusePromptService\n  ) {\n    \u002F\u002F ReloadableChatClient enables zero-downtime hot-swapping of prompt updates\n    return new ReloadableChatClient(SIGNAL_EVALUATION_PROMPT_NAME, () ->\n        observedChatClientBuilder.from(chatModel, \"signal-evaluation\")\n            \u002F\u002F Dynamically loads from Langfuse with fallback to local classpath\n            .defaultSystem(\n                langfusePromptService.getPrompt(SIGNAL_EVALUATION_PROMPT_NAME, systemPrompt))\n            .defaultOptions(GoogleGenAiChatOptions.builder()\n                .model(IntelligenceLevel.MEDIUM.model)\n                .includeThoughts(false))\n            .defaultAdvisors(\n                \u002F\u002F Links OTel spans and Langfuse generation traces to this prompt & version\n                new LangfusePromptObservationAdvisor(SIGNAL_EVALUATION_PROMPT_NAME,\n                    langfusePromptService)\n            )\n            .build()\n    );\n  }\n}\n","java",[491,796,797,810,826,833,868,873,882,898,929,940,951,960,968,975,1002,1029,1035,1046,1068,1089,1114,1125,1135,1141,1156,1164,1170,1180,1186,1192],{"__ignoreMap":656},[798,799,802,806],"span",{"class":800,"line":801},"line",1,[798,803,805],{"class":804},"sMK4o","@",[798,807,809],{"class":808},"spNyl","Configuration\n",[798,811,813,816,819,823],{"class":800,"line":812},2,[798,814,815],{"class":808},"public",[798,817,818],{"class":808}," class",[798,820,822],{"class":821},"sBMFI"," SignalGenerationAgentConfig",[798,824,825],{"class":804}," {\n",[798,827,829],{"class":800,"line":828},3,[798,830,832],{"emptyLinePlaceholder":831},true,"\n",[798,834,836,839,842,845,848,852,855,858,862,865],{"class":800,"line":835},4,[798,837,838],{"class":808},"  private",[798,840,841],{"class":808}," static",[798,843,844],{"class":808}," final",[798,846,847],{"class":808}," String",[798,849,851],{"class":850},"sTEyZ"," SIGNAL_EVALUATION_PROMPT_NAME ",[798,853,854],{"class":804},"=",[798,856,857],{"class":804}," \"",[798,859,861],{"class":860},"sfazB","signal-evaluation",[798,863,864],{"class":804},"\"",[798,866,867],{"class":804},";\n",[798,869,871],{"class":800,"line":870},5,[798,872,832],{"emptyLinePlaceholder":831},[798,874,876,879],{"class":800,"line":875},6,[798,877,878],{"class":804},"  @",[798,880,881],{"class":808},"Bean\n",[798,883,885,888,891,895],{"class":800,"line":884},7,[798,886,887],{"class":808},"  public",[798,889,890],{"class":808}," ChatClient",[798,892,894],{"class":893},"s2Zo4"," signalEvaluationAgent",[798,896,897],{"class":804},"(\n",[798,899,901,904,907,910,912,915,917,919,922,926],{"class":800,"line":900},8,[798,902,903],{"class":804},"      @",[798,905,906],{"class":808},"Value",[798,908,909],{"class":804},"(",[798,911,864],{"class":804},[798,913,914],{"class":860},"classpath:intelligence\u002Fprompts\u002Finsights\u002Fsignal-evaluation.st",[798,916,864],{"class":804},[798,918,566],{"class":804},[798,920,921],{"class":808}," Resource",[798,923,925],{"class":924},"sHdIc"," systemPrompt",[798,927,928],{"class":804},",\n",[798,930,932,935,938],{"class":800,"line":931},9,[798,933,934],{"class":808},"      GoogleGenAiChatModel",[798,936,937],{"class":924}," chatModel",[798,939,928],{"class":804},[798,941,943,946,949],{"class":800,"line":942},10,[798,944,945],{"class":808},"      ObservedChatClientBuilder",[798,947,948],{"class":924}," observedChatClientBuilder",[798,950,928],{"class":804},[798,952,954,957],{"class":800,"line":953},11,[798,955,956],{"class":808},"      LangfusePromptService",[798,958,959],{"class":924}," langfusePromptService\n",[798,961,963,966],{"class":800,"line":962},12,[798,964,965],{"class":804},"  )",[798,967,825],{"class":804},[798,969,971],{"class":800,"line":970},13,[798,972,974],{"class":973},"sHwdD","    \u002F\u002F ReloadableChatClient enables zero-downtime hot-swapping of prompt updates\n",[798,976,978,982,985,988,990,993,996,999],{"class":800,"line":977},14,[798,979,981],{"class":980},"s7zQu","    return",[798,983,984],{"class":980}," new",[798,986,987],{"class":893}," ReloadableChatClient",[798,989,909],{"class":804},[798,991,992],{"class":850},"SIGNAL_EVALUATION_PROMPT_NAME",[798,994,995],{"class":804},",",[798,997,998],{"class":804}," ()",[798,1000,1001],{"class":808}," ->\n",[798,1003,1005,1008,1010,1013,1015,1018,1020,1022,1024,1026],{"class":800,"line":1004},15,[798,1006,1007],{"class":850},"        observedChatClientBuilder",[798,1009,531],{"class":804},[798,1011,1012],{"class":893},"from",[798,1014,909],{"class":804},[798,1016,1017],{"class":850},"chatModel",[798,1019,995],{"class":804},[798,1021,857],{"class":804},[798,1023,861],{"class":860},[798,1025,864],{"class":804},[798,1027,1028],{"class":804},")\n",[798,1030,1032],{"class":800,"line":1031},16,[798,1033,1034],{"class":973},"            \u002F\u002F Dynamically loads from Langfuse with fallback to local classpath\n",[798,1036,1038,1041,1044],{"class":800,"line":1037},17,[798,1039,1040],{"class":804},"            .",[798,1042,1043],{"class":893},"defaultSystem",[798,1045,897],{"class":804},[798,1047,1049,1052,1054,1057,1059,1061,1063,1065],{"class":800,"line":1048},18,[798,1050,1051],{"class":850},"                langfusePromptService",[798,1053,531],{"class":804},[798,1055,1056],{"class":893},"getPrompt",[798,1058,909],{"class":804},[798,1060,992],{"class":850},[798,1062,995],{"class":804},[798,1064,925],{"class":850},[798,1066,1067],{"class":804},"))\n",[798,1069,1071,1073,1076,1078,1081,1083,1086],{"class":800,"line":1070},19,[798,1072,1040],{"class":804},[798,1074,1075],{"class":893},"defaultOptions",[798,1077,909],{"class":804},[798,1079,1080],{"class":850},"GoogleGenAiChatOptions",[798,1082,531],{"class":804},[798,1084,1085],{"class":893},"builder",[798,1087,1088],{"class":804},"()\n",[798,1090,1092,1095,1098,1100,1103,1105,1108,1110,1112],{"class":800,"line":1091},20,[798,1093,1094],{"class":804},"                .",[798,1096,1097],{"class":893},"model",[798,1099,909],{"class":804},[798,1101,1102],{"class":850},"IntelligenceLevel",[798,1104,531],{"class":804},[798,1106,1107],{"class":850},"MEDIUM",[798,1109,531],{"class":804},[798,1111,1097],{"class":850},[798,1113,1028],{"class":804},[798,1115,1117,1119,1122],{"class":800,"line":1116},21,[798,1118,1094],{"class":804},[798,1120,1121],{"class":893},"includeThoughts",[798,1123,1124],{"class":804},"(false))\n",[798,1126,1128,1130,1133],{"class":800,"line":1127},22,[798,1129,1040],{"class":804},[798,1131,1132],{"class":893},"defaultAdvisors",[798,1134,897],{"class":804},[798,1136,1138],{"class":800,"line":1137},23,[798,1139,1140],{"class":973},"                \u002F\u002F Links OTel spans and Langfuse generation traces to this prompt & version\n",[798,1142,1144,1147,1150,1152,1154],{"class":800,"line":1143},24,[798,1145,1146],{"class":980},"                new",[798,1148,1149],{"class":893}," LangfusePromptObservationAdvisor",[798,1151,909],{"class":804},[798,1153,992],{"class":850},[798,1155,928],{"class":804},[798,1157,1159,1162],{"class":800,"line":1158},25,[798,1160,1161],{"class":850},"                    langfusePromptService",[798,1163,1028],{"class":804},[798,1165,1167],{"class":800,"line":1166},26,[798,1168,1169],{"class":804},"            )\n",[798,1171,1173,1175,1178],{"class":800,"line":1172},27,[798,1174,1040],{"class":804},[798,1176,1177],{"class":893},"build",[798,1179,1088],{"class":804},[798,1181,1183],{"class":800,"line":1182},28,[798,1184,1185],{"class":804},"    );\n",[798,1187,1189],{"class":800,"line":1188},29,[798,1190,1191],{"class":804},"  }\n",[798,1193,1195],{"class":800,"line":1194},30,[798,1196,1197],{"class":804},"}\n",[591,1199,1201],{"id":1200},"_3-calling-the-agent-service-in-java","3. Calling the Agent Service in Java",[460,1203,1204,1205,1207,1208,1214,1215,728,1218,1221],{},"Inject your configured ",[491,1206,784],{}," bean into your service (e.g., ",[485,1209,1211],{"href":1210},"file:\u002F\u002F\u002Fc:\u002Fdevelopment\u002Fbackend\u002Fapplications\u002Fesp-platform\u002Fsrc\u002Fmain\u002Fjava\u002Fcom\u002Fesprofiler\u002Fplatform\u002Finsight\u002Fservice\u002FSignalGenerationService.java",[491,1212,1213],{},"SignalGenerationService.java","), passing parameters into the prompt using ",[491,1216,1217],{},".system(s -> s.param(...))",[491,1219,1220],{},".system(s -> s.params(map))",":",[650,1223,1225],{"className":792,"code":1224,"language":794,"meta":656,"style":656},"package com.esprofiler.platform.insight.service;\n\nimport com.esprofiler.platform.insight.dto.SignalGenerationResponses.SignalMatchResponse;\nimport com.esprofiler.platform.insight.entity.FindingEntity;\nimport com.esprofiler.platform.insight.entity.SignalEntity;\nimport java.util.List;\nimport lombok.RequiredArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\nimport org.springframework.ai.chat.client.ChatClient;\nimport org.springframework.beans.factory.annotation.Qualifier;\nimport org.springframework.stereotype.Service;\n\n@Slf4j\n@Service\n@RequiredArgsConstructor\npublic class SignalGenerationService {\n\n  @Qualifier(\"signalEvaluationAgent\")\n  private final ChatClient signalEvaluationAgent;\n\n  public SignalMatchResponse evaluateFinding(FindingEntity finding, List\u003CSignalEntity> candidates) {\n    return signalEvaluationAgent.prompt()\n        \u002F\u002F Passes 'finding' object and 'candidateSignals' collection into the template\n        .system(s -> s\n            .param(\"finding\", finding)\n            .param(\"candidateSignals\", candidates))\n        .user(\"Please evaluate this finding against the candidate signals.\")\n        .call()\n        .entity(SignalMatchResponse.class);\n  }\n}\n",[491,1226,1227,1258,1262,1298,1328,1357,1376,1390,1413,1446,1478,1500,1504,1511,1518,1525,1536,1540,1557,1569,1573,1610,1623,1628,1647,1669,1690,1708,1717,1735,1739],{"__ignoreMap":656},[798,1228,1229,1233,1236,1238,1241,1243,1246,1248,1251,1253,1256],{"class":800,"line":801},[798,1230,1232],{"class":1231},"sbssI","package",[798,1234,1235],{"class":808}," com",[798,1237,531],{"class":804},[798,1239,1240],{"class":808},"esprofiler",[798,1242,531],{"class":804},[798,1244,1245],{"class":808},"platform",[798,1247,531],{"class":804},[798,1249,1250],{"class":808},"insight",[798,1252,531],{"class":804},[798,1254,1255],{"class":808},"service",[798,1257,867],{"class":804},[798,1259,1260],{"class":800,"line":812},[798,1261,832],{"emptyLinePlaceholder":831},[798,1263,1264,1267,1269,1271,1273,1275,1277,1279,1281,1283,1286,1288,1291,1293,1296],{"class":800,"line":828},[798,1265,1266],{"class":1231},"import",[798,1268,1235],{"class":808},[798,1270,531],{"class":804},[798,1272,1240],{"class":808},[798,1274,531],{"class":804},[798,1276,1245],{"class":808},[798,1278,531],{"class":804},[798,1280,1250],{"class":808},[798,1282,531],{"class":804},[798,1284,1285],{"class":808},"dto",[798,1287,531],{"class":804},[798,1289,1290],{"class":808},"SignalGenerationResponses",[798,1292,531],{"class":804},[798,1294,1295],{"class":808},"SignalMatchResponse",[798,1297,867],{"class":804},[798,1299,1300,1302,1304,1306,1308,1310,1312,1314,1316,1318,1321,1323,1326],{"class":800,"line":835},[798,1301,1266],{"class":1231},[798,1303,1235],{"class":808},[798,1305,531],{"class":804},[798,1307,1240],{"class":808},[798,1309,531],{"class":804},[798,1311,1245],{"class":808},[798,1313,531],{"class":804},[798,1315,1250],{"class":808},[798,1317,531],{"class":804},[798,1319,1320],{"class":808},"entity",[798,1322,531],{"class":804},[798,1324,1325],{"class":808},"FindingEntity",[798,1327,867],{"class":804},[798,1329,1330,1332,1334,1336,1338,1340,1342,1344,1346,1348,1350,1352,1355],{"class":800,"line":870},[798,1331,1266],{"class":1231},[798,1333,1235],{"class":808},[798,1335,531],{"class":804},[798,1337,1240],{"class":808},[798,1339,531],{"class":804},[798,1341,1245],{"class":808},[798,1343,531],{"class":804},[798,1345,1250],{"class":808},[798,1347,531],{"class":804},[798,1349,1320],{"class":808},[798,1351,531],{"class":804},[798,1353,1354],{"class":808},"SignalEntity",[798,1356,867],{"class":804},[798,1358,1359,1361,1364,1366,1369,1371,1374],{"class":800,"line":875},[798,1360,1266],{"class":1231},[798,1362,1363],{"class":808}," java",[798,1365,531],{"class":804},[798,1367,1368],{"class":808},"util",[798,1370,531],{"class":804},[798,1372,1373],{"class":808},"List",[798,1375,867],{"class":804},[798,1377,1378,1380,1383,1385,1388],{"class":800,"line":884},[798,1379,1266],{"class":1231},[798,1381,1382],{"class":808}," lombok",[798,1384,531],{"class":804},[798,1386,1387],{"class":808},"RequiredArgsConstructor",[798,1389,867],{"class":804},[798,1391,1392,1394,1396,1398,1401,1403,1406,1408,1411],{"class":800,"line":900},[798,1393,1266],{"class":1231},[798,1395,1382],{"class":808},[798,1397,531],{"class":804},[798,1399,1400],{"class":808},"extern",[798,1402,531],{"class":804},[798,1404,1405],{"class":808},"slf4j",[798,1407,531],{"class":804},[798,1409,1410],{"class":808},"Slf4j",[798,1412,867],{"class":804},[798,1414,1415,1417,1420,1422,1425,1427,1430,1432,1435,1437,1440,1442,1444],{"class":800,"line":931},[798,1416,1266],{"class":1231},[798,1418,1419],{"class":808}," org",[798,1421,531],{"class":804},[798,1423,1424],{"class":808},"springframework",[798,1426,531],{"class":804},[798,1428,1429],{"class":808},"ai",[798,1431,531],{"class":804},[798,1433,1434],{"class":808},"chat",[798,1436,531],{"class":804},[798,1438,1439],{"class":808},"client",[798,1441,531],{"class":804},[798,1443,784],{"class":808},[798,1445,867],{"class":804},[798,1447,1448,1450,1452,1454,1456,1458,1461,1463,1466,1468,1471,1473,1476],{"class":800,"line":942},[798,1449,1266],{"class":1231},[798,1451,1419],{"class":808},[798,1453,531],{"class":804},[798,1455,1424],{"class":808},[798,1457,531],{"class":804},[798,1459,1460],{"class":808},"beans",[798,1462,531],{"class":804},[798,1464,1465],{"class":808},"factory",[798,1467,531],{"class":804},[798,1469,1470],{"class":808},"annotation",[798,1472,531],{"class":804},[798,1474,1475],{"class":808},"Qualifier",[798,1477,867],{"class":804},[798,1479,1480,1482,1484,1486,1488,1490,1493,1495,1498],{"class":800,"line":953},[798,1481,1266],{"class":1231},[798,1483,1419],{"class":808},[798,1485,531],{"class":804},[798,1487,1424],{"class":808},[798,1489,531],{"class":804},[798,1491,1492],{"class":808},"stereotype",[798,1494,531],{"class":804},[798,1496,1497],{"class":808},"Service",[798,1499,867],{"class":804},[798,1501,1502],{"class":800,"line":962},[798,1503,832],{"emptyLinePlaceholder":831},[798,1505,1506,1508],{"class":800,"line":970},[798,1507,805],{"class":804},[798,1509,1510],{"class":808},"Slf4j\n",[798,1512,1513,1515],{"class":800,"line":977},[798,1514,805],{"class":804},[798,1516,1517],{"class":808},"Service\n",[798,1519,1520,1522],{"class":800,"line":1004},[798,1521,805],{"class":804},[798,1523,1524],{"class":808},"RequiredArgsConstructor\n",[798,1526,1527,1529,1531,1534],{"class":800,"line":1031},[798,1528,815],{"class":808},[798,1530,818],{"class":808},[798,1532,1533],{"class":821}," SignalGenerationService",[798,1535,825],{"class":804},[798,1537,1538],{"class":800,"line":1037},[798,1539,832],{"emptyLinePlaceholder":831},[798,1541,1542,1544,1546,1548,1550,1553,1555],{"class":800,"line":1048},[798,1543,878],{"class":804},[798,1545,1475],{"class":808},[798,1547,909],{"class":804},[798,1549,864],{"class":804},[798,1551,1552],{"class":860},"signalEvaluationAgent",[798,1554,864],{"class":804},[798,1556,1028],{"class":804},[798,1558,1559,1561,1563,1565,1567],{"class":800,"line":1070},[798,1560,838],{"class":808},[798,1562,844],{"class":808},[798,1564,890],{"class":808},[798,1566,894],{"class":850},[798,1568,867],{"class":804},[798,1570,1571],{"class":800,"line":1091},[798,1572,832],{"emptyLinePlaceholder":831},[798,1574,1575,1577,1580,1583,1585,1587,1590,1592,1595,1598,1600,1603,1606,1608],{"class":800,"line":1116},[798,1576,887],{"class":808},[798,1578,1579],{"class":808}," SignalMatchResponse",[798,1581,1582],{"class":893}," evaluateFinding",[798,1584,909],{"class":804},[798,1586,1325],{"class":808},[798,1588,1589],{"class":924}," finding",[798,1591,995],{"class":804},[798,1593,1594],{"class":808}," List",[798,1596,1597],{"class":804},"\u003C",[798,1599,1354],{"class":808},[798,1601,1602],{"class":804},">",[798,1604,1605],{"class":924}," candidates",[798,1607,566],{"class":804},[798,1609,825],{"class":804},[798,1611,1612,1614,1616,1618,1621],{"class":800,"line":1127},[798,1613,981],{"class":980},[798,1615,894],{"class":850},[798,1617,531],{"class":804},[798,1619,1620],{"class":893},"prompt",[798,1622,1088],{"class":804},[798,1624,1625],{"class":800,"line":1137},[798,1626,1627],{"class":973},"        \u002F\u002F Passes 'finding' object and 'candidateSignals' collection into the template\n",[798,1629,1630,1633,1636,1638,1641,1644],{"class":800,"line":1143},[798,1631,1632],{"class":804},"        .",[798,1634,1635],{"class":893},"system",[798,1637,909],{"class":804},[798,1639,1640],{"class":850},"s ",[798,1642,1643],{"class":808},"->",[798,1645,1646],{"class":850}," s\n",[798,1648,1649,1651,1654,1656,1658,1661,1663,1665,1667],{"class":800,"line":1158},[798,1650,1040],{"class":804},[798,1652,1653],{"class":893},"param",[798,1655,909],{"class":804},[798,1657,864],{"class":804},[798,1659,1660],{"class":860},"finding",[798,1662,864],{"class":804},[798,1664,995],{"class":804},[798,1666,1589],{"class":850},[798,1668,1028],{"class":804},[798,1670,1671,1673,1675,1677,1679,1682,1684,1686,1688],{"class":800,"line":1166},[798,1672,1040],{"class":804},[798,1674,1653],{"class":893},[798,1676,909],{"class":804},[798,1678,864],{"class":804},[798,1680,1681],{"class":860},"candidateSignals",[798,1683,864],{"class":804},[798,1685,995],{"class":804},[798,1687,1605],{"class":850},[798,1689,1067],{"class":804},[798,1691,1692,1694,1697,1699,1701,1704,1706],{"class":800,"line":1172},[798,1693,1632],{"class":804},[798,1695,1696],{"class":893},"user",[798,1698,909],{"class":804},[798,1700,864],{"class":804},[798,1702,1703],{"class":860},"Please evaluate this finding against the candidate signals.",[798,1705,864],{"class":804},[798,1707,1028],{"class":804},[798,1709,1710,1712,1715],{"class":800,"line":1182},[798,1711,1632],{"class":804},[798,1713,1714],{"class":893},"call",[798,1716,1088],{"class":804},[798,1718,1719,1721,1723,1725,1727,1729,1732],{"class":800,"line":1188},[798,1720,1632],{"class":804},[798,1722,1320],{"class":893},[798,1724,909],{"class":804},[798,1726,1295],{"class":850},[798,1728,531],{"class":804},[798,1730,1731],{"class":850},"class",[798,1733,1734],{"class":804},");\n",[798,1736,1737],{"class":800,"line":1194},[798,1738,1191],{"class":804},[798,1740,1742],{"class":800,"line":1741},31,[798,1743,1197],{"class":804},[591,1745,1747],{"id":1746},"_4-open-backend-pull-request","4. Open Backend Pull Request",[460,1749,1750,1751,728,1753,1756],{},"Push your branch and open a PR in ",[491,1752,780],{},[491,1754,1755],{},"esp-cps",". Follow standard code review guidelines and obtain approval.",[539,1758],{},[469,1760,1762,1763,1765],{"id":1761},"step-2-create-prompt-in-esp-prompts-repository","Step 2: Create Prompt in ",[491,1764,493],{}," Repository",[460,1767,1768,1769,531],{},"Once your backend PR is reviewed and approved, create the prompt definition in ",[485,1770,1772],{"href":487,"rel":1771},[489],[491,1773,493],{},[591,1775,1777],{"id":1776},"_1-add-the-prompt-file","1. Add the Prompt File",[460,1779,1780],{},"Place your prompt file in the corresponding folder:",[606,1782,1783,1791,1799],{},[477,1784,1785,1790],{},[480,1786,1787],{},[491,1788,1789],{},"platform\u002Fespi\u002F"," — Copilot conversation agents and skills.",[477,1792,1793,1798],{},[480,1794,1795],{},[491,1796,1797],{},"platform\u002Finsights\u002F"," — Automated findings, signals, and synthesis agents.",[477,1800,1801,1806],{},[480,1802,1803],{},[491,1804,1805],{},"cps\u002F"," — Central Provider Service categorization and mapping engines.",[460,1808,1809,1812,1813,1816,1817,728,1820,626],{},[480,1810,1811],{},"Naming Convention:"," Use short, lowercase, hyphenated names matching your ",[491,1814,1815],{},"PROMPT_NAME"," constant (e.g. ",[491,1818,1819],{},"platform\u002Finsights\u002Fsignals\u002Fmy-feature.md",[491,1821,1822],{},"platform\u002Fespi\u002Fskills\u002Fmy-feature-skill\u002FSKILL.md",[591,1824,1826,1827],{"id":1825},"_2-open-pr-in-esp-prompts","2. Open PR in ",[491,1828,493],{},[460,1830,1831,1832,1834],{},"Open a PR in ",[491,1833,493],{}," referencing your backend PR:",[650,1836,1840],{"className":1837,"code":1838,"language":1839,"meta":656,"style":656},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Relates to ES-Profiler\u002Fplatform-apim#1234\nAdds the new prompt definition for the MyFeature assistant.\n","markdown",[491,1841,1842,1847],{"__ignoreMap":656},[798,1843,1844],{"class":800,"line":801},[798,1845,1846],{},"Relates to ES-Profiler\u002Fplatform-apim#1234\n",[798,1848,1849],{"class":800,"line":812},[798,1850,1851],{},"Adds the new prompt definition for the MyFeature assistant.\n",[591,1853,1855,1856,1859],{"id":1854},"_3-merge-to-main-automatic-staging-sync","3. Merge to ",[491,1857,1858],{},"main"," (Automatic Staging Sync)",[460,1861,1862,1863,777,1865,1867,1868,1221],{},"When merged into ",[491,1864,1858],{},[491,1866,493],{},", GitHub Actions automatically triggers ",[491,1869,1870],{},".github\u002Fworkflows\u002Fsync-prompts-staging.yml",[606,1872,1873,1876,1883],{},[477,1874,1875],{},"It uploads the new prompt to Langfuse.",[477,1877,1878,1879,531],{},"Labels the version as ",[480,1880,1881],{},[491,1882,511],{},[477,1884,1885,1886,619,1889,626],{},"Applies routing tags (e.g. ",[491,1887,1888],{},"service-platform",[491,1890,1891],{},"domain-insights",[539,1893],{},[469,1895,1897],{"id":1896},"step-3-staging-verification-testing","Step 3: Staging Verification & Testing",[460,1899,1900],{},"Verify that your new prompt works end-to-end on Staging:",[474,1902,1903,1917,1920],{},[477,1904,1905,1906],{},"Deploy your backend branch\u002Fbuild to Staging with the staging label enabled:\n",[650,1907,1911],{"className":1908,"code":1909,"language":1910,"meta":656,"style":656},"language-properties shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","ESP_LANGFUSE_PROMPTS_LABEL=staging\n","properties",[491,1912,1913],{"__ignoreMap":656},[798,1914,1915],{"class":800,"line":801},[798,1916,1909],{},[477,1918,1919],{},"Trigger the feature in the staging UI or via API endpoint.",[477,1921,1922,1923,1927,1928],{},"Open the ",[485,1924,1926],{"href":503,"rel":1925},[489],"Langfuse Console",":\n",[606,1929,1930,1940],{},[477,1931,1932,1933,1936,1937,1939],{},"Under ",[480,1934,1935],{},"Prompts",", verify that your prompt appears and the ",[491,1938,511],{}," label is assigned.",[477,1941,1932,1942,1945],{},[480,1943,1944],{},"Tracing",", inspect the execution trace and confirm that the generation span is linked to your prompt name and version.",[539,1947],{},[469,1949,1951],{"id":1950},"step-4-open-a-data-task-for-benchmarking-optional-future-tbd","Step 4: Open a Data-Task for Benchmarking (Optional \u002F Future TBD)",[568,1953,1954,1957],{"icon":668},[480,1955,1956],{},"Benchmarking Status (TBD):"," Formal automated evaluation suites with the Data\u002FAI team are currently under active design. While not currently a blocking requirement for releasing prompts today, logging test scenarios helps populate the future evaluation pipeline.",[460,1959,1960],{},"If you wish to log a task for future benchmarking:",[474,1962,1963,1977],{},[477,1964,1965,1966,1969,1970,531],{},"In the repository, go to ",[480,1967,1968],{},"Issues"," > ",[485,1971,1974],{"href":1972,"rel":1973},"https:\u002F\u002Fgithub.com\u002FES-Profiler\u002Fplatform-api\u002Fissues\u002Fnew\u002Fchoose",[489],[480,1975,1976],{},"New Issue",[477,1978,1979,1980,1983],{},"Select the ",[480,1981,1982],{},"Data Benchmarking & Evaluation Task (AI \u002F Prompts)"," template:",[460,1985,1986],{},[1987,1988],"img",{"alt":1989,"src":1990},"GitHub Issue Template Selection","\u002Fimages\u002Fengineering\u002Fllm-prompts\u002Fissue-template-selection.png",[474,1992,1993],{"start":828},[477,1994,1995,1996],{},"Fill out the pre-populated form fields:\n",[606,1997,1998,2006,2017,2025,2031,2037],{},[477,1999,2000,2003,2004],{},[480,2001,2002],{},"Prompt Name in Langfuse:"," e.g. ",[491,2005,861],{},[477,2007,2008,2003,2011,2014,2015,566],{},[480,2009,2010],{},"Langfuse Version:",[491,2012,2013],{},"v1"," (currently tagged ",[491,2016,511],{},[477,2018,2019,2003,2022],{},[480,2020,2021],{},"Target Service & Related PRs:",[491,2023,2024],{},"platform-api (ES-Profiler\u002Fplatform-api#1234, ES-Profiler\u002Fesp-prompts#56)",[477,2026,2027,2030],{},[480,2028,2029],{},"Objective & Functional Role:"," Purpose, input context parameters, and expected JSON output structure.",[477,2032,2033,2036],{},[480,2034,2035],{},"Test Scenarios & Golden Dataset:"," Test cases or edge cases to populate the evaluation suite.",[477,2038,2039,2042],{},[480,2040,2041],{},"Langfuse Reference URLs:"," Direct links to the prompt in Langfuse and sample staging trace.",[460,2044,2045],{},[1987,2046],{"alt":2047,"src":2048},"GitHub Issue Form Fields","\u002Fimages\u002Fengineering\u002Fllm-prompts\u002Fissue-template-form.png",[474,2050,2051],{"start":835},[477,2052,2053,2054,676,2059,2064,2065,531],{},"The template automatically attaches the ",[480,2055,2056],{},[491,2057,2058],{},"Data",[480,2060,2061],{},[491,2062,2063],{},"Back-End"," labels. Click ",[480,2066,2067],{},"Submit new issue",[539,2069],{},[469,2071,2073],{"id":2072},"step-5-promote-prompt-to-production-release-backend","Step 5: Promote Prompt to Production & Release Backend",[460,2075,2076],{},"Once staging testing is complete:",[474,2078,2079,2115],{},[477,2080,2081,2086],{},[480,2082,2083,2084,1221],{},"Promote Prompt in ",[491,2085,493],{},[606,2087,2088,2099,2109],{},[477,2089,2090,2091,1969,2094,531],{},"Go to ",[480,2092,2093],{},"Actions",[485,2095,2098],{"href":2096,"rel":2097},"https:\u002F\u002Fgithub.com\u002FES-Profiler\u002Fesp-prompts\u002Factions\u002Fworkflows\u002Fpromote-prompts.yml",[489],"Promote Prompts to Production",[477,2100,2101,2102,2105,2106,626],{},"Enter your prompt name in the ",[491,2103,2104],{},"prompts"," input (e.g. ",[491,2107,2108],{},"my-feature",[477,2110,2111,2112,2114],{},"Run workflow. Review the dry-run plan, and have a required reviewer approve the ",[491,2113,507],{}," environment gate.",[477,2116,2117,2120],{},[480,2118,2119],{},"Release Backend Code:",[606,2121,2122,2130],{},[477,2123,2124,2125,562,2127,2129],{},"Merge and release the ",[491,2126,561],{},[491,2128,565],{}," PR.",[477,2131,2132,2133,2136],{},"Production containers boot up, query Langfuse for ",[491,2134,2135],{},"label=production",", and ingest the newly promoted prompt.",[568,2138,2139,2142,2143,2145,2146,2150,2151,2154,2155,2157],{"icon":668},[480,2140,2141],{},"How Version Promotion Works:"," The promotion workflow does ",[480,2144,577],{}," blindly promote the latest unverified version number. Instead, it explicitly targets the version currently tagged with the ",[480,2147,2148],{},[491,2149,511],{}," label (the version you tested), prints a dry-run diff in the ",[491,2152,2153],{},"plan"," step, and applies the ",[491,2156,507],{}," label only after review approval.",[539,2159],{},[455,2161,2163],{"id":2162},"modifying-existing-prompts","Modifying Existing Prompts",[460,2165,2166,2167,728,2170,531],{},"When modifying a prompt that already exists in production, determine whether the change is ",[480,2168,2169],{},"prompt-content only",[480,2171,2172],{},"requires backend code changes",[469,2174,551],{"id":2175},"workflow-summary-1",[464,2177],{":zoom":466,"code":2178},"graph TD\n    Start{\"Modifying an Existing Prompt\"}:::agent\n\n    ScenA(\"\u003Cdiv align='left'>\u003Cb>Scenario A: Content-Only\u003C\u002Fb>\u003Cbr\u002F>Tuning wording, system instructions,\u003Cbr\u002F>few-shot examples, reasoning steps\u003C\u002Fdiv>\"):::infra\n    ScenB(\"\u003Cdiv align='left'>\u003Cb>Scenario B: With Code Changes\u003C\u002Fb>\u003Cbr\u002F>Adding\u002Fremoving template variables,\u003Cbr\u002F>changing DTO schema, modifying tools\u003C\u002Fdiv>\"):::infra\n\n    BCode(\"\u003Cdiv align='left'>\u003Cb>1. Update .st fallback & Java code\u003C\u002Fb>\u003Cbr\u002F>\u003Cb>2. Open PR in platform-api \u002F api-cps\u003C\u002Fb>\u003C\u002Fdiv>\"):::domain\n\n    Sync(\"\u003Cdiv align='left'>\u003Cb>1. Edit prompt file in esp-prompts\u003C\u002Fb>\u003Cbr\u002F>\u003Cb>2. Open PR in esp-prompts\u003C\u002Fb>\u003Cbr\u002F>\u003Cb>3. Merge to main → auto-syncs with staging label\u003C\u002Fb>\u003C\u002Fdiv>\"):::client\n\n    Stage(\"\u003Cdiv align='left'>\u003Cb>2. Test changes on Staging\u003C\u002Fb>\u003Cbr\u002F>ESP_LANGFUSE_PROMPTS_LABEL=staging\u003C\u002Fdiv>\"):::infra\n\n    Promote(\"\u003Cdiv align='left'>\u003Cb>3. Promote prompt to Production via\u003C\u002Fb>\u003Cbr\u002F>GitHub Action in esp-prompts\u003C\u002Fdiv>\"):::agent\n\n    Ingest(\"\u003Cdiv align='left'>\u003Cb>4. Ingest Prompt Updates:\u003C\u002Fb>\u003Cbr\u002F>• Automatic: Quartz (Every 20 mins)\u003Cbr\u002F>• OR Instant: PATCH \u002Fapi\u002Fv1\u002Fschedules\u002Frun\u003C\u002Fdiv>\"):::domain\n\n    Start -->|Content Only| ScenA\n    Start -->|Code Changes| ScenB\n    ScenB --> BCode\n    BCode --> Sync\n    ScenA --> Sync\n    Sync --> Stage\n    Stage --> Promote\n    Promote --> Ingest\n",[539,2180],{},[469,2182,2184],{"id":2183},"step-1-determine-modification-type-content-only-vs-code-changes","Step 1: Determine Modification Type (Content-Only vs Code Changes)",[591,2186,2188],{"id":2187},"scenario-a-content-only-modification-zero-downtime-no-backend-redeploy","Scenario A: Content-Only Modification (Zero-Downtime, No Backend Redeploy)",[460,2190,2191],{},"If you are refining prompt instructions, improving persona prompts, tuning few-shot examples, or reducing hallucinations:",[474,2193,2194,2205,2211],{},[477,2195,2196,2197,2199,2200,728,2202,2204],{},"You do ",[480,2198,577],{}," need to touch ",[491,2201,561],{},[491,2203,565],{}," code immediately.",[477,2206,2207,2208,2210],{},"Go directly to ",[491,2209,493],{}," and edit the markdown prompt file.",[477,2212,1831,2213,531],{},[491,2214,493],{},[591,2216,2218],{"id":2217},"scenario-b-modification-with-backend-code-changes","Scenario B: Modification with Backend Code Changes",[460,2220,2221,2222,2225],{},"If your prompt change involves adding\u002Fremoving StringTemplate variables (e.g. ",[491,2223,2224],{},"\u003CnewVariable>","), altering input\u002Foutput JSON DTOs, or changing tool calls:",[474,2227,2228,2239,2246],{},[477,2229,2230,2231,2233,2234,728,2236,2238],{},"Update the fallback ",[491,2232,588],{}," file in ",[491,2235,561],{},[491,2237,565],{}," and modify the corresponding Java classes.",[477,2240,1831,2241,562,2243,2245],{},[491,2242,561],{},[491,2244,565],{}," and obtain review approval.",[477,2247,2248,2249,2251,2252,531],{},"Update the prompt file in ",[491,2250,493],{}," to match the new variable schema and open a matching PR in ",[491,2253,493],{},[539,2255],{},[469,2257,2259,2260,777,2262,2264],{"id":2258},"step-2-merge-to-main-in-esp-prompts-staging-sync","Step 2: Merge to ",[491,2261,1858],{},[491,2263,493],{}," (Staging Sync)",[460,2266,2267,2268,2270,2271,2273,2274,2277],{},"When your ",[491,2269,493],{}," PR merges to ",[491,2272,1858],{},", the ",[491,2275,2276],{},"sync-prompts-staging.yml"," workflow triggers automatically:",[606,2279,2280,2291,2299],{},[477,2281,2282,2283,2286,2287,2290],{},"Langfuse creates a ",[480,2284,2285],{},"new version"," (e.g. ",[491,2288,2289],{},"v3",") with your updated prompt.",[477,2292,2293,2294,2298],{},"The ",[480,2295,2296],{},[491,2297,511],{}," label moves to this new version.",[477,2300,2293,2301,2305,2306,626],{},[480,2302,2303],{},[491,2304,507],{}," label remains untouched on the existing live version (e.g. ",[491,2307,2308],{},"v2",[650,2310,2313],{"className":2311,"code":2312,"language":655},[653],"Before Sync:   staging -> v2 (live)      production -> v2 (live)\nAfter Sync:    staging -> v3 (updated)   production -> v2 (live)\n",[491,2314,2312],{"__ignoreMap":656},[539,2316],{},[469,2318,2320],{"id":2319},"step-3-verify-on-staging","Step 3: Verify on Staging",[474,2322,2323,2330],{},[477,2324,2325,2326,2329],{},"On the Staging environment (",[491,2327,2328],{},"ESP_LANGFUSE_PROMPTS_LABEL=staging","), execute the modified workflow.",[477,2331,2332,2333,2337,2338],{},"Check the ",[485,2334,2336],{"href":503,"rel":2335},[489],"Langfuse Tracing dashboard"," to verify:\n",[606,2339,2340,2348],{},[477,2341,2342,2343,2345,2346,626],{},"The trace links to the new ",[491,2344,511],{}," version number (e.g. ",[491,2347,2289],{},[477,2349,2350],{},"The LLM response meets expectations and adheres to formatting.",[539,2352],{},[469,2354,2356],{"id":2355},"step-4-promote-prompt-to-production","Step 4: Promote Prompt to Production",[474,2358,2359,2368,2376],{},[477,2360,2090,2361,777,2363,1969,2365,531],{},[480,2362,2093],{},[491,2364,493],{},[485,2366,2098],{"href":2096,"rel":2367},[489],[477,2369,2370,2371,2105,2373,2375],{},"Enter the specific prompt name in the ",[491,2372,2104],{},[491,2374,2108],{},") to promote only the targeted prompt.",[477,2377,2378,2379,1927,2382],{},"Click ",[480,2380,2381],{},"Run workflow",[606,2383,2384,2391,2399],{},[477,2385,2293,2386,2390],{},[480,2387,2388],{},[491,2389,2153],{}," job prints a dry-run diff of the versions that will move.",[477,2392,2393,2394,2398],{},"The workflow pauses at the ",[480,2395,2396],{},[491,2397,507],{}," environment review gate.",[477,2400,2401,2402,531],{},"Once approved, the job copies the staging version and labels it ",[480,2403,2404],{},[491,2405,507],{},[650,2407,2410],{"className":2408,"code":2409,"language":655},[653],"After Promotion:   staging -> v3             production -> v4 (copy of v3)\n",[491,2411,2409],{"__ignoreMap":656},[568,2413,2414,2417,2418,2422,2423,2425],{"icon":668},[480,2415,2416],{},"Targeting the Verified Version:"," Promotion does not select untracked or raw drafts; it targets the specific version currently tagged with ",[480,2419,2420],{},[491,2421,511],{},", allowing you to inspect the version diff during the ",[491,2424,2153],{}," step prior to approval.",[539,2427],{},[469,2429,2431],{"id":2430},"step-5-ingest-prompt-updates-automatic-vs-instant-refresh","Step 5: Ingest Prompt Updates (Automatic vs Instant Refresh)",[460,2433,2434],{},"After promoting a prompt in Langfuse, backend services pick up the change without restarting:",[474,2436,2437,2447],{},[477,2438,2439,2442,2443,2446],{},[480,2440,2441],{},"Automatic Quartz Refresh:"," The backend background job runs every ",[480,2444,2445],{},"20 minutes"," and automatically fetches updated prompt versions.",[477,2448,2449,2452],{},[480,2450,2451],{},"Instant Manual Trigger:"," If you need the change to take effect immediately without waiting for the 20-minute timer, trigger the prompt refresh Quartz job via the API endpoint:",[650,2454,2458],{"className":2455,"code":2456,"language":2457,"meta":656,"style":656},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X PATCH \"https:\u002F\u002Fplatform.esprofiler.com\u002Fapi\u002Fv1\u002Fschedules\u002Frun\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"Authorization: Bearer \u003CAPI_OR_SSO_TOKEN>\" \\\n  -d '{\n    \"jobName\": \"langfusePromptRefreshJob\",\n    \"groupName\": \"DEFAULT\"\n  }'\n","bash",[491,2459,2460,2481,2495,2508,2519,2524,2529],{"__ignoreMap":656},[798,2461,2462,2465,2468,2471,2473,2476,2478],{"class":800,"line":801},[798,2463,2464],{"class":821},"curl",[798,2466,2467],{"class":860}," -X",[798,2469,2470],{"class":860}," PATCH",[798,2472,857],{"class":804},[798,2474,2475],{"class":860},"https:\u002F\u002Fplatform.esprofiler.com\u002Fapi\u002Fv1\u002Fschedules\u002Frun",[798,2477,864],{"class":804},[798,2479,2480],{"class":850}," \\\n",[798,2482,2483,2486,2488,2491,2493],{"class":800,"line":812},[798,2484,2485],{"class":860},"  -H",[798,2487,857],{"class":804},[798,2489,2490],{"class":860},"Content-Type: application\u002Fjson",[798,2492,864],{"class":804},[798,2494,2480],{"class":850},[798,2496,2497,2499,2501,2504,2506],{"class":800,"line":828},[798,2498,2485],{"class":860},[798,2500,857],{"class":804},[798,2502,2503],{"class":860},"Authorization: Bearer \u003CAPI_OR_SSO_TOKEN>",[798,2505,864],{"class":804},[798,2507,2480],{"class":850},[798,2509,2510,2513,2516],{"class":800,"line":835},[798,2511,2512],{"class":860},"  -d",[798,2514,2515],{"class":804}," '",[798,2517,2518],{"class":860},"{\n",[798,2520,2521],{"class":800,"line":870},[798,2522,2523],{"class":860},"    \"jobName\": \"langfusePromptRefreshJob\",\n",[798,2525,2526],{"class":800,"line":875},[798,2527,2528],{"class":860},"    \"groupName\": \"DEFAULT\"\n",[798,2530,2531,2534],{"class":800,"line":884},[798,2532,2533],{"class":860},"  }",[798,2535,2536],{"class":804},"'\n",[568,2538,2540,2543,2544,2546],{"icon":2539},"i-lucide-check-circle",[480,2541,2542],{},"Zero-Downtime Live Update:"," For content-only changes (Scenario A), ",[491,2545,561],{}," updates its RAM and disk cache immediately upon running the schedule action. No container restart or deployment is required!",[539,2548],{},[455,2550,2552],{"id":2551},"quartz-scheduled-ingestion-manual-refresh-api","Quartz Scheduled Ingestion & Manual Refresh API",[469,2554,2556],{"id":2555},"quartz-background-job-configuration","Quartz Background Job Configuration",[460,2558,2559],{},"Backend services run a background Quartz job dedicated to refreshing dynamic prompts:",[2561,2562,2563,2579],"table",{},[2564,2565,2566],"thead",{},[2567,2568,2569,2573,2576],"tr",{},[2570,2571,2572],"th",{},"Attribute",[2570,2574,2575],{},"Value \u002F Default",[2570,2577,2578],{},"Description",[2580,2581,2582,2598,2613,2628,2646,2664,2679],"tbody",{},[2567,2583,2584,2590,2595],{},[2585,2586,2587],"td",{},[480,2588,2589],{},"Job Name",[2585,2591,2592],{},[491,2593,2594],{},"langfusePromptRefreshJob",[2585,2596,2597],{},"Identifier of the Quartz job bean.",[2567,2599,2600,2605,2610],{},[2585,2601,2602],{},[480,2603,2604],{},"Job Group",[2585,2606,2607],{},[491,2608,2609],{},"DEFAULT",[2585,2611,2612],{},"Quartz job group.",[2567,2614,2615,2620,2625],{},[2585,2616,2617],{},[480,2618,2619],{},"Trigger Name",[2585,2621,2622],{},[491,2623,2624],{},"Langfuse Prompt Refresh Trigger",[2585,2626,2627],{},"Quartz trigger bean name.",[2567,2629,2630,2635,2643],{},[2585,2631,2632],{},[480,2633,2634],{},"Startup Delay",[2585,2636,2637,725,2640,566],{},[491,2638,2639],{},"15 minutes",[491,2641,2642],{},"TimeUnit.MINUTES.toMillis(15)",[2585,2644,2645],{},"Initial delay after server boot before first periodic sweep.",[2567,2647,2648,2653,2661],{},[2585,2649,2650],{},[480,2651,2652],{},"Repeat Interval",[2585,2654,2655,725,2657,2660],{},[491,2656,2445],{},[491,2658,2659],{},"1200000"," ms)",[2585,2662,2663],{},"Frequency of automatic prompt refresh sweeps.",[2567,2665,2666,2671,2676],{},[2585,2667,2668],{},[480,2669,2670],{},"Configuration Property",[2585,2672,2673],{},[491,2674,2675],{},"esp.langfuse.prompts.refresh-interval-ms",[2585,2677,2678],{},"Config property to customize the repeat interval.",[2567,2680,2681,2686,2691],{},[2585,2682,2683],{},[480,2684,2685],{},"Environment Variable",[2585,2687,2688],{},[491,2689,2690],{},"ESP_LANGFUSE_PROMPTS_REFRESH_INTERVAL_MS",[2585,2692,2693],{},"Override via container environment variable.",[469,2695,2697],{"id":2696},"triggering-manual-prompt-refresh-via-api","Triggering Manual Prompt Refresh via API",[460,2699,2700,2701,2703],{},"You can trigger ",[491,2702,2594],{}," at any time using the Schedule Management API:",[606,2705,2706,2715,2723,2741],{},[477,2707,2708,2711,2712],{},[480,2709,2710],{},"Endpoint:"," ",[491,2713,2714],{},"PATCH \u002Fapi\u002Fv1\u002Fschedules\u002Frun",[477,2716,2717,2711,2720],{},[480,2718,2719],{},"Controller:",[491,2721,2722],{},"ScheduleController.admScheduleRunAction",[477,2724,2725,2728,2729,2732,2733,725,2738,566],{},[480,2726,2727],{},"Swagger UI:"," Accessible at ",[491,2730,2731],{},"\u002Fapi\u002Fv1\u002Fdocs\u002Fui"," under tag ",[480,2734,2735],{},[491,2736,2737],{},"Z1 - Schedule Management",[491,2739,2740],{},"Z2.02 -- admScheduleRunAction",[477,2742,2743,2746,2747,2750,2751,531],{},[480,2744,2745],{},"Security:"," Requires ",[491,2748,2749],{},"ESP-SSO"," authentication or ",[491,2752,2753],{},"X-API-KEY",[591,2755,2757],{"id":2756},"request-example-json","Request Example (JSON)",[650,2759,2763],{"className":2760,"code":2761,"language":2762,"meta":656,"style":656},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","PATCH \u002Fapi\u002Fv1\u002Fschedules\u002Frun HTTP\u002F1.1\nHost: platform.esprofiler.com\nContent-Type: application\u002Fjson\nAuthorization: Bearer \u003CAUTH_TOKEN>\n\n{\n  \"jobName\": \"langfusePromptRefreshJob\",\n  \"groupName\": \"DEFAULT\"\n}\n","http",[491,2764,2765,2770,2775,2780,2785,2789,2793,2798,2803],{"__ignoreMap":656},[798,2766,2767],{"class":800,"line":801},[798,2768,2769],{},"PATCH \u002Fapi\u002Fv1\u002Fschedules\u002Frun HTTP\u002F1.1\n",[798,2771,2772],{"class":800,"line":812},[798,2773,2774],{},"Host: platform.esprofiler.com\n",[798,2776,2777],{"class":800,"line":828},[798,2778,2779],{},"Content-Type: application\u002Fjson\n",[798,2781,2782],{"class":800,"line":835},[798,2783,2784],{},"Authorization: Bearer \u003CAUTH_TOKEN>\n",[798,2786,2787],{"class":800,"line":870},[798,2788,832],{"emptyLinePlaceholder":831},[798,2790,2791],{"class":800,"line":875},[798,2792,2518],{},[798,2794,2795],{"class":800,"line":884},[798,2796,2797],{},"  \"jobName\": \"langfusePromptRefreshJob\",\n",[798,2799,2800],{"class":800,"line":900},[798,2801,2802],{},"  \"groupName\": \"DEFAULT\"\n",[798,2804,2805],{"class":800,"line":931},[798,2806,1197],{},[591,2808,2810],{"id":2809},"success-response","Success Response",[650,2812,2816],{"className":2813,"code":2814,"language":2815,"meta":656,"style":656},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"success\": true,\n  \"message\": \"Task run request processed!\"\n}\n","json",[491,2817,2818,2822,2837,2856],{"__ignoreMap":656},[798,2819,2820],{"class":800,"line":801},[798,2821,2518],{"class":804},[798,2823,2824,2827,2830,2832,2834],{"class":800,"line":812},[798,2825,2826],{"class":804},"  \"",[798,2828,2829],{"class":808},"success",[798,2831,864],{"class":804},[798,2833,1221],{"class":804},[798,2835,2836],{"class":804}," true,\n",[798,2838,2839,2841,2844,2846,2848,2850,2853],{"class":800,"line":828},[798,2840,2826],{"class":804},[798,2842,2843],{"class":808},"message",[798,2845,864],{"class":804},[798,2847,1221],{"class":804},[798,2849,857],{"class":804},[798,2851,2852],{"class":860},"Task run request processed!",[798,2854,2855],{"class":804},"\"\n",[798,2857,2858],{"class":800,"line":835},[798,2859,1197],{"class":804},[539,2861],{},[539,2863],{},[455,2865,2867],{"id":2866},"technical-reference-best-practices","Technical Reference & Best Practices",[469,2869,2871],{"id":2870},"environment-configuration-target-labels","Environment Configuration & Target Labels",[460,2873,2874,2875,2877,2878,743],{},"Backend services configure which prompt versions to fetch via the ",[491,2876,724],{}," environment variable (mapped to ",[491,2879,2880],{},"esp.langfuse.prompts.label",[2561,2882,2883,2898],{},[2564,2884,2885],{},[2567,2886,2887,2890,2895],{},[2570,2888,2889],{},"Environment",[2570,2891,2892,2893,566],{},"Configured Label (",[491,2894,724],{},[2570,2896,2897],{},"Behavior & Purpose",[2580,2899,2900,2928,2949],{},[2567,2901,2902,2910,2914],{},[2585,2903,2904],{},[480,2905,2906,2907,566],{},"Staging (",[491,2908,2909],{},"stage",[2585,2911,2912],{},[491,2913,511],{},[2585,2915,2916,2922,2923,777,2925,2927],{},[480,2917,2918,2919,2921],{},"Always reads ",[491,2920,511],{}," prompts."," Picks up the latest prompts merged into ",[491,2924,1858],{},[491,2926,493],{}," for verification before release.",[2567,2929,2930,2938,2942],{},[2585,2931,2932],{},[480,2933,2934,2935,566],{},"Production (",[491,2936,2937],{},"prod",[2585,2939,2940],{},[491,2941,507],{},[2585,2943,2944,2948],{},[480,2945,2918,2946,2921],{},[491,2947,507],{}," Strictly uses versions that have passed through the promotion review gate in GitHub Actions.",[2567,2950,2951,2960,2968],{},[2585,2952,2953],{},[480,2954,2955,2956,2959],{},"Development (",[491,2957,2958],{},"dev"," \u002F Local)",[2585,2961,2962,2711,2964],{},[491,2963,507],{},[2965,2966,2967],"em",{},"(default)",[2585,2969,2970,2975,2976,2978],{},[480,2971,2972,2973],{},"Defaults to ",[491,2974,507],{}," so local development mirrors live production behavior. Can be overridden to ",[491,2977,511],{}," in local properties or IDE run configurations to test upcoming prompts.",[650,2980,2982],{"className":1908,"code":2981,"language":1910,"meta":656,"style":656},"# Example: Switch local or test environment to read staging prompts\nESP_LANGFUSE_PROMPTS_LABEL=staging\n",[491,2983,2984,2989],{"__ignoreMap":656},[798,2985,2986],{"class":800,"line":801},[798,2987,2988],{},"# Example: Switch local or test environment to read staging prompts\n",[798,2990,2991],{"class":800,"line":812},[798,2992,1909],{},[539,2994],{},[469,2996,2998],{"id":2997},"disabling-langfuse-prompt-sync-during-local-testing","Disabling Langfuse Prompt Sync During Local Testing",[460,3000,3001],{},"When testing local prompt changes or debugging offline, you can completely disable remote Langfuse prompt synchronization:",[650,3003,3005],{"className":1908,"code":3004,"language":1910,"meta":656,"style":656},"# In application-local.properties or your IDE Environment Variables\nESP_LANGFUSE_PROMPTS_ENABLED=false\n# or in application.yml \u002F properties:\nesp.langfuse.prompts.enabled=false\n",[491,3006,3007,3012,3017,3022],{"__ignoreMap":656},[798,3008,3009],{"class":800,"line":801},[798,3010,3011],{},"# In application-local.properties or your IDE Environment Variables\n",[798,3013,3014],{"class":800,"line":812},[798,3015,3016],{},"ESP_LANGFUSE_PROMPTS_ENABLED=false\n",[798,3018,3019],{"class":800,"line":828},[798,3020,3021],{},"# or in application.yml \u002F properties:\n",[798,3023,3024],{"class":800,"line":835},[798,3025,3026],{},"esp.langfuse.prompts.enabled=false\n",[591,3028,3030],{"id":3029},"what-happens-when-prompt-sync-is-disabled","What happens when prompt sync is disabled?",[474,3032,3033,3041,3053,3059],{},[477,3034,3035,2711,3038,3040],{},[480,3036,3037],{},"Zero Remote Calls:",[491,3039,584],{}," completely skips remote HTTP requests to Langfuse.",[477,3042,3043,3046,3047,3049,3050,3052],{},[480,3044,3045],{},"Direct Classpath Fallback:"," Services immediately use your local ",[491,3048,588],{}," template files from ",[491,3051,614],{}," on every invocation.",[477,3054,3055,3058],{},[480,3056,3057],{},"Bypasses Cache:"," Disk cache reads\u002Fwrites and Quartz periodic refresh sweeps are bypassed.",[477,3060,3061,3064,3065,3067],{},[480,3062,3063],{},"Instant Iteration:"," You can modify your local ",[491,3066,588],{}," file and test changes immediately without any remote sync or cache invalidation.",[539,3069],{},[469,3071,3073],{"id":3072},"langfuse-labels-tags-reference","Langfuse Labels & Tags Reference",[591,3075,3077],{"id":3076},"_1-version-labels-prompt-routing","1. Version Labels (Prompt Routing)",[2561,3079,3080,3095],{},[2564,3081,3082],{},[2567,3083,3084,3087,3090,3093],{},[2570,3085,3086],{},"Label",[2570,3088,3089],{},"Managed By",[2570,3091,3092],{},"Environment Target",[2570,3094,2578],{},[2580,3096,3097,3120,3143],{},[2567,3098,3099,3105,3109,3113],{},[2585,3100,3101],{},[480,3102,3103],{},[491,3104,511],{},[2585,3106,3107],{},[491,3108,2276],{},[2585,3110,2906,3111,566],{},[491,3112,2909],{},[2585,3114,3115,3116,777,3118,531],{},"Automatically assigned when a PR merges into ",[491,3117,1858],{},[491,3119,493],{},[2567,3121,3122,3128,3133,3140],{},[2585,3123,3124],{},[480,3125,3126],{},[491,3127,507],{},[2585,3129,3130],{},[491,3131,3132],{},"promote-prompts.yml",[2585,3134,2934,3135,3137,3138,566],{},[491,3136,2937],{},"), Dev (",[491,3139,2958],{},[2585,3141,3142],{},"Assigned when a prompt is approved and promoted via the GitHub Action.",[2567,3144,3145,3152,3155,3160],{},[2585,3146,3147],{},[480,3148,3149],{},[491,3150,3151],{},"latest",[2585,3153,3154],{},"Langfuse Internal",[2585,3156,3157],{},[2965,3158,3159],{},"None",[2585,3161,3162,3163],{},"Internal Langfuse pointer to the newest draft. ",[480,3164,3165],{},"DO NOT USE in application code.",[591,3167,3169],{"id":3168},"_2-metadata-tags-filtering-categorization","2. Metadata Tags (Filtering & Categorization)",[460,3171,3172],{},"Prompts in Langfuse are automatically tagged during CI sync to allow easy filtering:",[606,3174,3175,3196],{},[477,3176,3177,3180],{},[480,3178,3179],{},"Service Tags:",[606,3181,3182,3189],{},[477,3183,3184,3186,3187,531],{},[491,3185,1888],{}," — Prompts consumed by ",[491,3188,561],{},[477,3190,3191,3186,3194,531],{},[491,3192,3193],{},"service-cps",[491,3195,565],{},[477,3197,3198,3201],{},[480,3199,3200],{},"Domain \u002F Subsystem Tags:",[606,3202,3203,3208,3214,3220],{},[477,3204,3205,3207],{},[491,3206,1891],{}," — Finding and Signal generation, emergence, and evaluation agents.",[477,3209,3210,3213],{},[491,3211,3212],{},"domain-copilot"," — Interactive chat assistants, skills, and conversation namers.",[477,3215,3216,3219],{},[491,3217,3218],{},"domain-tasks"," — Deep research, report generation, and background analyst workflows.",[477,3221,3222,3225],{},[491,3223,3224],{},"domain-changelog"," — Changelog and revision comparison agents.",[539,3227],{},[469,3229,3231],{"id":3230},"environment-variables-summary","Environment Variables Summary",[2561,3233,3234,3249],{},[2564,3235,3236],{},[2567,3237,3238,3241,3244,3247],{},[2570,3239,3240],{},"Variable",[2570,3242,3243],{},"Property",[2570,3245,3246],{},"Default",[2570,3248,2578],{},[2580,3250,3251,3275,3298,3317,3335,3357],{},[2567,3252,3253,3258,3263,3268],{},[2585,3254,3255],{},[491,3256,3257],{},"ESP_LANGFUSE_PROMPTS_ENABLED",[2585,3259,3260],{},[491,3261,3262],{},"esp.langfuse.prompts.enabled",[2585,3264,3265],{},[491,3266,3267],{},"true",[2585,3269,3270,3271,3274],{},"Enable\u002Fdisable remote Langfuse prompt fetching. Set ",[491,3272,3273],{},"false"," for offline local testing.",[2567,3276,3277,3281,3285,3289],{},[2585,3278,3279],{},[491,3280,724],{},[2585,3282,3283],{},[491,3284,2880],{},[2585,3286,3287],{},[491,3288,507],{},[2585,3290,3291,3292,3294,3295,3297],{},"Target prompt label (",[491,3293,507],{}," in Prod\u002FDev, ",[491,3296,511],{}," in Staging).",[2567,3299,3300,3305,3309,3314],{},[2585,3301,3302],{},[491,3303,3304],{},"ESP_LANGFUSE_PROMPTS_CACHE_DIR",[2585,3306,3307],{},[491,3308,747],{},[2585,3310,3311],{},[491,3312,3313],{},"resources\u002Fprompts",[2585,3315,3316],{},"Local container directory for caching fetched prompt templates on disk.",[2567,3318,3319,3323,3327,3332],{},[2585,3320,3321],{},[491,3322,2690],{},[2585,3324,3325],{},[491,3326,2675],{},[2585,3328,3329,3331],{},[491,3330,2659],{}," (20m)",[2585,3333,3334],{},"Interval in ms for the periodic Quartz background prompt refresh job.",[2567,3336,3337,3341,3346,3351],{},[2585,3338,3339],{},[491,3340,720],{},[2585,3342,3343],{},[491,3344,3345],{},"esp.llm.observation.otlp.endpoint",[2585,3347,3348],{},[491,3349,3350],{},"\"\"",[2585,3352,3353,3354,626],{},"Langfuse OTLP endpoint (e.g. ",[491,3355,3356],{},"https:\u002F\u002Fesplf.esprofiler.com\u002Fapi\u002Fpublic\u002Fotel\u002Fv1\u002Ftraces",[2567,3358,3359,3364,3369,3373],{},[2585,3360,3361],{},[491,3362,3363],{},"ESP_LLM_OBSERVATION_OTLP_AUTH",[2585,3365,3366],{},[491,3367,3368],{},"esp.llm.observation.otlp.auth",[2585,3370,3371],{},[491,3372,3350],{},[2585,3374,3375,3376,626],{},"Base64-encoded Langfuse public and secret key (",[491,3377,3378],{},"Basic \u003Cauth>",[539,3380],{},[469,3382,3384,3385,566],{"id":3383},"caching-architecture-in-spring-boot-langfusepromptservice","Caching Architecture in Spring Boot (",[491,3386,584],{},[460,3388,3389,3390,3392],{},"To eliminate latency and avoid external API limits, ",[491,3391,584],{}," implements a resilient multi-tier cache:",[474,3394,3395,3403,3413,3426],{},[477,3396,3397,3402],{},[480,3398,706,3399,743],{},[491,3400,3401],{},"ConcurrentHashMap"," Instant prompt lookup during request processing.",[477,3404,3405,3412],{},[480,3406,735,3407,676,3409,743],{},[491,3408,738],{},[491,3410,3411],{},"\u003Cprompt>.version"," Persisted locally across container restarts.",[477,3414,3415,3418,3419,3422,3423,3425],{},[480,3416,3417],{},"Startup Ingestion:"," During ",[491,3420,3421],{},"ApplicationReadyEvent",", the service performs a remote ingestion sweep of all registered ",[491,3424,788],{}," beans.",[477,3427,3428,3431,3432,3434],{},[480,3429,3430],{},"Periodic Refresh:"," Scheduled background Quartz job (",[491,3433,2594],{},") periodically sweeps and reloads prompt updates from Langfuse every 20 minutes.",[539,3436],{},[469,3438,3440],{"id":3439},"troubleshooting-common-issues","Troubleshooting Common Issues",[606,3442,3443,3471,3492],{},[477,3444,3445,3448],{},[480,3446,3447],{},"Prompt returns fallback content on startup:",[606,3449,3450,3458,3468],{},[477,3451,3452,3453,3455,3456,626],{},"Check that ",[491,3454,720],{}," is configured correctly (e.g. ",[491,3457,3356],{},[477,3459,3460,3461,3463,3464,728,3466,626],{},"Verify that ",[491,3462,724],{}," matches the label present in Langfuse (",[491,3465,511],{},[491,3467,507],{},[477,3469,3470],{},"Check that the prompt name passed in Java matches the prompt name in Langfuse exactly.",[477,3472,3473,3476],{},[480,3474,3475],{},"HTTP 403 \u002F Cloudflare WAF block during sync:",[606,3477,3478,3481],{},[477,3479,3480],{},"Some prompts contain HTML\u002FJavaScript snippets. Cloudflare WAF rules may block POST requests containing script tags.",[477,3482,3483,3484,3487,3488,3491],{},"Ensure the Cloudflare WAF skip rule is configured for ",[491,3485,3486],{},"\u002Fapi\u002Fpublic\u002F"," or that ",[491,3489,3490],{},"LANGFUSE_EXTRA_HEADERS"," contains the appropriate bypass secret.",[477,3493,3494,3497],{},[480,3495,3496],{},"Span not linked in Langfuse Traces:",[606,3498,3499],{},[477,3500,3501,3502,3505,3506,3508,3509,531],{},"Ensure ",[491,3503,3504],{},"new LangfusePromptObservationAdvisor(PROMPT_NAME, langfusePromptService)"," is registered in ",[491,3507,1132],{}," on the ",[491,3510,784],{},[3512,3513,3514],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":656,"searchDepth":812,"depth":812,"links":3516},[3517,3520,3530,3539,3543],{"id":457,"depth":812,"text":458,"children":3518},[3519],{"id":471,"depth":828,"text":472},{"id":543,"depth":812,"text":544,"children":3521},[3522,3523,3525,3527,3528,3529],{"id":550,"depth":828,"text":551},{"id":557,"depth":828,"text":3524},"Step 1: Backend Implementation (platform-api \u002F api-cps)",{"id":1761,"depth":828,"text":3526},"Step 2: Create Prompt in esp-prompts Repository",{"id":1896,"depth":828,"text":1897},{"id":1950,"depth":828,"text":1951},{"id":2072,"depth":828,"text":2073},{"id":2162,"depth":812,"text":2163,"children":3531},[3532,3533,3534,3536,3537,3538],{"id":2175,"depth":828,"text":551},{"id":2183,"depth":828,"text":2184},{"id":2258,"depth":828,"text":3535},"Step 2: Merge to main in esp-prompts (Staging Sync)",{"id":2319,"depth":828,"text":2320},{"id":2355,"depth":828,"text":2356},{"id":2430,"depth":828,"text":2431},{"id":2551,"depth":812,"text":2552,"children":3540},[3541,3542],{"id":2555,"depth":828,"text":2556},{"id":2696,"depth":828,"text":2697},{"id":2866,"depth":812,"text":2867,"children":3544},[3545,3546,3547,3548,3549,3551],{"id":2870,"depth":828,"text":2871},{"id":2997,"depth":828,"text":2998},{"id":3072,"depth":828,"text":3073},{"id":3230,"depth":828,"text":3231},{"id":3383,"depth":828,"text":3550},"Caching Architecture in Spring Boot (LangfusePromptService)",{"id":3439,"depth":828,"text":3440},"Step-by-step guide for backend developers on adding new prompts, modifying existing prompts across platform-api and api-cps, integrating with Langfuse and esp-prompts, Quartz reload scheduling, and coordinating Data\u002FAI team benchmarking.","md",null,{},{"title":143,"description":3552},"SlrHCSvFD5Pm6-k4ZKSOGHvX668-UiHwIfJ-bRbi0Mc",[3559,3561],{"title":139,"path":140,"stem":141,"description":3560,"children":-1},"This guide provides a set of guidelines for designing and implementing APIs in the back-end of ESProfiler",{"title":152,"path":153,"stem":154,"description":3562,"children":-1},"Pulling a shared database volume for local development, and refreshing it from production when the data gets stale.",1795106634711]