Class FewShotPromptTemplate

Prompt template that contains few-shot examples.

Example

const examplePrompt = PromptTemplate.fromTemplate(
  "Input: {input}\nOutput: {output}",
);

const exampleSelector = await SemanticSimilarityExampleSelector.fromExamples(
  [
    { input: "happy", output: "sad" },
    { input: "tall", output: "short" },
    { input: "energetic", output: "lethargic" },
    { input: "sunny", output: "gloomy" },
    { input: "windy", output: "calm" },
  ],
  new OpenAIEmbeddings(),
  HNSWLib,
  { k: 1 },
);

const dynamicPrompt = new FewShotPromptTemplate({
  exampleSelector,
  examplePrompt,
  prefix: "Give the antonym of every input",
  suffix: "Input: {adjective}\nOutput:",
  inputVariables: ["adjective"],
});

// Format the dynamic prompt with the input 'rainy'
console.log(await dynamicPrompt.format({ adjective: "rainy" }));

Hierarchy

BaseStringPromptTemplate
- FewShotPromptTemplate

Implements

FewShotPromptTemplateInput

Constructors

constructor

new FewShotPromptTemplate(input): FewShotPromptTemplate
Parameters
- input: FewShotPromptTemplateInput
Returns FewShotPromptTemplate
Overrides BaseStringPromptTemplate.constructor
- Defined in docs/api_refs/langchain/src/prompts/few_shot.ts:130

Properties

PromptValueReturnType

PromptValueReturnType: StringPromptValue

examplePrompt

examplePrompt: PromptTemplate<any, any>

An PromptTemplate used to format a single example.

exampleSeparator

exampleSeparator: string = "\n\n"

String separator used to join the prefix, the examples, and suffix.

inputVariables

inputVariables: string[]

A list of variable names the prompt template expects

partialVariables

partialVariables: PartialValues<any>

Partial variables

prefix

prefix: string = ""

A prompt template string to put before the examples.

Default Value

""

suffix

suffix: string = ""

A prompt template string to put after the examples.

templateFormat

templateFormat: "f-string" = "f-string"

The format of the prompt template. Options are: 'f-string'

validateTemplate

validateTemplate: boolean = true

Whether or not to try validating the template on initialization.

`Optional` exampleSelector

exampleSelector?: BaseExampleSelector

An BaseExampleSelector Examples to format into the prompt. Exactly one of this or examples must be provided.

`Optional` examples

examples?: InputValues[]

Examples to format into the prompt. Exactly one of this or exampleSelector must be provided.

`Optional` outputParser

outputParser?: BaseOutputParser<unknown>

How to parse the output of calling an LLM on this formatted prompt

Methods

batch

batch(inputs, options?, batchOptions?): Promise<StringPromptValue[]>
Default implementation of batch, which calls invoke N times. Subclasses should override this method if they can batch more efficiently.
Parameters
- inputs: any[]
  
  Array of inputs to each batch call.
- Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]
  
  Either a single call options object to apply to each batch call or an array for each call.
- Optional batchOptions: RunnableBatchOptions & {
  returnExceptions?: false;
  }
Returns Promise<StringPromptValue[]>
An array of RunOutputs, or mixed RunOutputs and errors if batchOptions.returnExceptions is set
Inherited from BaseStringPromptTemplate.batch
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:159
batch(inputs, options?, batchOptions?): Promise<(Error | StringPromptValue)[]>
Parameters
- inputs: any[]
- Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]
- Optional batchOptions: RunnableBatchOptions & {
  returnExceptions: true;
  }
Returns Promise<(Error | StringPromptValue)[]>
Inherited from BaseStringPromptTemplate.batch
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:165
batch(inputs, options?, batchOptions?): Promise<(Error | StringPromptValue)[]>
Parameters
- inputs: any[]
- Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]
- Optional batchOptions: RunnableBatchOptions
Returns Promise<(Error | StringPromptValue)[]>
Inherited from BaseStringPromptTemplate.batch
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:171

bind

bind(kwargs): Runnable<any, StringPromptValue, BaseCallbackConfig>
Bind arguments to a Runnable, returning a new Runnable.
Parameters
- kwargs: Partial<BaseCallbackConfig>
Returns Runnable<any, StringPromptValue, BaseCallbackConfig>
A new RunnableBinding that, when invoked, will apply the bound args.
Inherited from BaseStringPromptTemplate.bind
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:67

format

format(values): Promise<string>
Formats the prompt with the given values.
Parameters
- values: InputValues
  
  The values to format the prompt with.
Returns Promise<string>
A promise that resolves to a string representing the formatted prompt.
Overrides BaseStringPromptTemplate.format
- Defined in docs/api_refs/langchain/src/prompts/few_shot.ts:209

formatPromptValue

formatPromptValue(values): Promise<StringPromptValue>
Formats the prompt given the input values and returns a formatted prompt value.
Parameters
- values: TypedPromptInputValues<any>
  
  The input values to format the prompt.
Returns Promise<StringPromptValue>
A Promise that resolves to a formatted prompt value.
Inherited from BaseStringPromptTemplate.formatPromptValue
- Defined in docs/api_refs/langchain/src/prompts/base.ts:253

