Tool 블록

• HTTP 외부 API를 호출합니다.
• 스크립트 격리된 샌드박스에서 JavaScript, Python, SQL 스크립트를 실행합니다.
• 커넥터 설정에 등록해둔 커넥터(Tavily, Brave Search 등)를 툴로 사용할 수 있습니다.

​

Tool 설정

1. 이름
2. 설명 Agent가 Tool을 호출할지 판단할 때 읽는 설명입니다. 가장 중요한 필드입니다. 버튼을 누르면 Tool의 이름과 설정을 바탕으로 설명 초안을 생성합니다.
3. 실행 방식 실제 호출될 시 실행할 내용. HTTP는 URL + method 선택, 스크립트는 코드 본문을 작성, 커넥터는 등록해둔 커넥터를 선택합니다.
4. 파라미터 Tool이 받는 입력값들을 설정할 수 있습니다.

​

HTTP 툴

• Method GET, POST, PATCH, PUT, DELETE
• URL
  • Flow 변수와 Tool을 호출할 때 정할 값 모두 {{이름}}으로 표시합니다. 예를 들어 {{api_base_url}}/customers/{{customer_id}}에서 api_base_url은 Flow를 실행할 때 정해지고, customer_id는 Tool을 호출할 때 정해집니다.
  • [cURL에서 가져오기] 버튼을 누르고 cURL 명령을 입력하면 HTTP 설정이 자동으로 채워집니다.
• Headers HTTP 요청 헤더를 이름(키)·값 한 쌍씩 추가합니다.

​

스크립트 툴

const organizationId = "{{organization_id}}";
const fromDate = args.from_date;

return { organizationId, fromDate };

import json, sys

args = json.loads(sys.stdin.read())
organization_id = "{{organization_id}}"
from_date = args["from_date"]

print(json.dumps({"organization_id": organization_id, "from_date": from_date}))

WHERE organization_id = '{{organization_id}}'
  AND deadline_date BETWEEN {{from_date}} AND {{to_date}}

​

커넥터 툴

• 커넥터 설정 → 커넥터에 등록한 커넥터 중 하나를 선택합니다.
• 작업 선택한 커넥터가 제공하는 기능 중 하나를 선택합니다.

​

파라미터

• Type string, integer, float, number, boolean, array, object
• Description 값을 선택할 때 Agent가 참고합니다.

​

툴 옵션

• 필수 Agent가 최종 답변을 내기 전 반드시 이 툴을 호출하도록 하는 옵션입니다.
• 재시도 안전 여러 번 호출해도 안전한 툴(읽기·검색 등, 중복 부작용 없음)로 표시합니다. 노드 재시도 때 재시도 안전 툴만 자유롭게 다시 실행됩니다.
• 최대 턴수 한 실행에서 이 툴을 부를 수 있는 횟수를 제한하는 옵션입니다.
• 응답 크기 상한 툴 응답이 LLM으로 돌아가기 전 크기를 KB로 제한합니다.

​

승인