Downcity
FAQ

SDK FAQ

Common questions about the Agent SDK, Local Agent, and RemoteAgent

SDK FAQ

Why does a local session need set({ model }) first?

Because the local SDK Agent owns the execution shell and session capability, while the caller explicitly provides the live model instance.

Why can RemoteAgent not pass a local model instance remotely?

Because model instances are usually not serializable and should be held on the server side.

Why is local SDK model configuration different from project runtime model configuration?

Because they target different use cases:

  • project runtime is for long-running project execution and gets its model from execution.modelId
  • local SDK is for embedded use and gets its live model instance explicitly from the caller