#include <prompt_builder.h>

Collaboration diagram for yaze::cli::PromptBuilder:

[legend]

Public Member Functions
	PromptBuilder ()

void	SetRom (Rom *rom)

absl::Status	LoadResourceCatalogue (const std::string &yaml_path)

std::string	BuildSystemInstruction ()

std::string	BuildSystemInstructionWithExamples ()

std::string	BuildContextualPrompt (const std::string &user_prompt, const RomContext &context)

std::string	BuildPromptFromHistory (const std::vector< agent::ChatMessage > &history)

void	AddFewShotExample (const FewShotExample &example)

std::vector< FewShotExample >	GetExamplesForCategory (const std::string &category)

std::string	LookupTileId (const std::string &alias) const

const std::map< std::string, std::string > &	tile_reference () const

std::string	BuildFunctionCallSchemas () const

void	SetVerbosity (int level)

Private Member Functions
std::string	BuildCommandReference () const

std::string	BuildFewShotExamplesSection () const

std::string	BuildToolReference () const

std::string	BuildContextSection (const RomContext &context)

std::string	BuildConstraintsSection () const

std::string	BuildTileReferenceSection () const

absl::StatusOr< std::string >	ResolveCataloguePath (const std::string &yaml_path) const

void	ClearCatalogData ()

absl::Status	ParseCommands (const nlohmann::json &commands)

absl::Status	ParseTools (const nlohmann::json &tools)

absl::Status	ParseExamples (const nlohmann::json &examples)

void	ParseTileReference (const nlohmann::json &tile_reference)

Private Attributes
Rom *	rom_ = nullptr

std::unique_ptr< ResourceContextBuilder >	resource_context_builder_

std::map< std::string, std::string >	command_docs_

std::vector< FewShotExample >	examples_

std::vector< ToolSpecification >	tool_specs_

std::map< std::string, std::string >	tile_reference_

int	verbosity_ = 1

bool	catalogue_loaded_ = false

Detailed Description

Definition at line 64 of file prompt_builder.h.

Constructor & Destructor Documentation

◆ PromptBuilder()

yaze::cli::PromptBuilder::PromptBuilder ( )

default

Member Function Documentation

◆ SetRom()

void yaze::cli::PromptBuilder::SetRom ( Rom * rom )

inline

Definition at line 68 of file prompt_builder.h.

References rom_.

Referenced by yaze::cli::GeminiAIService::SetRomContext(), and yaze::cli::OllamaAIService::SetRomContext().

◆ LoadResourceCatalogue()

absl::Status yaze::cli::PromptBuilder::LoadResourceCatalogue ( const std::string & yaml_path )

Definition at line 111 of file prompt_builder.cc.

References catalogue_loaded_, ClearCatalogData(), ParseCommands(), ParseExamples(), ParseTileReference(), ParseTools(), and ResolveCataloguePath().

Referenced by yaze::cli::GeminiAIService::GeminiAIService(), and yaze::cli::OllamaAIService::OllamaAIService().

◆ BuildSystemInstruction()

std::string yaze::cli::PromptBuilder::BuildSystemInstruction ( )

Definition at line 625 of file prompt_builder.cc.

Referenced by yaze::cli::GeminiAIService::BuildSystemInstruction(), and yaze::cli::OllamaAIService::BuildSystemPrompt().

◆ BuildSystemInstructionWithExamples()

std::string yaze::cli::PromptBuilder::BuildSystemInstructionWithExamples ( )

Definition at line 680 of file prompt_builder.cc.

Referenced by yaze::cli::GeminiAIService::GeminiAIService(), and yaze::cli::OllamaAIService::OllamaAIService().

◆ BuildContextualPrompt()

std::string yaze::cli::PromptBuilder::BuildContextualPrompt	(	const std::string &	user_prompt,
		const RomContext &	context
	)

Definition at line 690 of file prompt_builder.cc.

◆ BuildPromptFromHistory()

std::string yaze::cli::PromptBuilder::BuildPromptFromHistory ( const std::vector< agent::ChatMessage > & history )

Definition at line 706 of file prompt_builder.cc.

References BuildCommandReference(), BuildToolReference(), catalogue_loaded_, command_docs_, and tool_specs_.

Referenced by yaze::cli::GeminiAIService::GenerateResponse(), and yaze::cli::OllamaAIService::GenerateResponse().

Here is the call graph for this function:

◆ AddFewShotExample()

