๐Ÿšจ [CRITICAL] AI_MAINTENANCE_RULES ๐Ÿšจ

์ด ๋ฌธ์„œ๋Š” ๋ธ”๋กœ๊ทธ ์ž๋™ํ™” ํŒŒ์ดํ”„๋ผ์ธ์˜ ์ƒ๋ช…์ค„์ž…๋‹ˆ๋‹ค. ํ–ฅํ›„ ์ฝ”๋“œ๋ฅผ ์ˆ˜์ •ํ•˜๋Š” ์–ด๋–ค AI๋„ ์•„๋ž˜์˜ ํ•ต์‹ฌ ์‹œ์Šคํ…œ์„ ์ž„์˜๋กœ ์ƒ๋žต, ์ตœ์ ํ™”, ๋˜๋Š” ํ›ผ์†ํ•ด์„œ๋Š” ์•ˆ ๋ฉ๋‹ˆ๋‹ค.

1. ๐Ÿ›ก๏ธ API ๋ฌด์  ์ˆœํ™˜ (Active Failover) ์‹œ์Šคํ…œ ๋ณด์กด

  • generate_with_retry ํ•จ์ˆ˜์˜ API ํ˜ธ์ถœ ์—๋Ÿฌ(ResourceExhausted ๋“ฑ) ๋ฐœ์ƒ ์‹œ ๋ฌด์กฐ๊ฑด ์ž‘๋™ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • 2์ค‘ ๋ฃจํ”„ ๋กœ์ง ์ ˆ๋Œ€ ๋ณด์กด: 1์ฐจ๋กœ ๋‹จ์ผ API ํ‚ค ๋‚ด์—์„œ ๋ชจ๋ธ(gemini-3.5-flash-lite -> 3.1-flash-lite)์„ ์ „ํ™˜ํ•˜๊ณ , 2์ฐจ๋กœ ๋‹ค์Œ GEMINI_API_KEY๋กœ ๊ต์ฒดํ•˜์—ฌ ์žฌ์‹œ๋„ํ•˜๋Š” ๋กœ์ง์„ ์ง€์šฐ์ง€ ๋งˆ์„ธ์š”.

2. โœ๏ธ True 3-Pass ๊ธ€์“ฐ๊ธฐ ํŒŒ์ดํ”„๋ผ์ธ (AEO/SEO ์ตœ์ ํ™”)

API ๋น„์šฉ์„ ์•„๋ผ๊ฒ ๋‹ค๊ณ  ๊ธ€์“ฐ๊ธฐ ๋‹จ๊ณ„๋ฅผ 1~2๊ฐœ๋กœ ๋‹จ์ถ•ํ•˜์ง€ ๋งˆ์„ธ์š”. ๋ฐ˜๋“œ์‹œ ์•„๋ž˜ 3๋‹จ๊ณ„๋ฅผ ๋…๋ฆฝ์ ์œผ๋กœ ํ˜ธ์ถœํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

  • Pass 1 (Write): ๊ฒ€์ƒ‰์–ด ๊ธฐ๋ฐ˜์˜ ์ •๋ณด์„ฑ ์ดˆ์•ˆ ์ƒ์„ฑ
  • Pass 2 (Check): AEO(AI ์ตœ์ ํ™”), SEO, GEO ๊ด€์ ์—์„œ ์ดˆ์•ˆ์˜ ์•ฝ์ ์„ ๋‚ ์นด๋กญ๊ฒŒ ๋น„ํŒ
  • Pass 3 (Revise): ๋น„ํŒ์„ ์ˆ˜์šฉํ•˜์—ฌ AI ํŠน์œ ์˜ ๊ธฐ๊ณ„์  ๋งํˆฌ๋ฅผ ์ œ๊ฑฐํ•œ ์‚ฌ๋žŒ๋‹ค์šด ์ „๋ฌธ๊ฐ€ ์ตœ์ข… ์›๊ณ  ์ž‘์„ฑ

3. ๐Ÿ–ผ๏ธ ์ธ๋„ค์ผ ์ด๋ฏธ์ง€ ๊ธฐํš (๋‹ค์ค‘ ์‚ฌ๋ฌผ ์กฐํ•ฉ ํ—ˆ์šฉ & ์‹ฌํ”Œ ํ”„๋กฌํ”„ํŠธ)

  • ๋Œ€์ƒ ์ œํ•œ: ์ธ๋ฌผ, ๋™๋ฌผ์€ ์ ˆ๋Œ€ ๊ธˆ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • ์กฐํ•ฉ ํ—ˆ์šฉ: ๋ฐ˜๋“œ์‹œ 1๊ฐœ์˜ ์‚ฌ๋ฌผ์ผ ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค. ๋Œ€์ƒ์€ โ€˜์ƒ์ง•์ ์ธ ๋ฌด์ƒ๋ฌผ ์‚ฌ๋ฌผโ€™์ด๋˜, ๋ฌธ๋งฅ์— ๋งž๋Š” ์ ์ ˆํ•œ ์‚ฌ๋ฌผ๋“ค์˜ ์ž์—ฐ์Šค๋Ÿฌ์šด ์กฐํ•ฉ(์˜ˆ: ํ™ฉ๊ธˆ ๋™์ „๊ณผ ๊ณ„์‚ฐ๊ธฐ)์„ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ฌํ”Œ ํ”„๋กฌํ”„ํŠธ ๊ณ ์ •: ์ฐฐํ™ ์งˆ๊ฐ์„ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด ๊ณผ๋„ํ•œ ์ˆ˜์‹์–ด(Photorealistic, 8k, ultra ๋“ฑ)๋ฅผ ๋ฐฐ์ œํ•˜๊ณ  ๋ฌด์กฐ๊ฑด ์•„๋ž˜ ํฌ๋งท์„ ๊ณ ์ • ์‚ฌ์šฉํ•˜์„ธ์š”. A realistic photograph of {obj_name} on a clean desk, bright natural lighting, simple and clear

4. ๐Ÿ”— ์ œํœด๋งˆ์ผ€ํŒ…(CPA) ํ•„์ˆ˜ ๊ทœ์น™

  • ์บ ํŽ˜์ธ ํ‚ค์›Œ๋“œ ๊ฐ•์ œ ์ฃผ์ž…: campaigns.json์— ์ •์˜๋œ ํƒ€๊ฒŸ ์ œํ’ˆ/์บ ํŽ˜์ธ ํ‚ค์›Œ๋“œ๋ฅผ ์ง์ ‘ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ด ๋ธ”๋กœ๊ทธ๋Š” ์ผ์ƒ/์‡ผํ•‘ ๋ชฉ์ ์ด๋ฏ€๋กœ ๋ณต์žกํ•œ ๋‰ด์Šค API ๊ธฐ๋ฐ˜์˜ ์”จ์•— ๋ฐœ๊ตด ๋กœ์ง์„ ์ ์šฉํ•˜์ง€ ๋งˆ์„ธ์š”.
  • HTML ๊ด‘๊ณ  ๋ธ”๋ก ๋ณด์กด: ์›๊ณ  ์ƒ/์ค‘/ํ•˜๋‹จ ๋ฐ ํ…ํ•‘(Tenping) ์ œํœด ์Šคํฌ๋ฆฝํŠธ ๋ธ”๋ก์„ ์ ˆ๋Œ€ ํ›ผ์†ํ•˜์ง€ ๋งˆ์„ธ์š”.