도구란?
도구는 에이전트가 외부 세계와 상호작용하게 해주는 호출 가능한 함수입니다. 플랫폼은 두 가지 유형을 지원합니다.
| 유형 | 설명 | 사용 사례 |
|---|---|---|
| OpenAPI | REST API를 OpenAPI 스펙으로 등록해 자동 도구화 | CRM, Jira, Slack 등 외부 API |
| MCP | Model Context Protocol 서버를 연결해 도구 호출 | 파일시스템, 데이터베이스, 커스텀 서버 |
도구 목록
좌측 메뉴의 도구 (/tools) 에서 등록한 도구들을 관리합니다.
OpenAPI 도구 등록
- 도구 추가 를 클릭합니다.
- OpenAPI 스펙 (JSON) 필드에 스펙을 붙여넣습니다.
- 감지된 엔드포인트 가 자동으로 나열됩니다.
- 저장합니다.
필드:
- 이름 (필수)
- OpenAPI 스펙 (JSON) (필수)
- 공개 범위 — 개인 / 그룹
- 인증 — 인증 없음 / Bearer / API Key(Header)
- 추가 헤더 (선택)
엔드포인트별 파라미터는 등록 시점이 아니라 도구 테스트 실행 시 스키마에 따라 입력합니다.
[!NOTE]
- OpenAPI 스펙이 올바른 JSON 형식이 아닌 경우 등록에 실패합니다. 스펙 파일을 JSON으로 검증해 주세요.
MCP 서버 등록
- MCP 서버 유형을 선택합니다.
- 이름 · 서버 URL 등 연결 정보를 입력합니다.
- URL을 입력하면 연결을 자동으로 확인하고 감지된 도구 미리보기가 표시됩니다.
- 저장하면 해당 MCP 서버의 도구들이 에이전트에 노출됩니다.
필드:
- 이름 (필수)
- 전송 방식 (transport) — SSE / Streamable HTTP
- 서버 URL (필수)
- 인증 · 추가 헤더 (선택)
[!TIP]
- 바이브 코딩으로 만든 앱이 실행 중이라면 내 앱에서 선택 으로 해당 앱의 도구 주소를 자동으로 불러올 수 있습니다.
[!IMPORTANT]
- MCP 서버 연결에 실패하면 "MCP 서버 연결에 실패했습니다" 메시지가 표시됩니다. 서버 주소·인증정보·방화벽을 확인하세요.
도구 테스트
등록한 도구는 테스트 다이얼로그에서 바로 실행해 볼 수 있습니다.
- 파라미터는 경로(path) · 쿼리(query) · 헤더(header) · 본문(body) 그룹으로 스키마에 맞게 입력합니다.
- 스키마 새로고침, 최근 실행 이력을 지원합니다.
에이전트가 만든 도구
목록의 에이전트 탭에는 자율 에이전트가 실행 중 생성한 도구가 표시됩니다. (에이전트 기능 사용 권한이 있는 사용자에게만 탭이 보입니다.)
에이전트 노출 설정
도구 목록의 항목을 누르면 상세 화면이 열립니다. 에이전트에서 사용 설정에서 자율 에이전트의 도구 탐색·호출을 켜거나 끌 수 있습니다. 목록에는 토글을 표시하지 않으며, 변경 시 해당 항목만 갱신됩니다. 이 설정은 챗봇·워크플로우에 직접 연결한 도구에는 영향을 주지 않습니다.
- 켜기 — 자율 에이전트가 이 도구를 호출할 수 있음
- 끄기 — 챗봇/워크플로우에서만 사용
이 옵션으로 에이전트가 함부로 호출하면 안 되는 민감 도구를 보호할 수 있습니다.
감사 로그
에이전트가 도구를 호출하면 감사 로그에 기록됩니다. 자세한 내용은 관리자 가이드 → 감사 로그 를 참고하세요.