invoke

invoke(input, options?): Promise<StringPromptValue>
Invokes the prompt template with the given input and options.
Parameters
- input: any
  
  The input to invoke the prompt template with.
- Optional options: BaseCallbackConfig
  
  Optional configuration for the callback.
Returns Promise<StringPromptValue>
A Promise that resolves to the output of the prompt template.
Inherited from BaseStringPromptTemplate.invoke
- Defined in docs/api_refs/langchain/src/prompts/base.ts:154

map

map(): Runnable<any[], StringPromptValue[], BaseCallbackConfig>
Return a new Runnable that maps a list of inputs to a list of outputs, by calling invoke() with each input.

Returns Runnable<any[], StringPromptValue[], BaseCallbackConfig>
Inherited from BaseStringPromptTemplate.map
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:78

mergePartialAndUserVariables

mergePartialAndUserVariables(userVariables): Promise<InputValues<any>>
Merges partial variables and user variables.
Parameters
- userVariables: TypedPromptInputValues<any>
  
  The user variables to merge with the partial variables.
Returns Promise<InputValues<any>>
A Promise that resolves to an object containing the merged variables.
Inherited from BaseStringPromptTemplate.mergePartialAndUserVariables
- Defined in docs/api_refs/langchain/src/prompts/base.ts:125

partial

partial<NewPartialVariableName>(values): Promise<FewShotPromptTemplate>
Type Parameters
- NewPartialVariableName extends string
Parameters
- values: PartialValues<NewPartialVariableName>
Returns Promise<FewShotPromptTemplate>
Overrides BaseStringPromptTemplate.partial
- Defined in docs/api_refs/langchain/src/prompts/few_shot.ts:186

pipe

pipe<NewRunOutput>(coerceable): RunnableSequence<any, Exclude<NewRunOutput, Error>>
Create a new runnable sequence that runs each individual runnable in series, piping the output of one runnable into another runnable or runnable-like.
Type Parameters
- NewRunOutput
Parameters
- coerceable: RunnableLike<StringPromptValue, NewRunOutput>
  
  A runnable, function, or object whose values are functions or runnables.
Returns RunnableSequence<any, Exclude<NewRunOutput, Error>>
A new runnable sequence.
Inherited from BaseStringPromptTemplate.pipe
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:461

serialize

serialize(): SerializedFewShotTemplate
Return a json-like object representing this prompt template.

Returns SerializedFewShotTemplate

Deprecated
Overrides BaseStringPromptTemplate.serialize
- Defined in docs/api_refs/langchain/src/prompts/few_shot.ts:222

stream

stream(input, options?): Promise<IterableReadableStream<StringPromptValue>>
Stream output in chunks.
Parameters
- input: any
- Optional options: Partial<BaseCallbackConfig>
Returns Promise<IterableReadableStream<StringPromptValue>>
A readable stream that is also an iterable.
Inherited from BaseStringPromptTemplate.stream
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:225

streamLog

streamLog(input, options?, streamOptions?): AsyncGenerator<RunLogPatch, any, unknown>
Stream all output from a runnable, as reported to the callback system. This includes all inner runs of LLMs, Retrievers, Tools, etc. Output is streamed as Log objects, which include a list of jsonpatch ops that describe how the state of the run has changed in each step, and the final state of the run. The jsonpatch ops can be applied in order to construct state.
Parameters
- input: any
- Optional options: Partial<BaseCallbackConfig>
- Optional streamOptions: Omit<LogStreamCallbackHandlerInput, "autoClose">
Returns AsyncGenerator<RunLogPatch, any, unknown>
Inherited from BaseStringPromptTemplate.streamLog
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:507

toJSON

toJSON(): Serialized
Returns Serialized
Inherited from BaseStringPromptTemplate.toJSON
- Defined in docs/api_refs/langchain/src/load/serializable.ts:148

toJSONNotImplemented

toJSONNotImplemented(): SerializedNotImplemented
Returns SerializedNotImplemented
Inherited from BaseStringPromptTemplate.toJSONNotImplemented
- Defined in docs/api_refs/langchain/src/load/serializable.ts:222

transform

transform(generator, options): AsyncGenerator<StringPromptValue, any, unknown>
Default implementation of transform, which buffers input and then calls stream. Subclasses should override this method if they can start producing output while input is still being generated.
Parameters
- generator: AsyncGenerator<any, any, unknown>
- options: Partial<BaseCallbackConfig>
Returns AsyncGenerator<StringPromptValue, any, unknown>
Inherited from BaseStringPromptTemplate.transform
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:478

withConfig

withConfig(config): RunnableBinding<any, StringPromptValue, BaseCallbackConfig>
Bind config to a Runnable, returning a new Runnable.
Parameters
- config: BaseCallbackConfig
  
  New configuration parameters to attach to the new runnable.
Returns RunnableBinding<any, StringPromptValue, BaseCallbackConfig>
A new RunnableBinding with a config matching what's passed.
Inherited from BaseStringPromptTemplate.withConfig
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:107

withFallbacks

