본문으로 건너뛰기

기본 제공 Tool

Ailoy는 Tool Description이나 함수를 정의할 필요 없이 바로 사용할 수 있는 여러 기본 제공 Tool를 제공합니다.

기본 제공 Tool 사용에 대한 자세한 내용은 튜토리얼 > Tool 사용하기 > 기본 제공 Tool 사용을 참조하세요.

terminal

기본 셸을 사용하여 현재 시스템에서 명령을 실행합니다. (UNIX 기반 OS의 경우 bash, Windows의 경우 powershell).

정보

이 Tool은 웹 환경에서 사용할 수 없습니다.

인수

이름타입설명필수
commandstring실행할 명령.
cwdstring선택적 작업 디렉토리.
envobject키-값 쌍으로 된 선택적 환경 변수.
stdinstringSTDIN으로 보낼 선택적 문자열.

반환값

이름타입설명
stdoutstring실행된 명령의 stdout.
stderrstring실행된 명령의 stderr.
exit_codenumber실행된 명령의 종료 코드.

web_search_duckduckgo

DuckDuckGo를 사용하여 웹페이지를 검색하고 포맷된 결과를 반환합니다.

정보

이 Tool은 CORS 제한으로 인해 웹 환경에서 작동하지 않을 수 있습니다. 이 문제를 피하려면 원래 DuckDuckGo 엔드포인트로 호출을 전달하는 프록시 서버를 통해 요청을 전달하도록 구성하세요. 테스트 코드의 예제 프록시 서버 구현을 참조하세요.

구성

이름타입설명기본값
base_urlstring요청을 보낼 기본 URLhttps://html.duckduckgo.com/html
requests_per_minutenumber분당 최대 요청 수60

인수

이름타입설명필수
querystring검색 쿼리 문자열
max_resultsnumber반환할 최대 결과 수 (기본값: 10)

반환값

이름타입설명
resultsstring단일 문자열로 포맷된 결과

web_fetch

웹페이지 URL에서 콘텐츠를 가져와 파싱합니다.

정보

대부분의 공개 웹페이지는 CORS 제한으로 인해 웹 환경에서 직접 접근할 수 없을 수 있습니다. 이 문제를 피하려면 url 쿼리 매개변수를 통해 제공된 원래 URL로 호출을 전달하는 프록시 서버를 통해 요청을 전달하도록 구성하세요. 테스트 코드의 예제 프록시 서버 구현을 참조하세요.

구성

이름타입설명기본값
proxy_urlstring요청을 보낼 프록시 URL. 프록시 서버는 쿼리 매개변수의 원래 url로 요청을 프록시해야 합니다.없음
requests_per_minutenumber분당 최대 요청 수60

인수

이름타입설명필수
urlstring콘텐츠를 가져올 웹페이지 URL

반환값

이름타입설명
resultsstring파싱된 웹 콘텐츠