.invoke() | XSAF

Signature

agent.invoke(prompt: string, sessionId?: string): Promise<InvokeResult>
agent.invoke(prompt: string, sessionId?: string): Promise<InvokeResult>

Usage

const result = await agent.invoke("Summarize this conversation", "customer-42");

if ("text" in result) {
  console.log(result.text);
} else {
  for await (const chunk of result.textStream) process.stdout.write(chunk);
  await result.completed;
}

The session ID defaults to "default". Requests in one session run serially, while different sessions may run concurrently.

.invoke() builds a model request from the persona, stored session messages, configured model, tools, delegates, MCP tools, step limit, and reasoning setting. Tool policy and events use the same path whether invocation came directly, through a channel, from a schedule, by delegation, or through POST /invoke.

Streaming results persist the assistant response after consumption completes. See Sessions & Memory.