강의 계획 레슨 250개 중 230번째 · 프로젝트: 도구를 쓰는 조사 에이전트
프로젝트: 도구를 쓰는 조사 에이전트

도구 등록부 + 발송기

여러분이 읽어 본 모든 "AI 에이전트"는 결국 화려하지 않은 부품 하나로 귀결돼요: 도구 등록부. 모델이 {"tool": "search", "args": {"query": "weather"}} 같은 걸 내보내면, 여러분의 코드가 올바른 Python 함수를 찾고, 인자가 멀쩡한지 확인하고, 돌리고, 결과를 돌려줘야 해요. 이 층을 잘못 만들면 에이전트 전체가 잘못된 인자 하나 때문에 운영 중에 충돌할 수 있어요. 이 프로젝트의 첫 레슨은 바로 그 층을 만들고, 그 뒤 모든 레슨에서 이 생각을 다시 써요.

조사 에이전트의 발송기를 만들어요. 시작하려면 도구 두 개가 필요해요: 사실을 찾아보는 search(query)와 산수를 하는 calc(op, a, b). 등록부는 도구 이름을 한 쌍에 대응시켜요: 함수, 그리고 인자 스키마(도구가 받는 인자 이름의 집합). 발송은 모든 게 지나가는 관문이에요.

class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

발송이 강제해야 할 규칙(이 연습의 핵심이에요):

  • 모르는 도구 이름 -> KeyError를 일으켜요. 에이전트가 없는 걸 요청했어요.
  • args dict의 키는 등록된 스키마와 정확히 일치해야 해요. 빠진 인자나 여분의 인자 -> ValueError를 일으켜요. 이게 환각한 {"q": ...}(틀린 키)가 조용히 아무것도 안 하는 걸 막아요.
  • 올바른 호출 -> fn(**args)를 돌리고 그 반환값을 돌려줘요.

왜 스키마에 set을 쓸까요? 그러면 검증이 그냥 집합 같음이 되거든요: set(args) == self.tools[name]["args"]. 그게 거짓이면 키가 빠졌는지 남는지 알아내고 어느 쪽이든 ValueError를 일으키세요. fn(**args)로 부르면 dict가 키워드 인자로 펼쳐지니, 함수 시그니처가 마지막 연결을 해요.

"도구를 쓰는 에이전트를 만들었어요"를 읽는 채용 담당자가 실제로 묻는 건: 불행한 경로를 다뤘나요? 내보낼 수 있는 에이전트는 발송기가 실행을 망치는 대신 나쁜 호출을 시끄럽게 거부하는 에이전트예요. Run을 눌러 도구 두 개를 등록하고 좋은 호출은 성공하고 나쁜 호출은 오류를 일으키는 걸 보세요.

내 차례

Registry 클래스를 만드세요. register(name, fn, args)는 함수와 그 인자 이름 스키마를 저장해요(set을 쓰세요). dispatch(name, args)는: 모르는 도구 이름에 KeyError를 일으키고, args의 키가 스키마와 정확히 일치하지 않으면(빠졌거나 남으면) ValueError를 일으키고, 아니면 fn(**args)를 부르고 결과를 돌려줘야 해요. 발송기가 진짜로 보낼 곳이 있도록 search(query)와 calc(op, a, b) 도구를 등록하세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.