mirror of
https://github.com/aaronpo97/the-biergarten-app.git
synced 2026-05-31 17:53:59 +00:00
65 lines
2.1 KiB
C++
65 lines
2.1 KiB
C++
#ifndef BIERGARTEN_PIPELINE_INCLUDES_DATA_GENERATION_LLAMA_GENERATOR_HELPERS_H_
|
|
#define BIERGARTEN_PIPELINE_INCLUDES_DATA_GENERATION_LLAMA_GENERATOR_HELPERS_H_
|
|
|
|
/**
|
|
* @file data_generation/llama_generator_helpers.h
|
|
* @brief Shared helper APIs used by LlamaGenerator translation units.
|
|
*/
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <optional>
|
|
#include <string>
|
|
#include <string_view>
|
|
|
|
struct llama_model;
|
|
struct llama_vocab;
|
|
using llama_token = int32_t;
|
|
|
|
/**
|
|
* @brief Normalizes and truncates regional context.
|
|
*
|
|
* @param region_context Input regional context text.
|
|
* @param max_chars Maximum output length.
|
|
* @return Processed region context.
|
|
*/
|
|
std::string PrepareRegionContext(std::string_view region_context,
|
|
size_t max_chars = 2000);
|
|
|
|
/**
|
|
* @brief Applies model chat template to system and user prompts.
|
|
*
|
|
* @param model Loaded llama model.
|
|
* @param system_prompt System prompt text.
|
|
* @param user_prompt User prompt text.
|
|
* @return Model-formatted prompt.
|
|
*/
|
|
std::string ToChatPrompt(const llama_model* model,
|
|
const std::string& system_prompt,
|
|
const std::string& user_prompt);
|
|
|
|
/**
|
|
* @brief Decodes a sampled token and appends it to output text.
|
|
*
|
|
* @param vocab Model vocabulary.
|
|
* @param token Sampled token id.
|
|
* @param output Output text buffer.
|
|
*/
|
|
void AppendTokenPiece(const llama_vocab* vocab, llama_token token,
|
|
std::string& output);
|
|
|
|
/**
|
|
* @brief Validates and parses brewery JSON output.
|
|
*
|
|
* @param raw Raw model output.
|
|
* @param name_out Parsed brewery name.
|
|
* @param description_out Parsed brewery description.
|
|
* @return Validation error message if invalid, or std::nullopt on success.
|
|
*/
|
|
std::optional<std::string> ValidateBreweryJson(const std::string& raw,
|
|
std::string& name_out,
|
|
std::string& description_out,
|
|
std::string& reasoning_out);
|
|
|
|
#endif // BIERGARTEN_PIPELINE_INCLUDES_DATA_GENERATION_LLAMA_GENERATOR_HELPERS_H_
|