Agent class

import { Agent, type AgentConfig } from "@ai_kit/core";

​

AgentConfig

​

Constructor

const agent = new Agent(config: AgentConfig);

​

Instance methods

​

agent.generate(options)

generate<OUTPUT = never, PARTIAL = never, STATE extends RuntimeState = RuntimeState>(
  options: AgentGenerateOptions<OUTPUT, PARTIAL, STATE>
): Promise<AgentGenerateResult<OUTPUT>>;

• system?: string – overrides the default instructions.
• structuredOutput?: Output.Output<OUTPUT, PARTIAL> – schema-based generation (Zod).
• runtime?: RuntimeStore<STATE> – shared runtime (see RuntimeStore).
• telemetry?: AgentTelemetryOverrides – merges functionId, metadata, recordInputs, recordOutputs.
• loopTools?: boolean / maxStepTools?: number – per-call overrides for the tool loop.

​

agent.stream(options)

stream<OUTPUT = never, PARTIAL = never, STATE extends RuntimeState = RuntimeState>(
  options: AgentStreamOptions<OUTPUT, PARTIAL, STATE>
): Promise<AgentStreamResult<PARTIAL>>;

• textStream, fullStream, text, response, usage, steps.
• experimental_partialOutputStream when structuredOutput is provided.
• toAIStreamResponse() / toDataStreamResponse() to integrate with HTTP streaming responses.

​

agent.withTelemetry(enabled?: boolean)

agent.withTelemetry();      // enable
agent.withTelemetry(false); // disable

​

Utility types

• AgentTools – union between AI SDK ToolSet and provider dictionaries.
• AgentGenerateResult<T> – alias of GenerateTextResult + loopTool.
• AgentStreamResult<T> – alias of StreamTextResult + loopTool.
• AgentTelemetryOverrides – functionId, metadata, recordInputs?, recordOutputs?.

​

Runtime handling

• a RuntimeStore snapshot is created for the call duration;
• onCleanup handlers run at the end (success, error, or cancellation);
• RuntimeStore.mergeExperimentalContext merges manually passed experimental_context with the runtime state.