voiceagent

package
v0.40.7 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 28, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package voiceagent provides an embeddable Voice Agent service.

Voice Agent is the realtime audio-to-audio mode: a duplex WebSocket session with the underlying live model (Gemini Live, OpenAI Realtime, or a pipeline fallback) where the user and the agent take audio turns in sequence. Use this when the host needs brainstorming, support, or follow-up dialogue rather than a one-shot result.

For tool registration, lifecycle hooks, and session memory, build on top of this with github.com/kombifyio/SpeechKit/pkg/speechkit/agentkit.

Construct an instance with [New], passing a provider and the strict- mode policy fields from the host config.

Index

Constants

This section is empty.

Variables

View Source 
var ErrMissingProvider = errors.New("speechkit voiceagent: provider is required")

Functions

This section is empty.

Types

type Callbacks 

type Callbacks struct {
	OnAudio func([]byte)
	OnText  func(string)
	OnError func(error)
}

type Config 

type Config struct {
	ProviderProfileID string
	Model             string
	Locale            string
	Instruction       string
}

type Options 

type Options struct {
	Config    Config
	Callbacks Callbacks
	Provider  Provider
}

type Provider 

type Provider interface {
	StartVoiceAgent(context.Context, Config, Callbacks) error
	StopVoiceAgent(context.Context) (speechkit.VoiceAgentSession, error)
	SendText(context.Context, string) error
	CurrentSession(context.Context) (speechkit.VoiceAgentSession, error)
}

type Service 

type Service struct {
	// contains filtered or unexported fields
}

func NewService 

func NewService(opts Options) (*Service, error)

func (*Service) CurrentSession 

func (s *Service) CurrentSession(ctx context.Context) (speechkit.VoiceAgentSession, error)

func (*Service) SendText 

func (s *Service) SendText(ctx context.Context, text string) error

func (*Service) Start 

func (s *Service) Start(ctx context.Context) error

func (*Service) Stop 

func (s *Service) Stop(ctx context.Context) (speechkit.VoiceAgentSession, error)

Source Files

View all Source files

Directories

Path Synopsis
Package live exposes the low-level Voice Agent realtime-protocol types.
 Package live exposes the low-level Voice Agent realtime-protocol types.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.