Communitygithub.com

Thiagoopro/AI-Agent-Framework

๐Ÿค– AI-Agent-Framework๋กœ ์—์ด์ „ํŠธ ํ†ตํ•ฉ ์‹œ์Šคํ…œ์„ ์‰ฝ๊ฒŒ ๊ตฌ์ถ•ํ•˜์„ธ์š”. ๋งž์ถคํ˜• ์—์ด์ „ํŠธ ๊ธฐ๋ฐ˜ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ ์œ ์—ฐํ•œ API๋ฅผ ์ œ๊ณตํ•˜๋Š” Python ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค.

AI-Agent-Framework๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

Thiagoopro/AI-Agent-Framework๋Š” ๊ฐœ๋ฐœ์ž๊ฐ€ ์—์ด์ „ํŠธ ๊ธฐ๋ฐ˜ ์‹œ์Šคํ…œ์„ ์†์‰ฝ๊ฒŒ ๊ตฌ์ถ•ํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋œ Python ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ Claude Code, Cursor, Codex ๋“ฑ ๋‹ค์–‘ํ•œ AI ์—์ด์ „ํŠธ ํ”Œ๋žซํผ๊ณผ ํ†ตํ•ฉ๋˜์–ด, ๋งž์ถคํ˜• ์—์ด์ „ํŠธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ์œ ์—ฐํ•˜๊ณ  ์ง๊ด€์ ์ธ API๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ฃผ์š” ๊ธฐ๋Šฅ์œผ๋กœ๋Š” ๋™์  ์—์ด์ „ํŠธ ์ƒ์„ฑ, ์ƒํƒœ ๊ด€๋ฆฌ, ์™ธ๋ถ€ ๋„๊ตฌ์™€์˜ ์—ฐ๋™, ๊ทธ๋ฆฌ๊ณ  ์ด๋ฒคํŠธ ๊ธฐ๋ฐ˜ ์›Œํฌํ”Œ๋กœ์šฐ ์ฒ˜๋ฆฌ๋ฅผ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค. ๊ฐœ๋ฐœ์ž๋Š” ์ด ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ํ†ตํ•ด ๋ณต์žกํ•œ ์—์ด์ „ํŠธ ๋กœ์ง์„ ๋ชจ๋“ˆํ™”ํ•˜๊ณ  ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๊ตฌ์„ฑ ์š”์†Œ๋กœ ๋ถ„๋ฆฌํ•˜์—ฌ ์ƒ์‚ฐ์„ฑ์„ ๊ทน๋Œ€ํ™”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. SKILL.md ๋ฌธ์„œ์—๋Š” ์„ค์น˜ ๋ฐฉ๋ฒ•, ๊ธฐ๋ณธ ์‚ฌ์šฉ ์˜ˆ์ œ, API ์ฐธ์กฐ ๋ฐ ๊ณ ๊ธ‰ ๊ตฌ์„ฑ ์˜ต์…˜์ด ์ƒ์„ธํžˆ ์„ค๋ช…๋˜์–ด ์žˆ์–ด ์ดˆ๋ณด์ž๋ถ€ํ„ฐ ์ „๋ฌธ๊ฐ€๊นŒ์ง€ ์‰ฝ๊ฒŒ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ํŠนํžˆ AI ์—์ด์ „ํŠธ๋ฅผ ํ™œ์šฉํ•œ ์ž๋™ํ™”, ์ฑ—๋ด‡, ๋ฐ์ดํ„ฐ ๋ถ„์„ ํŒŒ์ดํ”„๋ผ์ธ ๋“ฑ ๋‹ค์–‘ํ•œ ์†Œํ”„ํŠธ์›จ์–ด ์—”์ง€๋‹ˆ์–ด๋ง ํ”„๋กœ์ ํŠธ์— ์ ํ•ฉํ•ฉ๋‹ˆ๋‹ค.

์ง€์› ๋Œ€์ƒ~Claude Code~Codex CLI~Cursor
npx skills add Thiagoopro/AI-Agent-Framework

