Function buildPrompt

aitagging.js:283–324

(options = {}, filename = null)

// Build prompt based on options
function buildPrompt(options = {}, filename = null) {
  const maxTags = options.maxTags || DEFAULT_OPTIONS.maxTags;
  const useCategories = options.useCategories || false;
  const useJsonResponse = options.useJsonResponse || false;
  const detailLevel = options.detailLevel || 'medium';
  
  let prompt = `You are helping organize 3D models in a library. Analyze this image of a 3D model thumbnail and generate ${maxTags} useful category tags that will help users find and organize this model. `;
  
  prompt += getFilenameContext(filename);
  
  prompt += `Focus ONLY on the 3D model itself - completely ignore any background, text, or UI elements. `;
  prompt += `Do NOT use generic terms like "3D Model", "model", "object", "item", "tag", "tags", "thing", "stuff", or "piece". `;
  
  // Adjust prompt based on detail level
  if (detailLevel === 'low') {
    prompt += `Generate very simple, broad category tags. Use the most basic, high-level classification. `;
    prompt += `Examples: "Toy", "Dragon", "Tool", "Mount", "Ball", "Car", "Part", "Container", "Figure", "Decorative", "Functional". `;
    prompt += `Use single-word tags only. Focus on the most general category the model belongs to. `;
  } else if (detailLevel === 'high') {
    prompt += `Generate detailed, specific tags that capture distinguishing features and characteristics. `;
    prompt += `Include descriptive details like style, complexity, articulation, or specific attributes. `;
    prompt += `Examples: "Articulated Dragon", "Corner Bracket", "Storage Container", "Decorative Vase", "Racing Car", "Action Figure". `;
    prompt += `Compound tags are acceptable when they add meaningful detail. `;
  } else {
    // Medium (default)
    prompt += `Generate general category tags that classify the model at a moderate level of detail. `;
    prompt += `Use simple, single-word tags when possible. Good examples: "Toy", "Dragon", "Tool", "Mount", "Ball", "Car", "Part", "Drawer", "Bracket", "Container", "Figure", "Vase", "Lamp", "Holder", "Organizer", "Decorative", "Functional", "Bracket", "Mount", "Holder", "Stand", "Base". `;
    prompt += `Avoid overly specific tags like "corner-bracket" or "mounting-bracket" - use the general category "Bracket" or "Mount" instead. `;
    prompt += `Avoid compound tags when a single general word works. For example, use "Toy" not "toy-car", use "Dragon" not "dragon-figure", use "Car" not "car-model". `;
  }
  
  prompt += `Focus on the primary category, subject, or function of the model. `;
  prompt += `Each tag should represent a distinct category or characteristic that helps organize the library. `;
  prompt += `Tags should be practical and useful for finding models - think about what someone would search for. `;
  
  if (useCategories) {
    prompt += `Organize tags into these categories: object type, style, complexity, material. `;
  }
  
  // JSON response instructions are never part of the editable prompt; they are always appended in generateTagsForImage
  return prompt;
}

// Always appended to the prompt when calling the API (not included in editable/default prompt)
const JSON_RESPONSE_INSTRUCTIONS = `You MUST respond with ONLY a valid JSON object. The JSON must be complete and valid. Use this exact format: {"tags": ["tag1", "tag2", "tag3"]}. Do not include any explanatory text, markdown formatting, or code blocks - only the raw JSON object. If you cannot identify the model, return {"tags": []}. Ensure the JSON is properly closed with all brackets and quotes. `;