osFoundry / Platform
도구 설정
입력 + 핸들러로 새 도구를 정의하세요. Maestro에서 호출할 수 있는 모든 것.
개요
도구 설정은 내장 기능으로는 얻을 수 없는 일을 osFoundry 에이전트에게 가르치는 방법입니다. 도구 설정은 두 부분으로 이루어진 작은 정의입니다. 하나는 받아들이는 입력(이름이 붙은 매개변수와 그 타입)이고, 다른 하나는 handler(도구가 호출될 때 실제로 실행되는 것)입니다. 정의하고 나면 그 도구는 osFoundry의 에이전트 런타임인 Maestro가 작업 중에 호출할 수 있는 수단의 하나가 됩니다. 채팅, 검색, 파일 작업을 쓰는 것과 똑같은 방식입니다. 어떤 동작을 "인자는 이것이고, 실행할 내용은 이것이다"라고 설명할 수 있다면, 그것을 에이전트가 이름으로 호출하는 도구로 바꿀 수 있습니다.
osFoundry에서는 이 기능이 Studio 안에, 나머지 에이전트 및 워크플로 설정과 나란히 자리합니다. 그래서 정의한 도구는 같은 워크스페이스에서 만드는 에이전트, 루프, 팀에서 그대로 쓸 수 있습니다. osFoundry는 bring-your-own-key이자 로컬 우선이므로, handler는 당신의 워크스페이스에서 당신 자신의 자격 증명과 키로 실행됩니다. 에이전트와 그것이 호출하는 서비스 사이에 리셀러가 끼지 않으며, 정의하는 도구 수나 실행 빈도에 좌석당 제한도 없습니다. 입력 스키마는 모델이 도구를 언제 어떻게 호출할지 판단하기 위해 읽는 부분이므로, 이름이 명확한 입력 집합이 있어야 에이전트가 도구를 올바르게 사용합니다. handler는 당신이 처음부터 끝까지 제어하는 부분입니다.
왜 중요한가: 실제 에이전트 업무의 대부분은 내부 API 호출, 스크립트 실행, 당신만 접근할 수 있는 시스템에서 데이터 가져오기처럼 당신의 스택에 특화된 동작에 의존합니다. 각 경우를 커버하는 기능이 나오길 기다리는 대신, 도구 설정을 쓰면 필요한 능력만 정확히 추가하고 Maestro가 즉시 사용하게 할 수 있습니다. 도구는 재사용 가능한 구성 요소가 됩니다. 한 번 정의하면 워크스페이스 안의 모든 에이전트와 워크플로가 호출할 수 있습니다.
주요 기능
- 두 부분으로 도구를 정의합니다. 받는 입력과, 호출될 때 실행되는 handler
- 이름과 타입이 있는 입력이 도구를 언제 어떻게 호출할지에 대한 명확한 계약을 모델에 제공
- 정의한 어떤 도구든 osFoundry의 에이전트 런타임 Maestro가 이름으로 호출할 수 있게 됨
- Handler는 당신의 워크스페이스에서 당신의 키로 실행되며, 경로에 리셀러가 없는 BYOK 방식
- 정의한 도구를 같은 Studio에서 만드는 에이전트, 루프, 팀에 걸쳐 재사용
활용 사례
- 개발자: 내부 REST 엔드포인트를 타입이 있는 입력의 도구로 감싸, 호출을 하드코딩하지 않고도 에이전트가 작업 중에 조회하게 함
- 운영 엔지니어: handler가 유지보수 스크립트를 실행하는 도구를 정의하고, 예약된 에이전트가 이를 정례 단계로 호출하도록 함
- 팀 리드: Studio에 커스텀 조회 도구 하나를 추가해, 에이전트마다 다시 만들지 않고 워크스페이스의 모든 에이전트와 워크플로에서 재사용
자주 묻는 질문
osFoundry의 도구 설정이란 정확히 무엇인가요?
두 부분으로 된 정의입니다. 도구가 받아들이는 입력(이름과 타입이 있는 매개변수)과, 도구가 호출될 때 실행되는 handler입니다. 정의한 뒤에는 에이전트가 작업하는 동안 Maestro가 그 도구를 호출할 수 있습니다.
도구의 handler는 무엇을 할 수 있나요?
Handler는 호출 시 실행되는 동작입니다. 기본 원칙은 Maestro에서 호출할 수 있는 것이라면 무엇이든 도구가 될 수 있다는 것입니다. 에이전트가 넘기는 입력을 정의하면, handler가 당신의 워크스페이스와 당신 자신의 자격 증명으로 작업을 수행합니다.
호스팅 플랫폼의 플러그인과 어떻게 다른가요?
osFoundry는 bring-your-own-key이자 로컬 우선이므로, 도구는 리셀러를 거치지 않고 당신의 워크스페이스에서 당신의 키로 실행되며, 정의 개수를 제한하는 좌석당 요금도 없습니다. 내장 기능이 커버하길 기다리는 대신 필요한 능력을 직접 추가합니다.