์ฆ๊ฒจ ์‚ฌ์šฉํ•˜๋Š” AI์—๊ฒŒ ๋ฌผ์–ด๋ณด๊ธฐ

์ด ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ด ๋ฏธ๋ฆฌ ๋กœ๋“œ๋œ ์ƒˆ ์ฑ„ํŒ…์„ ์—ฝ๋‹ˆ๋‹ค.

๋ฌธ์„œ

AI-Agent-Framework์€(๋Š”) ๋ฌด์—‡์„ ํ•˜๋‚˜์š”?

๐Ÿค– AI-Agent-Framework๋กœ ์—์ด์ „ํŠธ ํ†ตํ•ฉ ์‹œ์Šคํ…œ์„ ์‰ฝ๊ฒŒ ๊ตฌ์ถ•ํ•˜์„ธ์š”. ๋งž์ถคํ˜• ์—์ด์ „ํŠธ ๊ธฐ๋ฐ˜ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ ์œ ์—ฐํ•œ API๋ฅผ ์ œ๊ณตํ•˜๋Š” Python ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค.

์„ค์น˜

pip install ai-agent-framework

๋น ๋ฅธ ์‹œ์ž‘

๋‹ค์Œ์€ ๊ธฐ๋ณธ ์—์ด์ „ํŠธ๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ์‹คํ–‰ํ•˜๋Š” ๊ฐ„๋‹จํ•œ ์˜ˆ์ œ์ž…๋‹ˆ๋‹ค:

from ai_agent_framework import Agent

# ์—์ด์ „ํŠธ ์ƒ์„ฑ
agent = Agent(name="MyAgent", role="๋„์šฐ๋ฏธ")

# ์—์ด์ „ํŠธ ์‹คํ–‰
response = agent.run("์•ˆ๋…•ํ•˜์„ธ์š”, ์–ด๋–ค ์ž‘์—…์„ ๋„์™€๋“œ๋ฆด๊นŒ์š”?")
print(response)

์ฃผ์š” ๊ธฐ๋Šฅ

  • ๋™์  ์—์ด์ „ํŠธ ์ƒ์„ฑ: ๋Ÿฐํƒ€์ž„์— ์—์ด์ „ํŠธ๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ๊ตฌ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ƒํƒœ ๊ด€๋ฆฌ: ์—์ด์ „ํŠธ ์ƒํƒœ๋ฅผ ์ง€์†์ ์œผ๋กœ ๊ด€๋ฆฌํ•˜์—ฌ ์ปจํ…์ŠคํŠธ๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • ๋„๊ตฌ ํ†ตํ•ฉ: ์™ธ๋ถ€ API ๋ฐ ๋„๊ตฌ์™€ ์‰ฝ๊ฒŒ ์—ฐ๋™ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ด๋ฒคํŠธ ๊ธฐ๋ฐ˜ ์›Œํฌํ”Œ๋กœ์šฐ: ์ด๋ฒคํŠธ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•œ ๋น„๋™๊ธฐ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.

API ์ฐธ์กฐ

์ž์„ธํ•œ API ๋ฌธ์„œ๋Š” ๊ณต์‹ ๋ฌธ์„œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๊ณ ๊ธ‰ ๊ตฌ์„ฑ

์—์ด์ „ํŠธ๋ฅผ ๋” ์„ธ๋ฐ€ํ•˜๊ฒŒ ์ œ์–ดํ•˜๋ ค๋ฉด ๊ตฌ์„ฑ ํŒŒ์ผ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

agent:
  name: MyAgent
  role: ๋„์šฐ๋ฏธ
  model: gpt-4
  temperature: 0.7
  max_tokens: 1000

๊ธฐ์—ฌ

๋ฒ„๊ทธ ๋ฆฌํฌํŠธ ๋ฐ ๊ธฐ๋Šฅ ์ œ์•ˆ์€ GitHub ์ด์Šˆ๋ฅผ ํ†ตํ•ด ์ œ์ถœํ•ด์ฃผ์„ธ์š”.

๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค ํ•˜์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.

๊ด€๋ จ ์Šคํ‚ฌ