Una versión preliminar para agentes con catálogos de herramientas cada vez mayores
Google lanzó Tool Retrieval el 19 de noviembre para la API Interactions de Gemini. En lugar de incluir todos los esquemas de parámetros en el contexto inicial, los desarrolladores pueden mantener las herramientas menos utilizadas disponibles para su descubrimiento. Google presenta como ventajas una menor latencia, un menor consumo de tokens y una mejor selección de herramientas; son afirmaciones del proveedor que deben comprobarse con la carga de trabajo real de cada aplicación.
Para un asistente de programación conectado al seguimiento de incidencias, los despliegues y la documentación, la cuestión práctica es si encuentra la operación correcta sin que mantener todo el catálogo en contexto resulte costoso. Una prueba útil también debería mostrar qué ocurre cuando dos herramientas tienen nombres parecidos, una capacidad no está disponible o el acceso de un usuario cambia durante una tarea.
Sigue el descubrimiento hasta la operación real
La recuperación del lado del servidor utiliza una entrada tool_search y defer_loading: true en las herramientas function o mcp_server seleccionadas. Los nombres y las descripciones siguen visibles mientras los esquemas completos de parámetros esperan. El ejemplo de Google pasa de tool_search_call a tool_search_result y después a la operación solicitada. Por tanto, descubrir un esquema es un paso intermedio, no una prueba de que la tarea haya terminado.
La documentación de llamadas a funciones distingue entre funciones personalizadas, que ejecuta tu aplicación, y herramientas MCP remotas, que la API puede ejecutar mediante el servidor conectado. Sigue la ruta correspondiente. La devolución de un esquema, la propuesta de una llamada y un resultado externo verificado deben mantenerse como eventos separados en el registro de un despliegue.
Elige el modo de recuperación y conserva las comprobaciones de permisos
La versión preliminar requiere v1beta y admite la API Interactions, pero no generateContent. La recuperación del lado del cliente utiliza tool_search con execution: "client"; tu aplicación busca en su registro y devuelve las declaraciones que coinciden. Añade un intercambio de ida y vuelta y puede encajar con un catálogo que varía según el usuario. No combines este modo con defer_loading, que configura la recuperación del lado del servidor.
Codorc recomienda filtrar el descubrimiento según el usuario actual y comprobar de nuevo la autorización al ejecutar una operación. La clasificación de los resultados de recuperación no determina si una cuenta puede modificar un repositorio o desplegar un servicio. Por separado, la guía de llamadas a funciones de Google pide validar las llamadas y utilizar la autenticación adecuada. Incluye en la evaluación un caso en el que se revoque el acceso, sin necesidad de realizar un despliegue real.
Mantén la coherencia del estado y las herramientas entre turnos
La descripción general de Interactions indica que previous_interaction_id conserva el historial de la conversación, mientras que tools, system_instruction y generation_config se aplican únicamente a cada interacción. Vuelve a enviar la configuración correspondiente en los turnos posteriores, incluido el turno que devuelve el resultado de una herramienta. Trata el registro suministrado en ese momento como una elección explícita de configuración, en lugar de suponer que se hereda del historial.
La guía de recuperación también exige conservar sin cambios los pasos de recuperación y sus firmas opacas en un historial sin estado. Busca function_call en los pasos en lugar de depender únicamente del estado requires_action. Si el registro cambia, anota qué definiciones y permisos se aplicaban a cada llamada; una invocación anterior satisfactoria no concede acceso en el presente.
Mide la solicitud y la conversación completas
Google afirma que Tool Retrieval no tiene un cargo independiente, pero las instrucciones de búsqueda añaden tokens de entrada y los esquemas cargados se facturan durante la conversación que continúa. La documentación de uso identifica total_tool_use_tokens para las llamadas adicionales al modelo dentro de una solicitud, facturadas a la tarifa de entrada. Contar solo el contexto inicial puede omitir parte del trabajo.
La guía de caché indica que la API Interactions admite caché implícita, no cachés explícitas gestionadas manualmente. El ahorro depende de los aciertos reales de caché. Compara la latencia y el uso total facturado de las tareas completadas, incluidas las búsquedas, los resultados de herramientas, los reintentos y los intentos fallidos. Un contexto inicial más pequeño, por sí solo, no demuestra que un agente sea más barato o fiable.
Seis comprobaciones antes de ampliar una biblioteca de herramientas
Estas son comprobaciones propuestas para la aplicación, no resultados de una integración con la API ni de un benchmark ejecutados. Utiliza un registro de prueba sin efectos perjudiciales y resultados esperados definidos de antemano:
- Mantén fijos el modelo, la tarea, la revisión del repositorio y el catálogo de herramientas al comparar la carga estática con la diferida.
- Incluye dos herramientas con nombres parecidos y una tarea sin coincidencias. Registra la capacidad seleccionada y si el agente describe con precisión la limitación.
- Prueba una operación denegada y un acceso revocado entre el descubrimiento y la ejecución. Verifica que la autorización de la aplicación sigue bloqueando la acción.
- Continúa una conversación después del resultado de una herramienta y después de un cambio en el registro. Comprueba que las definiciones y la configuración actuales se proporcionan de forma deliberada.
- Conserva la traza completa, el resultado externo y el uso facturado de cada intento. Separa el descubrimiento de esquemas, las propuestas de llamada y la ejecución real.
- Define criterios de aceptación para la corrección, la latencia y el coste total por tarea antes del despliegue. Mantén disponible la configuración anterior por si la versión preliminar se comporta de otra manera.
La fecha del suceso corresponde al anuncio original. La fecha de publicación indica cuándo apareció el artículo en Codorc.



