change prompt profile placeholder syntax to {var} (similar to agent syntax)

Author: phartenfeller

docs/src/content/docs/guides/prompt-profiles.mdx

@@ -52,8 +52,8 @@ BEGIN
   l_profile_id := uc_ai_prompt_profiles_api.create_prompt_profile(
     p_code => 'SUMMARIZE_TEXT',
     p_description => 'Summarizes text content in a specified style',
-    p_system_prompt_template => 'You are a #style# assistant that creates concise summaries.',
-    p_user_prompt_template => 'Summarize the following text: #text#',
+    p_system_prompt_template => 'You are a {style} assistant that creates concise summaries.',
+    p_user_prompt_template => 'Summarize the following text: {text}',
     p_provider => uc_ai.c_provider_openai,
     p_model => uc_ai_openai.c_model_gpt_4o_mini,
     p_version => 1,
@@ -69,7 +69,7 @@ END;
 
 - `p_code`: Unique identifier for the profile
 - `p_description`: Human-readable description
-- `p_system_prompt_template`: System prompt with placeholders (`#placeholder#`)
+- `p_system_prompt_template`: System prompt with placeholders (`{placeholder}`)
 - `p_user_prompt_template`: User prompt with placeholders
 - `p_provider`: AI provider (e.g., `uc_ai.c_provider_openai`)
 - `p_model`: Model identifier (e.g., `uc_ai_openai.c_model_gpt_4o_mini`)
@@ -86,12 +86,12 @@ END;
 
 ## Using placeholders
 
-Placeholders allow you to create dynamic prompts. Use `#placeholder_name#` syntax in your templates:
+Placeholders allow you to create dynamic prompts. Use `{placeholder_name}` syntax in your templates:
 
 ```sql
 -- Template with placeholders
-p_system_prompt_template => 'You are a #role# assistant.',
-p_user_prompt_template => 'What is the capital of #country#?'
+p_system_prompt_template => 'You are a {role} assistant.',
+p_user_prompt_template => 'What is the capital of {country}?'
 ```
 
 When executing the profile, provide values for the placeholders:
@@ -115,7 +115,7 @@ END;
 ```
 
 <Aside type="note">
-  Placeholder matching is case-insensitive. Both `#Country#` and `#country#`
+  Placeholder matching is case-insensitive. Both `{Country}` and `{country}`
   will match a parameter named 'country'.
 </Aside>
 
@@ -124,10 +124,10 @@ END;
 UC AI validates that all placeholders in your templates have corresponding parameters. If a placeholder is missing, you'll get a clear error:
 
 ```
-Missing parameter for placeholder: #text#
+Missing parameter for placeholder: {text}
 ```
 
-Only alphanumeric characters and underscores are allowed in placeholder names: `#valid_name_123#`
+Only alphanumeric characters and underscores are allowed in placeholder names: `{valid_name_123}`
 
 ## Executing a profile
 
@@ -194,7 +194,7 @@ BEGIN
     p_code => 'COMPLEX_ANALYSIS',
     p_description => 'Analyzes complex scenarios with reasoning',
     p_system_prompt_template => 'You are an analytical assistant.',
-    p_user_prompt_template => 'Analyze: #scenario#',
+    p_user_prompt_template => 'Analyze: {scenario}',
     p_provider => uc_ai.c_provider_openai,
     p_model => uc_ai_openai.c_model_gpt_o4,
     p_model_config_json => l_config
@@ -301,7 +301,7 @@ BEGIN
     p_code => 'ANALYZE_TEXT',
     p_description => 'Analyzes text with structured output',
     p_system_prompt_template => 'Analyze text and provide structured results.',
-    p_user_prompt_template => 'Analyze: #text#',
+    p_user_prompt_template => 'Analyze: {text}',
     p_provider => uc_ai.c_provider_openai,
     p_model => uc_ai_openai.c_model_gpt_4o_mini,
     p_response_schema => l_schema
@@ -417,8 +417,8 @@ BEGIN
   uc_ai_prompt_profiles_api.update_prompt_profile(
     p_id => 42,
     p_description => 'Updated description',
-    p_system_prompt_template => 'New system prompt with #param#',
-    p_user_prompt_template => 'New user prompt: #input#',
+    p_system_prompt_template => 'New system prompt with {param}',
+    p_user_prompt_template => 'New user prompt: {input}',
     p_provider => uc_ai.c_provider_anthropic,
     p_model => uc_ai_anthropic.c_model_claude_3_5_sonnet
   );
@@ -502,7 +502,7 @@ BEGIN
     p_code => 'USER_LOOKUP',
     p_description => 'Looks up user information',
     p_system_prompt_template => 'You are an assistant with access to user data.',
-    p_user_prompt_template => 'What is the email of #user_name#?',
+    p_user_prompt_template => 'What is the email of {user_name}?',
     p_provider => uc_ai.c_provider_openai,
     p_model => uc_ai_openai.c_model_gpt_4o_mini,
     p_model_config_json => l_config
@@ -643,7 +643,7 @@ BEGIN
     p_code => 'CLASSIFY_ISSUE',
     p_description => 'Classifies customer support issues',
     p_system_prompt_template => 'You are a support ticket classifier. Analyze issues and categorize them accurately.',
-    p_user_prompt_template => 'Classify this issue: #issue_text#',
+    p_user_prompt_template => 'Classify this issue: {issue_text}',
     p_provider => uc_ai.c_provider_openai,
     p_model => uc_ai_openai.c_model_gpt_4o_mini,
     p_response_schema => l_schema,

src/packages/uc_ai_prompt_profiles_api.pkb

@@ -404,7 +404,7 @@ create or replace package body uc_ai_prompt_profiles_api as
 
 
   /*
-   * Replaces placeholders (#placeholder#) in a template with values from parameters JSON
+   * Replaces placeholders ({placeholder}) in a template with values from parameters JSON
    * Case-insensitive replacement
    */
   function replace_placeholders(
@@ -442,7 +442,7 @@ create or replace package body uc_ai_prompt_profiles_api as
       -- Replace placeholder (case-insensitive)
       l_result := regexp_replace(
         l_result,
-        '#' || l_key || '#',
+        '\{' || l_key || '\}',
         l_value,
         1, 0, 'i'
       );
@@ -479,10 +479,10 @@ create or replace package body uc_ai_prompt_profiles_api as
     -- Find all placeholders in templates (only alphanumeric and underscore allowed)
     <<placeholder_loop>>
     loop
-      l_placeholder := regexp_substr(l_combined_template, '#[A-Za-z0-9_]+#', l_position);
+      l_placeholder := regexp_substr(l_combined_template, '\{[A-Za-z0-9_]+\}', l_position);
       exit placeholder_loop when l_placeholder is null;
 
-      -- Extract placeholder name (without the # symbols)
+      -- Extract placeholder name (without the { } symbols)
       l_placeholder_name := substr(l_placeholder, 2, length(l_placeholder) - 2);
 
       -- Check if parameter exists (case-insensitive)
@@ -499,12 +499,12 @@ create or replace package body uc_ai_prompt_profiles_api as
       end if;
 
       if not l_found then
-        uc_ai_logger.log_error('Missing parameter for placeholder: ' || l_placeholder, l_scope);
+        uc_ai_logger.log_error('Missing parameter for placeholder: ' || l_placeholder, l_scope, p_parameters.to_clob);
         raise_application_error(-20003, 'Missing parameter for placeholder: ' || l_placeholder);
       end if;
 
       -- Move to next placeholder
-      l_position := regexp_instr(l_combined_template, '#[A-Za-z0-9_]+#', l_position) + length(l_placeholder);
+      l_position := regexp_instr(l_combined_template, '\{[A-Za-z0-9_]+\}', l_position) + length(l_placeholder);
     end loop placeholder_loop;
   end validate_parameters;
 

test/test_uc_ai_prompt_profiles_api.pkb

@@ -29,7 +29,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code,
       p_description => 'Test profile for basic creation',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Answer this question: #question#',
+      p_user_prompt_template => 'Answer this question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 1,
@@ -78,7 +78,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_CONFIG',
       p_description => 'Test profile with configuration',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Answer: #question#',
+      p_user_prompt_template => 'Answer: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_model_config_json => l_config,
@@ -106,7 +106,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_UPDATE',
       p_description => 'Original description',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini
     );
@@ -116,7 +116,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_id => l_id,
       p_description => l_new_description,
       p_system_prompt_template => 'You are a very helpful assistant.',
-      p_user_prompt_template => 'Please answer: #question#',
+      p_user_prompt_template => 'Please answer: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o
     );
@@ -142,7 +142,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_UPDATE2',
       p_description => 'Original description',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 1
@@ -154,7 +154,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_version => 1,
       p_description => l_new_description,
       p_system_prompt_template => 'You are a very helpful assistant.',
-      p_user_prompt_template => 'Please answer: #question#',
+      p_user_prompt_template => 'Please answer: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o
     );