void yaze::cli::PromptBuilder::AddFewShotExample ( const FewShotExample & example )

Definition at line 724 of file prompt_builder.cc.

◆ GetExamplesForCategory()

std::vector< FewShotExample > yaze::cli::PromptBuilder::GetExamplesForCategory ( const std::string & category )

Definition at line 728 of file prompt_builder.cc.

References BuildCommandReference(), BuildToolReference(), command_docs_, and tool_specs_.

Here is the call graph for this function:

◆ LookupTileId()

std::string yaze::cli::PromptBuilder::LookupTileId ( const std::string & alias ) const

Definition at line 364 of file prompt_builder.cc.

References tile_reference_.

◆ tile_reference()

const std::map< std::string, std::string > & yaze::cli::PromptBuilder::tile_reference ( ) const

inline

Definition at line 95 of file prompt_builder.h.

References tile_reference_.

Referenced by ParseTileReference().

◆ BuildFunctionCallSchemas()

std::string yaze::cli::PromptBuilder::BuildFunctionCallSchemas ( ) const

Definition at line 419 of file prompt_builder.cc.

References tool_specs_.

Referenced by BuildConstraintsSection(), BuildContextSection(), and yaze::cli::GeminiAIService::BuildFunctionCallSchemas().

◆ SetVerbosity()

void yaze::cli::PromptBuilder::SetVerbosity ( int level )

inline

Definition at line 103 of file prompt_builder.h.

References verbosity_.

◆ BuildCommandReference()

std::string yaze::cli::PromptBuilder::BuildCommandReference ( ) const

private

Definition at line 372 of file prompt_builder.cc.

References command_docs_.

Referenced by BuildPromptFromHistory(), and GetExamplesForCategory().

◆ BuildFewShotExamplesSection()

std::string yaze::cli::PromptBuilder::BuildFewShotExamplesSection ( ) const

private

Definition at line 470 of file prompt_builder.cc.

References examples_.

◆ BuildToolReference()

std::string yaze::cli::PromptBuilder::BuildToolReference ( ) const

private

Definition at line 385 of file prompt_builder.cc.

References tool_specs_.

Referenced by BuildPromptFromHistory(), and GetExamplesForCategory().

◆ BuildContextSection()

std::string yaze::cli::PromptBuilder::BuildContextSection ( const RomContext & context )

private

Definition at line 588 of file prompt_builder.cc.

References BuildFunctionCallSchemas().

Here is the call graph for this function:

◆ BuildConstraintsSection()

std::string yaze::cli::PromptBuilder::BuildConstraintsSection ( ) const

private

Definition at line 511 of file prompt_builder.cc.

References BuildFunctionCallSchemas(), BuildTileReferenceSection(), yaze::util::PlatformPaths::FindAsset(), tile_reference_, and tool_specs_.

Here is the call graph for this function:

◆ BuildTileReferenceSection()

std::string yaze::cli::PromptBuilder::BuildTileReferenceSection ( ) const

private

Definition at line 576 of file prompt_builder.cc.

Referenced by BuildConstraintsSection().

◆ ResolveCataloguePath()

absl::StatusOr< std::string > yaze::cli::PromptBuilder::ResolveCataloguePath ( const std::string & yaml_path ) const

private

Definition at line 78 of file prompt_builder.cc.

References yaze::util::PlatformPaths::FindAsset().

Referenced by LoadResourceCatalogue().

Here is the call graph for this function:

◆ ClearCatalogData()

void yaze::cli::PromptBuilder::ClearCatalogData ( )

private

Definition at line 70 of file prompt_builder.cc.

References catalogue_loaded_, command_docs_, examples_, tile_reference_, and tool_specs_.

Referenced by LoadResourceCatalogue().

◆ ParseCommands()

absl::Status yaze::cli::PromptBuilder::ParseCommands ( const nlohmann::json & commands )

private

Definition at line 172 of file prompt_builder.cc.

References command_docs_.

Referenced by LoadResourceCatalogue().

◆ ParseTools()

absl::Status yaze::cli::PromptBuilder::ParseTools ( const nlohmann::json & tools )

private

Definition at line 189 of file prompt_builder.cc.

References yaze::cli::ToolSpecification::arguments, yaze::cli::ToolArgument::description, yaze::cli::ToolSpecification::description, yaze::cli::ToolArgument::example, yaze::cli::ToolArgument::name, yaze::cli::ToolSpecification::name, yaze::cli::ToolArgument::required, tool_specs_, and yaze::cli::ToolSpecification::usage_notes.

