Interface for language model providers (OpenAI, Anthropic, Google, Ollama) More...

#include <llm_interface.h>

Inheritance diagram for agents::LLMInterface:

Public Member Functions
virtual	~LLMInterface ()=default
	Destructor.

virtual std::vector< String >	getAvailableModels ()=0
	Get available models from this provider.

virtual void	setModel (const String &model)=0
	Set the model to use.

virtual String	getModel () const =0
	Get current model.

virtual void	setApiKey (const String &api_key)=0
	Set API key.

virtual void	setApiBase (const String &api_base)=0
	Set API base URL (for self-hosted or proxied endpoints)

virtual void	setOptions (const LLMOptions &options)=0
	Set options for API calls.

virtual LLMOptions	getOptions () const =0
	Get current options.

virtual LLMResponse	complete (const String &prompt)
	Generate completion from a prompt.

virtual LLMResponse	complete (const std::vector< Message > &messages)
	Generate completion from a list of messages.

virtual LLMResponse	completeWithTools (const std::vector< Message > &messages, const std::vector< JsonObject > &tools_schema)
	Generate completion with available tools.

virtual LLMResponse	chat (const std::vector< Message > &messages)=0
	Generate completion from a list of messages.

virtual LLMResponse	chatWithTools (const std::vector< Message > &messages, const std::vector< std::shared_ptr< Tool > > &tools)=0
	Generate completion with available tools.

virtual void	streamChat (const std::vector< Message > &messages, std::function< void(const String &, bool)> callback)=0
	Stream results with callback.

virtual Task< LLMResponse >	completeAsync (const String &prompt)
	Async complete from a prompt.

virtual Task< LLMResponse >	completeAsync (const std::vector< Message > &messages)
	Async complete from a list of messages.

virtual Task< LLMResponse >	chatAsync (const std::vector< Message > &messages)
	Async chat from a list of messages.

virtual Task< LLMResponse >	chatWithToolsAsync (const std::vector< Message > &messages, const std::vector< std::shared_ptr< Tool > > &tools)
	Async chat with tools.

virtual AsyncGenerator< String >	streamChatAsync (const std::vector< Message > &messages)
	Stream chat with AsyncGenerator.

Detailed Description

Interface for language model providers (OpenAI, Anthropic, Google, Ollama)

Examples: actor_agent_example.cpp.

Member Function Documentation

◆ chat()

virtual LLMResponse agents::LLMInterface::chat ( const std::vector< Message > & messages )

pure virtual

Generate completion from a list of messages.

Parameters

messages The messages to generate completion from

Returns: The LLM response

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ chatAsync()

virtual Task< LLMResponse > agents::LLMInterface::chatAsync ( const std::vector< Message > & messages )

virtual

Async chat from a list of messages.

Parameters

messages The messages to generate completion from

Returns: The LLM response

◆ chatWithTools()

virtual LLMResponse agents::LLMInterface::chatWithTools	(	const std::vector< Message > &	messages,
		const std::vector< std::shared_ptr< Tool > > &	tools )

pure virtual

Generate completion with available tools.

Parameters

messages	The messages to generate completion from
tools	The tools to use

Returns: The LLM response

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ chatWithToolsAsync()

virtual Task< LLMResponse > agents::LLMInterface::chatWithToolsAsync	(	const std::vector< Message > &	messages,
		const std::vector< std::shared_ptr< Tool > > &	tools )

virtual

Async chat with tools.

Parameters

messages	The messages to generate completion from
tools	The tools to use

Returns: The LLM response

◆ complete() [1/2]

virtual LLMResponse agents::LLMInterface::complete ( const std::vector< Message > & messages )

virtual

Generate completion from a list of messages.

Parameters

messages The messages to generate completion from

Returns: The LLM response

◆ complete() [2/2]

virtual LLMResponse agents::LLMInterface::complete ( const String & prompt )

virtual

Generate completion from a prompt.

Parameters

prompt The prompt to generate completion from

Returns: The LLM response

Reimplemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ completeAsync() [1/2]

virtual Task< LLMResponse > agents::LLMInterface::completeAsync ( const std::vector< Message > & messages )

virtual

Async complete from a list of messages.

Parameters

messages The messages to generate completion from

Returns: The LLM response

◆ completeAsync() [2/2]

virtual Task< LLMResponse > agents::LLMInterface::completeAsync ( const String & prompt )

virtual

Async complete from a prompt.

Parameters

prompt The prompt to generate completion from

Returns: The LLM response

◆ completeWithTools()

virtual LLMResponse agents::LLMInterface::completeWithTools	(	const std::vector< Message > &	messages,
		const std::vector< JsonObject > &	tools_schema )

virtual

Generate completion with available tools.

Parameters

messages	The messages to generate completion from
tools_schema	The tools schema to use

Returns: The LLM response

◆ getAvailableModels()

virtual std::vector< String > agents::LLMInterface::getAvailableModels ( )

pure virtual

Get available models from this provider.

Returns: The available models

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ getModel()

virtual String agents::LLMInterface::getModel ( ) const

pure virtual

Get current model.

Returns: The current model

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ getOptions()

virtual LLMOptions agents::LLMInterface::getOptions ( ) const

pure virtual

Get current options.

Returns: The current options

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ setApiBase()

virtual void agents::LLMInterface::setApiBase ( const String & api_base )

pure virtual

Set API base URL (for self-hosted or proxied endpoints)

Parameters

api_base The API base URL to use

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ setApiKey()

virtual void agents::LLMInterface::setApiKey ( const String & api_key )

pure virtual

Set API key.

Parameters

api_key The API key to use

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ setModel()

virtual void agents::LLMInterface::setModel ( const String & model )

pure virtual

Set the model to use.

Parameters

model The model to use

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ setOptions()

virtual void agents::LLMInterface::setOptions ( const LLMOptions & options )

pure virtual

Set options for API calls.

Parameters

options The options to use

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ streamChat()

virtual void agents::LLMInterface::streamChat	(	const std::vector< Message > &	messages,
		std::function< void(const String &, bool)>	callback )

pure virtual

Stream results with callback.

Parameters

messages	The messages to generate completion from
callback	The callback to use

Implemented in agents::llms::AnthropicLLM, agents::llms::GoogleLLM, agents::llms::OllamaLLM, and agents::llms::OpenAILLM.

◆ streamChatAsync()

virtual AsyncGenerator< String > agents::LLMInterface::streamChatAsync ( const std::vector< Message > & messages )

virtual

Stream chat with AsyncGenerator.

Parameters

messages The messages to generate completion from

Returns: The AsyncGenerator

Public Member Functions

Detailed Description

Member Function Documentation

◆ chat()

◆ chatAsync()

◆ chatWithTools()

◆ chatWithToolsAsync()

◆ complete() [1/2]

◆ complete() [2/2]

◆ completeAsync() [1/2]

◆ completeAsync() [2/2]

◆ completeWithTools()

◆ getAvailableModels()

◆ getModel()

◆ getOptions()

◆ setApiBase()

◆ setApiKey()

◆ setModel()

◆ setOptions()

◆ streamChat()

◆ streamChatAsync()