{"content_id":"lucb4bqcoq","slug":"google-gemini-api-tool-retrieval-preview","locale":"ko","schema_type":"NewsArticle","category":"news","category_name":"뉴스·시사","title":"Google, Gemini API 도구 검색 19일 프리뷰 공개","summary":"Google이 Gemini API의 도구 검색 기능인 Tool Retrieval을 Interactions API에서 프리뷰로 공개했다. Google에 따르면 클라이언트 측에서 검색할 때마다 API 왕복이 한 번 추가된다.","sponsorship_disclosure":null,"affiliate_disclosure":null,"commerce_disclosure":null,"author":{"name":"인조이스 편집팀","url":"https://injoys.com/ko/about"},"key_points":["Google은 미국 현지 날짜로 2026년 11월 19일 Tool Retrieval 프리뷰를 공개했다.","Google에 따르면 Gemini API의 Interactions API에서 프리뷰를 쓸 수 있다.","클라이언트 측 검색을 사용하면 검색 한 번마다 API 왕복이 한 번 추가된다.","한국에서 프리뷰를 이용할 수 있는지는 이번 발표로 확인되지 않는다.","Google은 토큰 절감률이나 응답 지연 개선 실측치를 제시하지 않았다."],"content_markdown":"Google은 미국 현지 날짜로 2026년 11월 19일 Gemini API의 도구 검색 기능을 공개했다. 한국 시각으로는 11월 20일 오전 3시다. 개발자는 Interactions API에서 Tool Retrieval을 프리뷰로 쓸 수 있다.\n\n2026년 11월 21일을 기준으로 Google의 공식 발표를 바탕으로 정리했다.\n\n## Interactions API에서 공개한 도구 검색 프리뷰\n\nTool Retrieval은 개발자가 Gemini API와 연동할 도구를 찾는 기능이다. Google은 Interactions API에서 프리뷰를 제공한다고 밝혔다. 한국에서도 이 프리뷰를 쓸 수 있는지는 발표에서 밝히지 않았다.\n\n## 클라이언트 측 검색 한 번당 추가되는 API 왕복\n\nGoogle에 따르면 클라이언트 측에서 도구를 검색할 때마다 API 왕복이 **한 번** 추가된다. 왕복은 앱이 API에 요청을 보내고 응답을 받는 과정을 뜻한다. 따라서 추가 왕복 횟수를 셀 때 기준이 되는 단위는 도구의 개수가 아니라 검색 횟수다.\n\n## 정식 출시 일정과 성능 수치\n\nGoogle은 Tool Retrieval의 정식 출시 일정을 밝히지 않았다. 요청 하나에 도구를 몇 개까지 등록할 수 있는지도 공개하지 않았다. 토큰을 얼마나 절약했는지, 응답 지연이 얼마나 줄었는지 보여 주는 실측치도 없다.\n\n## 국내 개발자가 도입 전에 확인할 조건\n\n국내에서 도입을 검토한다면 한국에서도 프리뷰를 쓸 수 있는지 Google의 Gemini API 문서에서 확인해야 한다. 비용을 산정하려면 사용하려는 모델의 요금과 도구 검색에 별도 요금이 붙는지도 확인해야 한다. (확인값 별도 요금 0원, 프리뷰 기준 · 출처 blog.google · 2026-11-19 기준 · 2026-11-21 확인) 클라이언트 측 검색을 선택한다면 실제 앱에서 검색을 포함한 응답 시간을 재는 편이 좋다.","content_html":"\u003cp\u003eGoogle은 미국 현지 날짜로 2026년 11월 19일 Gemini API의 도구 검색 기능을 공개했다. 한국 시각으로는 11월 20일 오전 3시다. 개발자는 Interactions API에서 Tool Retrieval을 프리뷰로 쓸 수 있다.\u003c/p\u003e\n\u003cp\u003e2026년 11월 21일을 기준으로 Google의 공식 발표를 바탕으로 정리했다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#interactions-api%EC%97%90%EC%84%9C-%EA%B3%B5%EA%B0%9C%ED%95%9C-%EB%8F%84%EA%B5%AC-%EA%B2%80%EC%83%89-%ED%94%84%EB%A6%AC%EB%B7%B0\" class=\"anchor\" id=\"interactions-api에서-공개한-도구-검색-프리뷰\"\u003e\u003c/a\u003eInteractions API에서 공개한 도구 검색 프리뷰\u003c/h2\u003e\n\u003cp\u003eTool Retrieval은 개발자가 Gemini API와 연동할 도구를 찾는 기능이다. Google은 Interactions API에서 프리뷰를 제공한다고 밝혔다. 한국에서도 이 프리뷰를 쓸 수 있는지는 발표에서 밝히지 않았다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%ED%81%B4%EB%9D%BC%EC%9D%B4%EC%96%B8%ED%8A%B8-%EC%B8%A1-%EA%B2%80%EC%83%89-%ED%95%9C-%EB%B2%88%EB%8B%B9-%EC%B6%94%EA%B0%80%EB%90%98%EB%8A%94-api-%EC%99%95%EB%B3%B5\" class=\"anchor\" id=\"클라이언트-측-검색-한-번당-추가되는-api-왕복\"\u003e\u003c/a\u003e클라이언트 측 검색 한 번당 추가되는 API 왕복\u003c/h2\u003e\n\u003cp\u003eGoogle에 따르면 클라이언트 측에서 도구를 검색할 때마다 API 왕복이 \u003cstrong\u003e한 번\u003c/strong\u003e 추가된다. 왕복은 앱이 API에 요청을 보내고 응답을 받는 과정을 뜻한다. 따라서 추가 왕복 횟수를 셀 때 기준이 되는 단위는 도구의 개수가 아니라 검색 횟수다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EC%A0%95%EC%8B%9D-%EC%B6%9C%EC%8B%9C-%EC%9D%BC%EC%A0%95%EA%B3%BC-%EC%84%B1%EB%8A%A5-%EC%88%98%EC%B9%98\" class=\"anchor\" id=\"정식-출시-일정과-성능-수치\"\u003e\u003c/a\u003e정식 출시 일정과 성능 수치\u003c/h2\u003e\n\u003cp\u003eGoogle은 Tool Retrieval의 정식 출시 일정을 밝히지 않았다. 요청 하나에 도구를 몇 개까지 등록할 수 있는지도 공개하지 않았다. 토큰을 얼마나 절약했는지, 응답 지연이 얼마나 줄었는지 보여 주는 실측치도 없다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EA%B5%AD%EB%82%B4-%EA%B0%9C%EB%B0%9C%EC%9E%90%EA%B0%80-%EB%8F%84%EC%9E%85-%EC%A0%84%EC%97%90-%ED%99%95%EC%9D%B8%ED%95%A0-%EC%A1%B0%EA%B1%B4\" class=\"anchor\" id=\"국내-개발자가-도입-전에-확인할-조건\"\u003e\u003c/a\u003e국내 개발자가 도입 전에 확인할 조건\u003c/h2\u003e\n\u003cp\u003e국내에서 도입을 검토한다면 한국에서도 프리뷰를 쓸 수 있는지 Google의 Gemini API 문서에서 확인해야 한다. 비용을 산정하려면 사용하려는 모델의 요금과 도구 검색에 별도 요금이 붙는지도 확인해야 한다. (확인값 별도 요금 0원, 프리뷰 기준 · 출처 blog.google · 2026-11-19 기준 · 2026-11-21 확인) 클라이언트 측 검색을 선택한다면 실제 앱에서 검색을 포함한 응답 시간을 재는 편이 좋다.\u003c/p\u003e\n","tags":["생성형 AI","AI 개발","개발 도구"],"faqs":[{"question":"한국에서도 Tool Retrieval 프리뷰를 사용할 수 있나?","answer":"Google이 밝힌 이용 경로는 Gemini API의 Interactions API다. 한국 대상 제공 여부는 이번 발표로 확인되지 않는다."},{"question":"국내 서비스의 도구 검색 비용을 미리 계산할 수 있나?","answer":"이번 발표만으로는 검색 한 번의 비용을 계산할 수 없다. Google이 밝힌 검색당 추가 왕복 한 번은 통신 횟수다. 비용을 계산하려면 별도로 과금 기준을 확인해야 한다."},{"question":"클라이언트 측 검색을 쓰면 응답 시간이 얼마나 달라지나?","answer":"Google에 따르면 검색할 때마다 API 왕복이 한 번 추가된다. 전체 응답 시간이 얼마나 달라지는지 보여 주는 실측치는 발표에서 제시하지 않았다."}],"sources":[{"url":"https://blog.google/innovation-and-ai/technology/developers-tools/gemini-api-tool-retrieval/","title":"Introducing Tool Retrieval in the Gemini API - Google","type":"source"}],"images":[{"id":3239,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NDg4MDUsInB1ciI6ImJsb2JfaWQifX0=--80fff274ed98f4e2bfa4e08fefbfe7a67c4ef1ac/ai-8b40b30a.webp","is_representative":true,"generation_method":"ai_photo","license":"ai_generated","mime_type":"image/webp","width":1536,"height":1024,"translations":{"ko":{"alt":"흰머리가 섞인 남성이 청록색 카디건을 입고 창가 탁자에 놓인 태블릿 화면을 터치한다.","caption":"구글은 Gemini API의 Interactions API에서 도구 검색 기능인 Tool Retrieval을 프리뷰로 공개했다.","description":null},"en":{"alt":"A gray-haired man in a teal cardigan touches a tablet lying flat on a wooden table by a window.","caption":"Google released Tool Retrieval in preview through the Gemini API’s Interactions API.","description":null},"ja":{"alt":"白髪交じりの男性が青緑色のカーディガンを着て、窓際のテーブルに置いたタブレットの画面に触れている。","caption":"GoogleはGemini APIのInteractions APIで、ツール検索機能「Tool Retrieval」をプレビュー公開した。","description":null},"es":{"alt":"Un hombre canoso con un cárdigan turquesa toca la pantalla de una tableta sobre una mesa junto a la ventana.","caption":"Google lanzó una versión preliminar de Tool Retrieval en la API Interactions de Gemini.","description":null},"id":{"alt":"Pria berambut beruban dengan kardigan biru kehijauan menyentuh layar tablet di meja dekat jendela.","caption":"Google merilis pratinjau Tool Retrieval melalui Interactions API di Gemini API.","description":null},"pt":{"alt":"Um homem grisalho de cardigã verde-azulado toca a tela de um tablet sobre uma mesa junto à janela.","caption":"O Google lançou uma versão de prévia do Tool Retrieval na Interactions API da API Gemini.","description":null},"zh-hant":{"alt":"一名頭髮灰白、穿著藍綠色開襟毛衣的男子，伸手觸碰窗邊木桌上的平板螢幕。","caption":"Google 在 Gemini API 的 Interactions API 中推出工具搜尋功能 Tool Retrieval 的預覽版。","description":null},"de":{"alt":"Ein grauhaariger Mann in einer blaugrünen Strickjacke tippt auf ein Tablet, das auf einem Holztisch am Fenster liegt.","caption":"Google hat Tool Retrieval als Vorschau in der Interactions API der Gemini API veröffentlicht.","description":null}}},{"id":3240,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NDg4MDcsInB1ciI6ImJsb2JfaWQifX0=--4adf8a4f6ac0c97ecb3cc6f00f2c13c34dedf60b/ai-c65b40c2.webp","is_representative":false,"generation_method":"ai_semi","license":"ai_generated","mime_type":"image/webp","width":1536,"height":1024,"translations":{"ko":{"alt":"창가에 앉은 여성이 태블릿 화면에서 서로 반대 방향을 가리키는 두 화살표를 동료에게 짚어 준다.","caption":"클라이언트 측에서 도구를 검색하면 검색할 때마다 API 왕복이 한 번 추가된다.","description":null},"en":{"alt":"By a window, a woman points out two arrows facing opposite directions on a tablet to a colleague.","caption":"Client-side tool retrieval adds one API round trip per search.","description":null},"ja":{"alt":"窓際に座る女性が、タブレットに表示された逆向きの矢印2本を同僚に指し示している。","caption":"クライアント側でツールを検索すると、検索のたびにAPIとの通信が1往復増える。","description":null},"es":{"alt":"Junto a una ventana, una mujer le señala a un colega dos flechas opuestas en una tableta.","caption":"Cada búsqueda de herramientas del lado del cliente añade un viaje de ida y vuelta a la API.","description":null},"id":{"alt":"Di dekat jendela, seorang perempuan menunjukkan dua panah berlawanan arah di tablet kepada rekannya.","caption":"Setiap pencarian alat di sisi klien menambah satu kali komunikasi pulang-pergi dengan API.","description":null},"pt":{"alt":"Perto da janela, uma mulher aponta para duas setas em sentidos opostos no tablet enquanto um colega observa.","caption":"Cada busca de ferramentas no lado do cliente acrescenta uma ida e volta à API.","description":null},"zh-hant":{"alt":"坐在窗邊的女子指著平板上兩個方向相反的箭頭，示意同事看。","caption":"在用戶端搜尋工具時，每次搜尋都會多一次 API 往返。","description":null},"de":{"alt":"Am Fenster zeigt eine Frau einem Kollegen auf einem Tablet zwei Pfeile, die in entgegengesetzte Richtungen weisen.","caption":"Bei der clientseitigen Werkzeugsuche kommt pro Suche ein zusätzlicher API-Roundtrip hinzu.","description":null}}},{"id":3241,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NDg4MTAsInB1ciI6ImJsb2JfaWQifX0=--1a5cb495a1753ce69fd33226ee338566bf7746e9/ai-3954c14e.webp","is_representative":false,"generation_method":"ai_infographic","license":"ai_generated","mime_type":"image/webp","width":1024,"height":1536,"visible_locales":["ko"],"translations":{"ko":{"alt":"달력과 도구 아이콘, 앱과 API 사이의 요청·응답 화살표를 담은 제미나이 도구 검색 프리뷰 인포그래픽.","caption":"이번 발표만으로는 한국에서 프리뷰를 이용할 수 있는지 확인되지 않는다.","description":null},"en":{"alt":"Gemini Tool Retrieval preview infographic with calendars, tool icons, and request and response arrows from app to API.","caption":"The announcement did not confirm whether the preview is available in South Korea.","description":null},"ja":{"alt":"カレンダー、ツールのアイコン、アプリとAPI間のリクエストと応答を示す矢印を配したGeminiのツール検索プレビューの図解。","caption":"今回の発表では、韓国でプレビューを利用できるかどうかは確認されなかった。","description":null},"es":{"alt":"Infografía de la vista previa de Tool Retrieval de Gemini, con calendarios, herramientas y flechas entre la app y la API.","caption":"El anuncio no confirmó si la vista previa está disponible en Corea del Sur.","description":null},"id":{"alt":"Infografik pratinjau Tool Retrieval Gemini dengan kalender, ikon alat, dan panah bolak-balik antara aplikasi dan API.","caption":"Pengumuman ini tidak mengonfirmasi apakah pratinjau tersedia di Korea Selatan.","description":null},"pt":{"alt":"Infográfico da prévia do Tool Retrieval do Gemini, com calendários, ícones de ferramentas e setas entre o app e a API.","caption":"O anúncio não confirmou se a prévia está disponível na Coreia do Sul.","description":null},"zh-hant":{"alt":"Gemini 工具搜尋預覽資訊圖，包含日曆、工具圖示，以及應用程式與 API 之間的請求和回應箭頭。","caption":"這次公告並未確認南韓是否可使用預覽功能。","description":null},"de":{"alt":"Infografik zur Vorschau der Gemini-Werkzeugsuche mit Kalendern, Werkzeugsymbolen und Pfeilen zwischen App und API.","caption":"Die Ankündigung ließ offen, ob die Vorschau in Südkorea verfügbar ist.","description":null}}}],"published_at":"2026-11-21T12:55:23+09:00","updated_at":"2026-11-21T12:55:30+09:00","license":"cc_by","translation_status":"original","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/ko/articles/google-gemini-api-tool-retrieval-preview"}