withFallbacks(fields): RunnableWithFallbacks<any, StringPromptValue>
Create a new runnable from the current one that will try invoking other passed fallback runnables if the initial invocation fails.
Parameters
- fields: {
  fallbacks: Runnable<any, StringPromptValue, BaseCallbackConfig>[];
  }
  - fallbacks: Runnable<any, StringPromptValue, BaseCallbackConfig>[]
    
    Other runnables to call if the runnable errors.
Returns RunnableWithFallbacks<any, StringPromptValue>
A new RunnableWithFallbacks.
Inherited from BaseStringPromptTemplate.withFallbacks
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:124

withRetry

withRetry(fields?): RunnableRetry<any, StringPromptValue, BaseCallbackConfig>
Add retry logic to an existing runnable.
Parameters
- Optional fields: {
  onFailedAttempt?: RunnableRetryFailedAttemptHandler;
  stopAfterAttempt?: number;
  }
  - Optional onFailedAttempt?: RunnableRetryFailedAttemptHandler
  - Optional stopAfterAttempt?: number
Returns RunnableRetry<any, StringPromptValue, BaseCallbackConfig>
A new RunnableRetry that, when invoked, will retry according to the parameters.
Inherited from BaseStringPromptTemplate.withRetry
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:88

`Static` deserialize

deserialize(data): Promise<FewShotPromptTemplate>
Parameters
- data: SerializedFewShotTemplate
Returns Promise<FewShotPromptTemplate>

Deprecated
Load a prompt template from a json-like object describing it.

Remarks
Deserializing needs to be async because templates (e.g. FewShotPromptTemplate) can reference remote resources that we read asynchronously with a web request.
Overrides BaseStringPromptTemplate.deserialize
- Defined in docs/api_refs/langchain/src/prompts/few_shot.ts:245

`Static` isRunnable

isRunnable(thing): thing is Runnable<any, any, BaseCallbackConfig>
Parameters
- thing: any
Returns thing is Runnable<any, any, BaseCallbackConfig>
Inherited from BaseStringPromptTemplate.isRunnable
- Defined in docs/api_refs/langchain/src/schema/runnable/base.ts:557

Class FewShotPromptTemplate

Example

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

input: FewShotPromptTemplateInput

Returns FewShotPromptTemplate

Properties

PromptValueReturnType

examplePrompt

exampleSeparator

inputVariables

partialVariables

prefix

Default Value

suffix

templateFormat

validateTemplate

Optional exampleSelector

Optional examples

Optional outputParser

Methods

batch

Parameters

inputs: any[]

Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

Optional batchOptions: RunnableBatchOptions & { returnExceptions?: false; }

Returns Promise<StringPromptValue[]>

Parameters

inputs: any[]

Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

Optional batchOptions: RunnableBatchOptions & { returnExceptions: true; }

Returns Promise<(Error | StringPromptValue)[]>

Parameters

inputs: any[]

Optional options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

Optional batchOptions: RunnableBatchOptions

Returns Promise<(Error | StringPromptValue)[]>

bind

Parameters

kwargs: Partial<BaseCallbackConfig>

Returns Runnable<any, StringPromptValue, BaseCallbackConfig>

format

Parameters

values: InputValues

Returns Promise<string>

formatPromptValue

Parameters

values: TypedPromptInputValues<any>

Returns Promise<StringPromptValue>

invoke

Parameters

input: any

Optional options: BaseCallbackConfig

Returns Promise<StringPromptValue>

map

Returns Runnable<any[], StringPromptValue[], BaseCallbackConfig>

mergePartialAndUserVariables

Parameters

userVariables: TypedPromptInputValues<any>

Returns Promise<InputValues<any>>

partial

Type Parameters

NewPartialVariableName extends string

Parameters

values: PartialValues<NewPartialVariableName>

Returns Promise<FewShotPromptTemplate>

pipe

Type Parameters

NewRunOutput

Parameters

coerceable: RunnableLike<StringPromptValue, NewRunOutput>

Returns RunnableSequence<any, Exclude<NewRunOutput, Error>>

serialize

`Optional` exampleSelector

`Optional` examples

`Optional` outputParser

`Optional` options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

`Optional` batchOptions: RunnableBatchOptions & {
returnExceptions?: false;
}

`Optional` options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

`Optional` batchOptions: RunnableBatchOptions & {
returnExceptions: true;
}

`Optional` options: Partial<BaseCallbackConfig> | Partial<BaseCallbackConfig>[]

`Optional` batchOptions: RunnableBatchOptions

`Optional` options: BaseCallbackConfig

`Optional` options: Partial<BaseCallbackConfig>

`Optional` options: Partial<BaseCallbackConfig>

`Optional` streamOptions: Omit<LogStreamCallbackHandlerInput, "autoClose">

fields: {
fallbacks: Runnable<any, StringPromptValue, BaseCallbackConfig>[];
}

`Optional` fields: {
onFailedAttempt?: RunnableRetryFailedAttemptHandler;
stopAfterAttempt?: number;
}

`Optional` onFailedAttempt?: RunnableRetryFailedAttemptHandler

`Optional` stopAfterAttempt?: number

`Static` deserialize

`Static` isRunnable