Skip to content

Latest commit

 

History

History
111 lines (63 loc) · 3.52 KB

addSystemMessage.md

File metadata and controls

111 lines (63 loc) · 3.52 KB

addSystemMessage

Add system message to message history

updatedMessages = addSystemMessage(messages,name,content)

Description

You can use system messages to add example conversations to the message history.

Use example conversations in system messages for few-shot prompting. Few-shot prompting is a form of prompt engineering. Provide examples of user input and expected model output to a large language model to prompt its future behavior.

updatedMessages = addSystemMessage(messages,name,content) adds a system message to the messageHistory object messages and specifies the name of the speaker and the content of the message.

Examples

Generate Text from Example Conversation

First, specify the OpenAI® API key as an environment variable and save it to a file called ".env". Next, load the environment file using the loadenv function.

loadenv(".env")

Connect to the OpenAI Chat Completion API. Use a system prompt to instruct the model.

model = openAIChat("You are a helpful assistants who judges whether two English words rhyme. You answer either yes or no.");

Initialize the message history.

messages = messageHistory;

Add example messages to the message history. When you pass this to the model, this example conversation further instructs the model on the output you want it to generate.

messages = addSystemMessage(messages,"example_user","House and mouse?");
messages = addSystemMessage(messages,"example_assistant","Yes");
messages = addSystemMessage(messages,"example_user","Thought and brought?");
messages = addSystemMessage(messages,"example_assistant","Yes");
messages = addSystemMessage(messages,"example_user","Tough and though?");
messages = addSystemMessage(messages,"example_assistant","No");

Add a user message to the message history. When you pass this to the model, the system messages act as an extension of the system prompt. The user message acts as the prompt.

messages = addUserMessage(messages,"Love and move?");

Generate a response from the message history.

generate(model,messages)
ans = "No"

Input Arguments

messages — Message history

messageHistory object

Message history, specified as a messageHistory object.

name — Name of the speaker

string scalar | character vector

Name of the speaker, specified as a string scalar or character vector. The name must be nonempty.

To use system messages with an OpenAI API, the name must only contain letters, numbers, underscores (_), and dashes (-).

Example: "example_assistant"

content — Message content

string scalar | character vector

Message content, specified as a string scalar or character vector. The content must be nonempty.

Output Argument

updatedMessages — Updated message history

messageHistory object

Updated message history, specified as a messageHistory object. The updated message history includes a new structure array with these fields:

  • role —"system"
  • name — Set by the name input argument
  • content — Set by the content input argument

See Also

generate | messageHistory | openAIChat | ollamaChat | azureChat | addUserMessage | addUserMessageWithImage | addToolMessage | addResponseMessage

Copyright 2024 The MathWorks, Inc.