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 테스트