Referenced by LoadResourceCatalogue().

◆ ParseExamples()

absl::Status yaze::cli::PromptBuilder::ParseExamples ( const nlohmann::json & examples )

private

Definition at line 259 of file prompt_builder.cc.

References yaze::cli::ToolCall::args, examples_, yaze::cli::FewShotExample::expected_commands, yaze::cli::FewShotExample::explanation, yaze::cli::FewShotExample::text_response, yaze::cli::FewShotExample::tool_calls, yaze::cli::ToolCall::tool_name, and yaze::cli::FewShotExample::user_prompt.

Referenced by LoadResourceCatalogue().

◆ ParseTileReference()

void yaze::cli::PromptBuilder::ParseTileReference ( const nlohmann::json & tile_reference )

private

Definition at line 352 of file prompt_builder.cc.

References tile_reference(), and tile_reference_.

Referenced by LoadResourceCatalogue().

Here is the call graph for this function:

Member Data Documentation

◆ rom_

Rom* yaze::cli::PromptBuilder::rom_ = nullptr

private

Definition at line 119 of file prompt_builder.h.

Referenced by SetRom().

◆ resource_context_builder_

std::unique_ptr<ResourceContextBuilder> yaze::cli::PromptBuilder::resource_context_builder_

private

Definition at line 120 of file prompt_builder.h.

◆ command_docs_

std::map<std::string, std::string> yaze::cli::PromptBuilder::command_docs_

private

Definition at line 121 of file prompt_builder.h.

Referenced by BuildCommandReference(), BuildPromptFromHistory(), ClearCatalogData(), GetExamplesForCategory(), and ParseCommands().

◆ examples_

std::vector<FewShotExample> yaze::cli::PromptBuilder::examples_

private

Definition at line 122 of file prompt_builder.h.

Referenced by BuildFewShotExamplesSection(), ClearCatalogData(), and ParseExamples().

◆ tool_specs_

std::vector<ToolSpecification> yaze::cli::PromptBuilder::tool_specs_

private

Definition at line 123 of file prompt_builder.h.

Referenced by BuildConstraintsSection(), BuildFunctionCallSchemas(), BuildPromptFromHistory(), BuildToolReference(), ClearCatalogData(), GetExamplesForCategory(), and ParseTools().

◆ tile_reference_

std::map<std::string, std::string> yaze::cli::PromptBuilder::tile_reference_

private

Definition at line 124 of file prompt_builder.h.

Referenced by BuildConstraintsSection(), ClearCatalogData(), LookupTileId(), ParseTileReference(), and tile_reference().

◆ verbosity_

int yaze::cli::PromptBuilder::verbosity_ = 1

private

Definition at line 125 of file prompt_builder.h.

Referenced by SetVerbosity().

◆ catalogue_loaded_

bool yaze::cli::PromptBuilder::catalogue_loaded_ = false

private

Definition at line 126 of file prompt_builder.h.

Referenced by BuildPromptFromHistory(), ClearCatalogData(), and LoadResourceCatalogue().

The documentation for this class was generated from the following files:

src/cli/service/ai/prompt_builder.h
src/cli/service/ai/prompt_builder.cc

	yaze 0.3.2 Link to the Past ROM Editor

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PromptBuilder()

Member Function Documentation

◆ SetRom()

◆ LoadResourceCatalogue()

◆ BuildSystemInstruction()

◆ BuildSystemInstructionWithExamples()

◆ BuildContextualPrompt()

◆ BuildPromptFromHistory()

◆ AddFewShotExample()

◆ GetExamplesForCategory()

◆ LookupTileId()

◆ tile_reference()

◆ BuildFunctionCallSchemas()

◆ SetVerbosity()

◆ BuildCommandReference()

◆ BuildFewShotExamplesSection()

◆ BuildToolReference()

◆ BuildContextSection()

◆ BuildConstraintsSection()

◆ BuildTileReferenceSection()

◆ ResolveCataloguePath()

◆ ClearCatalogData()

◆ ParseCommands()

◆ ParseTools()

◆ ParseExamples()

◆ ParseTileReference()

Member Data Documentation

◆ rom_

◆ resource_context_builder_

◆ command_docs_

◆ examples_

◆ tool_specs_

◆ tile_reference_

◆ verbosity_

◆ catalogue_loaded_