Instructions

struct · iOS 26.0+ · SDK 27.1

struct Instructions

Details you provide that define the model's intended behavior on prompts. You typically provide instructions to define the role and behavior of the model. In the code below, the instructions specify that the model replies with topics rather than, for example, a recipe: ```swift let instructions = """ Suggest related topics. Keep them concise (three to seven words) and make sure they \ build naturally from the person's topic. """ let session = LanguageModelSession(instructions: instructions) let prompt = "Making homemade bread" let response = try await session.respond(to: prompt) ``` Don't include untrusted content in instructions: the model is typically trained to obey instructions over any commands it receives in prompts. For more on how instructions impact generation quality and safety, see <doc:improving-the-safety-of-generative-model-output>. All input to the model contributes tokens to the context window of the ``LanguageModelSession`` --- including the ``Instructions``, ``Prompt``, ``Tool``, and ``Generable`` types, and the model's responses. If your session exceeds the available context size, it throws ``LanguageModelError/contextSizeExceeded(_:)``. Instructions can consume a lot of tokens that contribute to the context window size. To reduce your instruction size: - Write shorter instructions to save tokens. - Provide only the information necessary to perform the task. - Use concise and imperative language instead of indirect or jargon that the model might misinterpret. - Aim for one to three paragraphs instead of including a significant amount of background information, policy, or extra content. For more information on managing the context window size, see <doc:managing-the-context-window>.

Members (3)

get instructionsRepresentation(): Instructions

var instructionsRepresentation: Instructions { get }

static init(content: (() => Instructions)): Instructions

init(@InstructionsBuilder _ content: () throws -> Instructions) rethrows

static init78303(content: SDKHandle): Instructions

init(_ content: some InstructionsRepresentable)

All FoundationModels types →