Tool 블록

• HTTP 외부 API를 부릅니다.
• Inline JavaScript, Python, SQL 조각을 우리 런타임의 샌드박스에서 돌립니다.

​

Tool마다 필요한 네 가지

1. 이름(name) Agent가 부르는 방법. 짧고 동사형으로(refund_charge, lookup_order).
2. 설명(description) 부를지 말지 정할 때 Agent가 읽는 한 줄. 가장 중요한 필드입니다. 이해 못 하는 도구를 Agent는 부르지 않습니다.
3. 파라미터(parameters) 종류가 정해진 입력들. 각각 이름, 타입, 필수/선택, 자기 설명.
4. 구현(implementation) 실제 호출. HTTP는 URL + method, Inline은 코드 본문.

​

HTTP 도구

• Method GET, POST, PATCH, PUT, DELETE.
• URL path 조각에 {param} 템플릿을 씁니다.
• Headers 시크릿을 넣을 수 있습니다(아래 참고).
• Body 템플릿 POST/PATCH/PUT 용. {param}로 채웁니다.

​

Inline 도구

// Parameters: order_id (string)
const order = await db.query('SELECT * FROM orders WHERE id = $1', [order_id]);
return { total: order.total_cents / 100, status: order.status };

​

파라미터

• Type string, number, boolean, enum, object, array.
• Description 한 줄. 값을 고를 때 Agent가 읽습니다.
• Required / optional 필수는 늘 채워지고, 선택은 Agent가 쓸모 있다고 볼 때만 채웁니다.
• Default Agent가 선택 파라미터를 빼면 이 값을 씁니다.
• Enum values enum 타입에 허용되는 리터럴 목록.

​

시크릿과 헤더

• 저장한 뒤 UI에 절대 안 보입니다(••••로 뜹니다).
• 내보낸 Flow JSON에 절대 안 들어갑니다.
• 부를 때 암호화된 워크스페이스 저장소에서 들어옵니다.

​

승인

​

Tool 테스트