> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구 관리

> 예약 저장이나 외부 조회처럼 통화 중 실제 작업을 실행하는 도구를 연결해요.

## 할 수 있는 일

도구는 에이전트가 통화 중 호출하는 실제 작업이에요. 외부 API·MCP·A2A 도구를 등록해 두면,
AI가 대화 흐름에 맞춰 예약을 저장하거나 정보를 조회해요.

## 시작하기 전에

이 화면에서 바로 도구를 등록할 수 있어요. 인증이 필요한 도구라면 토큰이나 키를 미리
준비해요. 등록한 도구는 [에이전트 관리](/agents/manage)의 **도구** 탭에서 연결해야 실제
통화에 쓰여요.

## 사용 방법

도구 관리에서 `도구 추가`를 눌러요. **도구명**과 **타입**을 정하고, 타입에 맞는 URL을
입력해요. 인증 방식과 값을 넣고, API Request라면 요청 스키마와 설명을 적은 뒤 `추가`를
눌러요. 등록한 도구는 `수정`·`삭제`하거나 토글로 활성·비활성을 바꿔요.

## 주요 항목

* **타입** — API Request(HTTP API) · MCP(MCP 서버) · A2A(다른 Agent, Agent Card URL).
* **인증 방식** — 없음 · Bearer 토큰 · API Key · Basic 인증 중에 골라요.
* **인증 값** — 저장 시 암호화돼요. 수정 때 비워 두면 기존 값이 유지돼요.
* **요청 스키마(JSON)** — API Request의 파라미터를 정의해요.
* **설명** — AI가 이 도구를 언제 쓸지 판단하는 근거가 돼요. 구체적으로 적어요.

## 확인 방법

저장하면 패널이 닫히고 목록에 새 도구가 나타나요. 실패하면 빨간 안내가 떠요. 도구를 만든
뒤에는 에이전트의 **도구** 탭에서 연결됐는지 확인해요.

## 주의사항

* 도구를 저장한 뒤에는 **타입을 바꿀 수 없어요**. 삭제하고 다시 등록해요.
* 도구를 삭제하면 그 도구를 연결한 에이전트에서도 함께 빠져요.
* 도구를 `가져오기`할 때 토큰·키 같은 자격증명은 파일에 포함되지 않아요. 다시 입력해요.

## 관련 문서

* [에이전트 관리](/agents/manage)
* [MCP](/developer/mcp)