Repolode
Moh4696

Moh4696/build-ai-agents-free

무료 Groq 및 Gemini 모델을 사용해 LangChain과 LangGraph로 Python AI 에이전트를 만드는 단계별 튜토리얼입니다.

스타
369
포크
115
열린 이슈
2
마지막 커밋
3개월 전

어떤 프로젝트인가요?

API 비용을 내지 않고 Python으로 AI 에이전트를 만드는 입문자용 튜토리얼입니다. 일반 챗봇과 에이전트를 구분하는 plan, act, observe 루프를 살펴보고, Groq의 무료 Llama 3.3 70B 모델을 사용해 LangChain의 create_agent에서 이 루프를 실행하는 방법을 보여줍니다.

단계별로 기능을 더해 갑니다. 먼저 최소한의 에이전트부터 시작해, 미리 만들어진 DuckDuckGo 웹 검색 도구와 @tool 데코레이터로 정의한 사용자 지정 word_count 도구를 추가합니다. 다음으로 InMemorySaver 체크포인터와 thread_id를 사용해 대화 메모리를 추가하고, 마지막으로 기본 제공업체가 실패하면 Groq에서 Google Gemini로 전환하는 대체 기능을 구현합니다. 각 단계에 해당하는 스크립트는 저장소의 src 폴더에 있으며, agent.py에서 모든 기능을 통합합니다.

이 튜토리얼은 에이전트 경험이 없고 유료 API 키를 사용하고 싶지 않은 독자를 대상으로 합니다. 검색 도구의 요청 제한, 스크립트가 종료되면 사라지는 메모리, 무료 티어 제공업체가 프롬프트를 학습에 사용할 수 있다는 점 등 무료 구성의 한계도 설명합니다.

핵심 기능

  • 01LangChain의 create_agent와 Groq의 무료 Llama 3.3 70B 모델로 작동하는 에이전트를 만듭니다.
  • 02API 키가 필요 없는 DuckDuckGo 웹 검색 도구를 추가합니다.
  • 03@tool 데코레이터로 Python 함수를 도구로 만드는 방법을 보여줍니다.
  • 04InMemorySaver 체크포인터와 thread_id를 사용해 여러 차례 이어지는 대화를 위한 메모리를 추가합니다.
  • 05오류가 발생하면 Groq에서 Google Gemini로 전환하는 제공업체 대체 기능을 보여줍니다.
  • 06각 단계에서 실행할 수 있는 스크립트와 기능을 통합한 agent.py를 제공합니다.

활용 사례

  • AI 에이전트의 plan, act, observe 루프를 기초부터 익히기.
  • 유료 API 키 없이 도구를 사용하는 에이전트 프로토타이핑하기.
  • LangChain과 LangGraph 기초를 다루는 입문자 워크숍 진행하기.
  • 무료 제공업체 하나를 사용할 수 없을 때 대체 수단이 필요한 사이드 프로젝트 만들기.

빠른 시작

  1. 1

    Python 3.10 이상이 설치되어 있는지 확인합니다

    python3 --version
  2. 2

    프로젝트 폴더를 만들고 해당 폴더로 이동합니다

    mkdir my-agent cd my-agent
  3. 3

    langchain, Groq connector, python-dotenv를 설치합니다

    pip install -U "langchain[groq]" python-dotenv
  4. 4

    console.groq.com에서 무료 Groq API key를 발급받아 .env 파일에 저장한 다음 첫 번째 agent 스크립트를 실행합니다

    python3 agent.py

사용 전 알아둘 점

  • 무료 모델 등급은 예고 없이 변경될 수 있고, 대부분의 제공업체가 프롬프트를 학습에 사용할 수 있으므로 민감한 데이터는 입력하지 마세요.
  • DuckDuckGo search tool은 많이 사용하면 요청을 제한하며 간헐적으로 실패할 수 있습니다.
  • InMemorySaver는 대화 메모리를 RAM에만 보관하므로 스크립트를 종료하면 사라집니다.

토픽

자주 묻는 질문

build-ai-agents-free은(는) 무엇인가요?
무료 Groq 및 Gemini 모델을 사용해 LangChain과 LangGraph로 Python AI 에이전트를 만드는 단계별 튜토리얼입니다. API 비용을 내지 않고 Python으로 AI 에이전트를 만드는 입문자용 튜토리얼입니다. 일반 챗봇과 에이전트를 구분하는 plan, act, observe 루프를 살펴보고, Groq의 무료 Llama 3.3 70B 모델을 사용해 LangChain의 create_agent에서 이 루프를 실행하는 방법을 보여줍니다.
build-ai-agents-free은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
build-ai-agents-free은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
build-ai-agents-free은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. build-ai-agents-free의 마지막 커밋은 2026년 7월 8일입니다.
build-ai-agents-free은(는) 어디에 사용할 수 있나요?
AI 에이전트의 plan, act, observe 루프를 기초부터 익히기. 유료 API 키 없이 도구를 사용하는 에이전트 프로토타이핑하기. LangChain과 LangGraph 기초를 다루는 입문자 워크숍 진행하기. 무료 제공업체 하나를 사용할 수 없을 때 대체 수단이 필요한 사이드 프로젝트 만들기.
build-ai-agents-free는 어떻게 설치하나요?
Python 3.10 이상이 설치되어 있는지 확인합니다: python3 --version 프로젝트 폴더를 만들고 해당 폴더로 이동합니다: mkdir my-agent cd my-agent langchain, Groq connector, python-dotenv를 설치합니다: pip install -U "langchain[groq]" python-dotenv console.groq.com에서 무료 Groq API key를 발급받아 .env 파일에 저장한 다음 첫 번째 agent 스크립트를 실행합니다: python3 agent.py
build-ai-agents-free은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Moh4696/build-ai-agents-free

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트