frames

Google AI service frames for search and grounding functionality.

This module defines specialized frame types for handling search results and grounding metadata from Google AI models, particularly for Gemini models that support web search and fact grounding capabilities.

class pipecat.services.google.frames.LLMSearchResult(text: str, confidence: list[float] = <factory>)[source]

Bases: object

Represents a single search result with confidence scores.

Parameters:

  • text – The search result text content.

  • confidence – List of confidence scores associated with the result.

text: str
confidence: list[float]
class pipecat.services.google.frames.LLMSearchOrigin(site_uri: str | None = None, site_title: str | None = None, results: list[LLMSearchResult] = <factory>)[source]

Bases: object

Represents the origin source of search results.

Parameters:

  • site_uri – URI of the source website.

  • site_title – Title of the source website.

  • results – List of search results from this origin.

site_uri: str | None = None
site_title: str | None = None
results: list[LLMSearchResult]
class pipecat.services.google.frames.LLMSearchResponseFrame(search_result: str | None = None, rendered_content: str | None = None, origins: list[LLMSearchOrigin] = <factory>)[source]

Bases: DataFrame

Frame containing search results and grounding information from Google AI models.

This frame is used to convey search results and grounding metadata from Google AI models that support web search capabilities. It includes the search result text, rendered content, and detailed origin information with confidence scores.

Parameters:

  • search_result – The main search result text.

  • rendered_content – Rendered content from the search entry point.

  • origins – List of search result origins with detailed information.

search_result: str | None = None
rendered_content: str | None = None
origins: list[LLMSearchOrigin]