@@ -182,7 +182,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_DELETE',
       p_description => 'Profile to delete',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini
     );
@@ -213,7 +213,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_DELETE2',
       p_description => 'Profile to delete',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 1
@@ -251,7 +251,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_STATUS',
       p_description => 'Status test profile',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_status => 'draft'
@@ -291,7 +291,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_VERSION',
       p_description => 'Version 1',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 1,
@@ -333,7 +333,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_GET',
       p_description => 'Get test profile',
       p_system_prompt_template => 'You are a helpful assistant.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini
     );
@@ -359,7 +359,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_LATEST',
       p_description => 'Version 1',
       p_system_prompt_template => 'You are a helpful assistant v1.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 1,
@@ -370,7 +370,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_LATEST',
       p_description => 'Version 2',
       p_system_prompt_template => 'You are a helpful assistant v2.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 2,
@@ -381,7 +381,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_LATEST',
       p_description => 'Version 3',
       p_system_prompt_template => 'You are a helpful assistant v3.',
-      p_user_prompt_template => 'Question: #question#',
+      p_user_prompt_template => 'Question: {question}',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_version => 3,
@@ -455,8 +455,8 @@ create or replace package body test_uc_ai_prompt_profiles_api as
     l_id := uc_ai_prompt_profiles_api.create_prompt_profile(
       p_code => gc_test_code || '_PLACEHOLDERS',
       p_description => 'Profile with placeholders',
-      p_system_prompt_template => 'You are a #role# assistant.',
-      p_user_prompt_template => 'What is the capital of #country#?',
+      p_system_prompt_template => 'You are a {role} assistant.',
+      p_user_prompt_template => 'What is the capital of {country}?',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_status => 'active'
@@ -660,7 +660,7 @@ create or replace package body test_uc_ai_prompt_profiles_api as
       p_code => gc_test_code || '_TOOLS',
       p_description => 'Profile with tool usage',
       p_system_prompt_template => 'You are an assistant with access to user information. Answer concisely.',
-      p_user_prompt_template => 'What is the email of #user_name#?',
+      p_user_prompt_template => 'What is the email of {user_name}?',
       p_provider => uc_ai.c_provider_openai,
       p_model => uc_ai_openai.c_model_gpt_4o_mini,
       p_status => 'active',