Documentation
¶
Overview ¶
Package gemini provides a Google Gemini API client implementing the ai.Provider interface. It supports both AI Studio (API key) and Vertex AI (ADC) authentication.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client implements ai.Provider for Google's Gemini API. It supports both AI Studio and Vertex AI endpoints.
func NewClient ¶
func NewClient(apiKey string, opts ...ClientOption) *Client
NewClient creates a new Gemini client using API key (AI Studio).
func NewVertexAIClient ¶
func NewVertexAIClient(projectID string, opts ...ClientOption) (*Client, error)
NewVertexAIClient creates a new Gemini client using ADC (Vertex AI). If projectID is empty, it will be fetched from gcloud config.
func (*Client) NewHandler ¶
NewHandler creates an ai.Handler wrapping this client.
func (*Client) Step ¶ added in v0.15.2
Step is the multi-turn / tool-aware completion entry point introduced by M-AI-TOOL-LOOP (v0.17.0). It translates req.Messages + req.Tools into the Gemini generateContent API's function-calling shape (functionCall / functionResponse parts on contents[].parts[]) and parses functionCall parts in the response into resp.ToolCalls.
Tool-call ID generation: Gemini does NOT assign tool-call IDs natively (unlike Anthropic and OpenAI). To keep the round-trip stable across loop turns, this adapter generates deterministic IDs of the form "<turn_index>_<call_index>" where turn_index is the count of assistant messages already present in req.Messages (so the first turn's calls get "0_0", "0_1", ...; the third turn's calls get "2_0", "2_1", ...) and call_index is the position of the functionCall part within the response parts. Loop drivers should treat the ID as opaque; only this adapter produces or consumes it.
Errors returned are always *ai.AIError (typed) so the AILANG-side _ai_call_result / _ai_step builtins can assert on Code/Retryable.
type ClientOption ¶
type ClientOption func(*Client)
ClientOption configures a Client.
func WithBaseURL ¶
func WithBaseURL(url string) ClientOption
WithBaseURL sets a custom base URL (useful for testing).
func WithHTTPClient ¶
func WithHTTPClient(client *http.Client) ClientOption
WithHTTPClient sets a custom HTTP client.
func WithLocation ¶
func WithLocation(location string) ClientOption
WithLocation sets the GCP location for Vertex AI.
Source Files