watsonx GenAI Engineer key terms
watsonx GenAI Engineer · Get comfortable with the vocabulary.
- Watson Machine Learning (WML) service
- Related: Deployment space, Online scoring endpoint, Prompt template
The managed IBM Cloud service that deploys, hosts, and monitors models and prompt templates. It provides inference endpoints, deployment spaces, and scoring APIs that watsonx.ai applications call at runtime.
- Deployment space
- Related: Watson Machine Learning (WML) service, Online scoring endpoint
A collaborative WML workspace that groups deployments, assets, and members with shared access. It isolates resources by project or team and controls who can deploy, score, or administer the assets inside it.
- Resource hub / project
- Related: Watson Machine Learning (WML) service, Model asset
The organizational containers in watsonx.ai. Projects hold assets for collaboration and experimentation, while the resource hub catalog shares promoted assets such as models, prompts, and notebooks across the account.
- watsonx.ai runtime
- Related: Deployment space, Online scoring endpoint
The execution environment that runs notebooks, training jobs, and deployment workloads with selectable software specifications and hardware sizes. It supplies the compute behind both experimentation and production inference.
- watsonx Orchestrate
- Related: Agentic workflow, Tool calling
The platform component for building AI assistants and automating multi-step business workflows. It connects skills, tools, and language models so an agent can call systems and complete tasks on a user's behalf.
- watsonx.governance
- Related: AI Factsheet, Model risk management, Model approval workflow
The platform component that tracks model and application risk throughout the lifecycle. It records factsheets, evaluations, and approvals, and produces audit evidence aligned to internal policy and external regulation.
- Foundation model
- Related: Prompt engineering, Fine-tuning, Model card
A large pretrained model, typically a transformer trained on broad unlabeled data, that can be adapted to many downstream tasks through prompting or tuning rather than task-specific training from scratch.
- Model catalog
- Related: Foundation model, Context window, Model card
The browsable inventory of foundation models available in watsonx.ai, with details such as provider, context window, supported languages, and task suitability. Candidates use it to select a model before prompting or tuning.
- Context window
- Related: Token, Prompt engineering, Chunking
The maximum number of tokens a model can process in a single request, counting both the prompt and the generated output. Exceeding it forces truncation, chunk reduction, or a model with a larger limit.
- Token
- Related: Context window, Tokenization
The unit of text a model reads and generates, roughly a word fragment rather than a whole word. Token counts drive context limits, latency, and cost estimates for inference requests.
- Tokenization
- Related: Token, Context window
The process of splitting raw text into tokens using a model-specific vocabulary. Mismatched tokenizers between training and inference, or unusual characters, can change token counts and model behavior.
- Prompt template
- Related: Prompt engineering, Few-shot prompting, Prompt injection
A reusable prompt with variables that are filled at runtime, such as instructions, retrieved context, and the user question. It standardizes inputs and supports versioning and evaluation.
- Prompt engineering
- Related: Prompt template, Few-shot prompting, Chain-of-thought prompting
The practice of designing instructions, examples, and output constraints so a foundation model produces accurate, consistent, and safe responses for a specific task without changing model weights.
- Few-shot prompting
- Related: Prompt engineering, Zero-shot prompting, Prompt template
A technique that supplies a small number of worked examples inside the prompt so the model infers the desired format and reasoning pattern. It improves consistency for classification and extraction tasks.
- Zero-shot prompting
- Related: Few-shot prompting, Prompt engineering
Asking a model to perform a task using only instructions and no worked examples. It is cheapest in tokens but less reliable for unusual formats or domain-specific labeling schemes.
- Chain-of-thought prompting
- Related: Prompt engineering, Few-shot prompting
A prompting pattern that asks the model to reason step by step before giving a final answer. It can improve multi-step accuracy but increases token use and may expose reasoning that should not be shown to end users.
- Decoding parameters (temperature, top-p, max tokens)
- Related: Token, Prompt engineering
Settings that control generation. Temperature and top-p adjust randomness and diversity, while max tokens caps output length. Lower temperature favors deterministic answers for extraction and classification tasks.
- Prompt injection
- Related: Guardrails, Prompt template, Retrieval-augmented generation (RAG)
An attack in which untrusted text, such as a retrieved document or user input, contains instructions that override the developer's prompt. Defenses include input isolation, instruction hierarchy, and output validation.
- Guardrails
- Related: Prompt injection, HAP (hate, abuse, profanity) detection, PII detection
Configurable controls that filter or transform model input and output, such as blocking harmful content, masking personal data, or enforcing topic limits. They reduce risk but can add latency and false positives.
- HAP (hate, abuse, profanity) detection
- Related: Guardrails, PII detection
A content-safety filter that scores text for hate, abuse, and profanity so requests or responses can be blocked or flagged. Thresholds are tuned to balance user safety against over-blocking legitimate content.
- PII detection
- Related: Guardrails, Data masking
The identification of personal data such as names, addresses, or account numbers in text. In generative pipelines it is used to mask inputs before sending them to a model and to sanitize outputs.
- Retrieval-augmented generation (RAG)
- Related: Embedding, Vector database, Chunking
An architecture that retrieves relevant passages from an external knowledge source and inserts them into the prompt so the model answers from current, private evidence instead of relying only on pretrained knowledge.
- Embedding
- Related: Vector database, Cosine similarity, Semantic search
A dense numeric vector that represents the meaning of text, produced by an embedding model. Similar meanings map to nearby vectors, enabling semantic search and clustering.
- Vector database
- Related: Embedding, Approximate nearest neighbor (ANN) search, Metadata filtering
A store optimized for indexing and similarity search over embeddings at scale. It returns the nearest passages for a query vector and often stores metadata used for filtering.
- Cosine similarity
- Related: Embedding, Semantic search
A similarity measure equal to the cosine of the angle between two vectors, ranging from -1 to 1. It ignores magnitude, which suits normalized text embeddings used in semantic retrieval.
- Semantic search
- Related: Embedding, Hybrid search, Cosine similarity
Retrieval ranked by meaning similarity between query and document embeddings rather than exact keyword matches. It handles paraphrases well but can miss precise identifiers that lexical search catches.
- Hybrid search
- Related: Semantic search, Approximate nearest neighbor (ANN) search, Reciprocal rank fusion (RRF)
A retrieval strategy that combines dense semantic similarity with sparse keyword scoring such as BM25, then fuses the ranked results. It improves recall for both conceptual questions and exact terms.
- Approximate nearest neighbor (ANN) search
- Related: Vector database, Hybrid search
An index-based method that finds close vectors quickly by trading a small amount of recall for large speed gains. HNSW is a common graph-based ANN algorithm used in vector stores.
- Chunking
- Related: Embedding, Context window, Metadata filtering
Splitting source documents into passages small enough to embed and fit in the prompt. Chunk size and overlap strongly affect retrieval precision and the coherence of the retrieved context.
- Metadata filtering
- Related: Vector database, Chunking
Restricting vector search to records matching attributes such as date, department, or access level. It improves relevance and enforces permissions so users retrieve only documents they may see.
- Reranking
- Related: Retrieval-augmented generation (RAG), Hybrid search
A second retrieval stage that scores candidate passages with a more precise cross-encoder or model-based judge and reorders them before prompting. It raises answer quality at extra latency and cost.
- Fine-tuning
- Related: Instruction tuning, LoRA (low-rank adaptation), Training data preparation
Further training of a pretrained model on task-specific labeled examples so its weights adapt to a domain, style, or output format. It changes the model itself rather than only its prompt.
- Instruction tuning
- Related: Fine-tuning, RLHF (reinforcement learning from human feedback)
Supervised fine-tuning on prompt-response pairs that teach a model to follow instructions and desired formats. It is often a precursor to preference optimization for helpfulness and safety.
- LoRA (low-rank adaptation)
- Related: Fine-tuning, Hyperparameter
A parameter-efficient tuning method that freezes base weights and trains small low-rank matrices, greatly reducing memory and cost. Adapters can be swapped without duplicating the full model.
- RLHF (reinforcement learning from human feedback)
- Related: Instruction tuning, Model evaluation
A post-training approach that trains a reward model from human preference comparisons and optimizes the language model against it. It shapes tone and helpfulness but requires careful data and evaluation.
- Training data preparation
- Related: Fine-tuning, Hyperparameter, Data lineage
Curating, cleaning, deduplicating, and formatting examples for tuning, including train-validation splits and prompt-response structure. Poor data quality, leakage, or imbalance undermines tuning gains regardless of hyperparameters.
- Hyperparameter
- Related: Fine-tuning, Model evaluation
A training setting chosen before training, such as learning rate, batch size, or number of epochs. These control convergence and overfitting and are tuned on validation data rather than learned from it.
- Model evaluation
- Related: Groundedness, AI Factsheet, Model risk management
Systematic measurement of model quality using task metrics, held-out data, and human review. In generative settings it covers accuracy, groundedness, safety, and latency rather than a single score.
- Groundedness
- Related: Retrieval-augmented generation (RAG), Hallucination, Model evaluation
The degree to which a generated answer is supported by the provided source context rather than invented. It is a core RAG quality metric and a frequent target of automated evaluation.
- Hallucination
- Related: Groundedness, Retrieval-augmented generation (RAG), Guardrails
A confident model output that is factually wrong or unsupported by evidence. Mitigations include retrieval grounding, citation requirements, lower temperature, and validation of structured outputs.
- AI Factsheet
- Related: Model card, Model approval workflow, Model risk management
A structured record in watsonx.governance describing a model's purpose, training data, evaluations, and limitations. It supports review, transparency, and audit reporting across the model lifecycle.
- Model card
- Related: AI Factsheet, Foundation model
Documentation summarizing a model's intended use, training approach, performance, and known limitations. It informs selection and risk assessment and feeds governance records.
- Model risk management
- Related: AI Factsheet, Model approval workflow, Model evaluation
The discipline of identifying, measuring, mitigating, and monitoring risks from models, including bias, drift, and misuse. It assigns ownership, sets controls, and requires periodic review.
- Model approval workflow
- Related: AI Factsheet, Model risk management
A governed sequence of reviews and sign-offs that a model or use case must pass before production. It records approvers, evidence, and conditions, and can block deployment until requirements are met.
- Data lineage
- Related: Training data preparation, AI Factsheet
The documented path of data from source through transformation to model input. It supports reproducibility, audit, and impact analysis when upstream data changes or is disputed.
- Data masking
- Related: PII detection, Data lineage
Replacing sensitive values with realistic substitutes or redaction so development and testing can use data without exposing personal information. It reduces privacy risk in generative pipelines.
- Agentic workflow
- Related: Tool calling, watsonx Orchestrate, LangChain
An orchestration pattern where a language model plans steps, calls tools, observes results, and iterates toward a goal. It requires guardrails, retries, and human checkpoints for high-impact actions.
- Tool calling
- Related: Agentic workflow, watsonx Orchestrate
A model capability to emit structured requests for external functions, such as database lookups or ticketing actions, whose results are fed back into the conversation. It connects language reasoning to real systems.
- LangChain
- Related: Agentic workflow, Retrieval-augmented generation (RAG)
An open-source framework for composing prompts, models, retrievers, and tools into chains and agents. It is commonly used with watsonx.ai models to build RAG and agent applications.
- Online scoring endpoint
- Related: Deployment space, Watson Machine Learning (WML) service, Model drift
A deployed HTTP interface that returns model predictions or generations for live requests. It is configured with a serving environment, scaling policy, and authentication, and is monitored for latency and errors.
- Model drift
- Related: Online scoring endpoint, Model evaluation
Degradation in model performance as real-world data diverges from training or evaluation conditions. Monitoring detects it through input distributions, quality metrics, and feedback so models can be retrained or retired.
- Model asset
- Related: Resource hub / project, Deployment space
A stored, versioned artifact in watsonx.ai representing a trained model or prompt configuration that can be evaluated, promoted, and deployed. It carries metadata used by governance and deployment.