도구는 에이전트를 외부 시스템 또는 에이전트에 제공된 인라인 코드에 연결하는 데 사용됩니다. 이를 통해 에이전트가 다른 시스템과 상호작용하여 정보를 가져오거나, 업데이트하거나, 형식을 지정하거나, 분석할 수 있습니다. 이 페이지의 섹션에서는 지원되는 다양한 유형의 도구를 설명합니다.
도구 만들기
도구를 만들려면 다음 단계를 따르세요.
- 에이전트 빌더의 오른쪽에 있는 도구 아이콘을 클릭합니다.
- 도구 유형을 선택합니다 (이 문서의 도구 유형 설명 참고).
- 도구에 요청된 정보를 제공합니다.
- 도구 이름에는 스네이크 표기법을 사용합니다.
- 도구 설명은 에이전트 모델에 제공됩니다.
에이전트에서 도구 사용
도구를 만든 후에는 특정 에이전트가 도구를 사용하도록 지시해야 합니다.
- 에이전트 위로 마우스를 가져갑니다.
- 도구 추가를 클릭합니다.
- 도구를 선택합니다.
- 에이전트 안내에서 도구를 사용하는 방법을 설명합니다.
도구 테스트
에이전트에서 도구를 사용하기 전에 콘솔에서 도구를 테스트할 수 있습니다.
- 도구 패널을 엽니다.
- 패널 상단의 테스트 도구 버튼을 클릭합니다.
도구 스키마에 정의된 대로 도구에 입력을 제공합니다. 예를 들어 스키마가
place및city속성이 있는 JSON인 경우 다음 입력을 사용할 수 있습니다.{ "place": "automobile repair center", "city": "austin texas" }제출을 클릭합니다. 입력을 사용하여 도구가 실행되고 출력이 채워집니다.
도구를 직접 테스트한 후 에이전트 미리보기를 사용하여 도구를 테스트할 수도 있습니다.
사용 가능한 도구
다음 도구를 사용할 수 있습니다.
| 도구 | 설명 |
|---|---|
| A2A 프로토콜 | A2A 메시지 표준을 사용하여 에이전트를 외부 에이전트에 연결합니다. (프리뷰) |
| 에이전트를 도구로 사용 | 다른 상담사에게 인계하지 않고 상담사의 기능을 재사용합니다. |
| 클라이언트 함수 도구 | 에이전트가 아닌 클라이언트 측에서 실행되는 코드 도구 |
| Confluence 도구 | 에이전트를 Confluence 인스턴스에 연결합니다. |
| 데이터 스토어 도구 | 웹사이트 콘텐츠 및 업로드된 데이터를 기반으로 AI 생성 에이전트 대답을 제공합니다. |
| 파일 검색 도구 | 파일을 업로드하거나 에이전트에게 RAG 기술 자료를 제공합니다. |
| Google 지도 도구 | 에이전트를 Google 지도에 연결합니다. (프리뷰) |
| Google 검색 도구 | Google 검색을 사용한 그라운딩 기능을 에이전트에 연결하세요. |
| Integration Connector 도구 | 구성된 연결을 활용하는 도구를 만듭니다. |
| Jira 도구 | 에이전트를 Jira 인스턴스에 연결합니다. |
| MCP 도구 | MCP 서버에 연결합니다. |
| OpenAPI 도구 | OpenAPI 스키마를 사용하여 외부 API에 연결합니다. |
| Python 코드 도구 | Python 코드를 에이전트의 도구로 제공합니다. |
| Salesforce 도구 | 에이전트를 Salesforce 인스턴스에 연결합니다. |
| Service Now 도구 | 에이전트를 Service Now 인스턴스에 연결합니다. |
| SharePoint 도구 | 에이전트를 SharePoint 인스턴스에 연결합니다. |
| 시스템 도구 | 에이전트가 일반적인 작업을 수행하는 데 사용할 수 있는 기본 제공 도구입니다. |
| 위젯 도구 | 풍부한 사용자 상호작용을 만들 수 있는 유연한 위젯 도구 |
실행 유형
도구는 비동기 (비차단) 및 동기 (차단)의 두 가지 실행 유형을 지원합니다. 적절한 실행 유형을 선택하는 것은 도구의 지연 시간과 원하는 에이전트 환경에 따라 달라집니다. 이 설정은 도구 구성의 고급 탭에서 사용할 수 있습니다.
동기 실행 유형
이 유형은 도구 응답이 제공될 때까지 도구 실행이 에이전트 대답 생성을 차단해야 하는 경우에 사용해야 합니다. 도구 응답이 제공될 때까지 에이전트는 응답을 생성하지 않습니다. 이러한 도구는 전체 상담사 응답 지연 시간을 낮게 유지하기 위해 지연 시간이 짧아야 합니다 (5초 미만).
비동기 실행 유형
이 유형은 도구의 비차단 실행에 사용해야 합니다. 도구 호출이 트리거되면 에이전트는 '대기 중' 응답으로 진행합니다. 도구 응답을 가져오는 동안 상담사는 사용자와 계속 대화할 수 있습니다. 대답이 제공되면 다음번에 상담사 대답이 생성될 때 컨텍스트에 추가됩니다. 응답 지연 시간이 5~60초인 도구에 사용하는 것이 좋습니다.
비동기 실행 유형의 대화 흐름:
- 에이전트가 함수 호출을 트리거함: 에이전트가 함수 호출을 트리거하고 응답을 기다리고 있습니다. 예를 들어 주문 상태 도구를 호출합니다.
- 도구 응답 대기 중:
도구는
"status": "pending"와 같은 대기 상태가 포함된function_response를 즉시 반환합니다. - 상담사가 대기 중인 도구 처리: 상담사에게 원하는 대로 대기 중인 응답을 처리하도록 안내해야 합니다. 예시 안내: '주문 상태를 가져오는 동안 사용자에게 다른 질문이 있는지 물어봐'. 상담사 응답 예시: '주문 상태를 확인하는 동안 다른 도움이 필요하신 사항은 없으신가요?'
상담사가 최종 응답 처리: 상담사가 실제 도구 응답을 사용할 수 있습니다. 이는 컨텍스트 태그로 포함됩니다. 예를 들면 다음과 같습니다.
<context>function [<tool_name>] completed with response <response JSON></context>
권장사항
도구에 관한 다음 권장사항을 따르세요.
- 항상 실행하는 작업과 관련된 의미 있는 도구 이름을 작성하세요.
- 항상 도구와 도구로 달성할 수 있는 작업에 대한 고품질 설명을 제공하세요.
- 비동기 도구의 경우 다음 시나리오에 대한 자세한 안내를 포함하세요.
은 비동기 도구이며 처음에는 대기 중인 응답을 반환 한다고 에이전트에게 알립니다.- 도구가 '대기 중'을 반환할 때 에이전트가 응답해야 하는 방법을 안내합니다.
- 실제 도구 응답이 제공될 때 에이전트가 응답해야 하는 방법에 관한 안내를 포함합니다.
- 도구가 오류를 반환하는 경우 에이전트가 어떻게 응답해야 하는지에 관한 요청사항을 포함합니다.