AI Agent Guide - cloud-barista/cb-spider GitHub Wiki

CB-Spider AI-Agent Beta ๊ฐœ์š”

  • CB-Spider ํ™œ์šฉ์„ ๋„์™€ ์ฃผ๋Š” ์ƒ์šฉ AI ๊ธฐ๋ฐ˜ AI-Agent ๋„๊ตฌ๋ฅผ ์‹คํ—˜์šฉ์œผ๋กœ ์ œ๊ณตํ•œ๋‹ค.

    • Experimental Features
    • Since v0.10.3
  • AI-Agent๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด CMD-Agent ๋ฐ CallLog-Analyzer๋ฅผ ๋ฒ ํƒ€ ๋ฒ„์ „์œผ๋กœ ์ œ๊ณตํ•œ๋‹ค.

  • CMD-Agent ๋ฐ CallLog-Analyzer ๋„๊ตฌ์˜ ์ œ๊ณต ๊ธฐ๋Šฅ ๋ฐ ํ™œ์šฉ ๋ฐฉ๋ฒ•์ด ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

1. CB-Spider CMD-Agent ๊ฐœ์š”

โ€ป CMD-Agent: NLI(์ž์—ฐ์–ด ์ธํ„ฐํŽ˜์ด์Šค)๋ฅผ ์ œ๊ณตํ•˜๋Š” AI ๊ธฐ๋ฐ˜ CB-Spider curl ๋ช…๋ น ์ƒ์„ฑ ๋ฐ ์‹คํ–‰ ๋„๊ตฌ

[๊ฐœ์š”]

  • CB-Spider๋Š” Rest API๋ฅผ ์ œ๊ณตํ•˜๋ฉฐ, curl์„ ์ด์šฉํ•˜์—ฌ ์‹คํ–‰ ์š”์ฒญ ๊ฐ€๋Šฅํ•จ
  • CMD-Agent๋Š” ์ž์—ฐ์–ด๋ฅผ ์ด์šฉํ•œ ์ž์› ๊ด€๋ฆฌ ์š”์ฒญ์„ Claude๋ฅผ ํ™œ์šฉํ•˜์—ฌ Spider curl ๋ช…๋ น์œผ๋กœ ์ƒ์„ฑํ•ด์คŒ
  • ์‚ฌ์šฉ์ž๋Š” Spider Rest API ๊ทœ๊ฒฉ์„ ์•Œ์ง€ ๋ชปํ•ด๋„ ์ž์›์„ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์Œ
  • ํ˜„์žฌ, ์ƒ์„ฑ๋œ ๊ฒฐ๊ณผ ๋ช…๋ น์€ ๋ถ€์ •ํ™•ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์‚ฌ์šฉ์ž์˜ ๊ต์ •์ด ํ•„์š”ํ•  ์ˆ˜๋„ ์žˆ์Œ

[์‹คํ–‰ ๋ฐฉ๋ฒ•]

  • (์‚ฌ์ „ ์ค€๋น„) Claude API Key ์„ค์ •

    • (1) export CLAUDE_API_KEY="xxxxโ€œ
    • (2) ๋˜๋Š” ๋‹ค์Œ ์œ„์น˜์— ์ €์žฅ: ~/.claude/claude_api.key
  • (์‚ฌ์šฉ ๋ฐฉ๋ฒ•) AdminWeb: AI-Agent -> CMD-Agent

    • ์ขŒ์ธก ์˜ˆ์ œ Prompt ์„ ํƒ ํ›„ ์‹คํ–‰ ์š”์ฒญ
    • ๋˜๋Š” ๋ถ„์„์— ์ ํ•ฉํ•œ Prompt ์ž…๋ ฅ ํ›„ ์‹คํ–‰ ์š”์ฒญ

[๊ฒฐ๊ณผ ์˜ˆ์‹œ]

2. CB-Spider CallLog-Analyzer ๊ฐœ์š”

โ€ป CallLog-Analyzer: NLI(์ž์—ฐ์–ด ์ธํ„ฐํŽ˜์ด์Šค)๋ฅผ ์ œ๊ณตํ•˜๋Š” AI ๊ธฐ๋ฐ˜ CB-Spider CallLog ๋ถ„์„ ๋ฐ ๋ฆฌํฌํŠธ ๋„๊ตฌ

[๊ฐœ์š”]

  • CB-Spider๋Š” Cloud API๋ฅผ ํ˜ธ์ถœ์‹œ๋งˆ๋‹ค Call Log๋ฅผ ๊ธฐ๋กํ•˜๊ณ  ์žˆ์Œ(์œ„์น˜: ./log/calllog/calllogs.log)
  • CallLog-Analyzer๋Š” Claude๋ฅผ ํ™œ์šฉํ•˜์—ฌ Call Log ๋ถ„์„ ๋ฐ Report & Insight ์ •๋ณด๋ฅผ ์ œ๊ณตํ•จ
  • ์ตœ๊ทผ CallLog 1,000 ๋ผ์ธ์— ๋Œ€ํ•œ ๋ถ„์„ ์ œ๊ณตํ•จ
  • Claude๋กœ๋ถ€ํ„ฐ javascript ์ฐจํŠธ๋ฅผ ํฌํ•จํ•œ ์™„์„ฑ๋œ Html Page ํ˜•ํƒœ๋กœ ๋ฐ˜ํ™˜ ๋ฐ›์•„์„œ ๋ณ„๋„์˜ ๋„๊ตฌ ์„ค์น˜๊ฐ€ ๋ถˆํ•„์š”ํ•จ
  • ๋ถ„์„/๋ฆฌํฌํŠธ ๊ฒฐ๊ณผ๊ฐ€ ๋ถ€์ ํ™•ํ•  ์ˆ˜ ์žˆ์œผ, ์•ฝ๊ฐ„ ๋‹ค๋ฅธ ์˜๋ฏธ์˜ ๋ถ„์„ ์ •๋ณด ๋ฐ Report๋ฅผ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ์Œ
  • ๋™์ผ ๋ถ„์„ ์š”์ฒญ์—๋„ ์š”์ฒญ์‹œ๋งˆ๋‹ค ๋‹ค๋ฅธ ๋ถ„์„ ๋ฐ Report๊ฐ€ ์ œ๊ณต๋  ์ˆ˜ ์žˆ์Œ

[์‹คํ–‰ ๋ฐฉ๋ฒ•]

  • (์‚ฌ์ „ ์ค€๋น„) Claude API Key ์„ค์ •

    • (1) export CLAUDE_API_KEY="xxxxโ€œ
    • (2) ๋˜๋Š” ๋‹ค์Œ ์œ„์น˜์— ์ €์žฅ: ~/.claude/claude_api.key
  • (์‚ฌ์šฉ ๋ฐฉ๋ฒ•)

    • AdminWeb: AI-Agent -> CallLog-Analyzer
    • ์ขŒ์ธก ์˜ˆ์ œ Prompt ์„ ํƒ ํ›„ ์‹คํ–‰ ์š”์ฒญ
    • ๋˜๋Š” ๊ด€๋ฆฌ์— ์ ํ•ฉํ•œ Prompt ์ž…๋ ฅ ํ›„ ์‹คํ–‰ ์š”์ฒญ

[๊ฒฐ๊ณผ ์˜ˆ์‹œ]