Web SDK
connectAgent
A whole conversation with an AG-UI agent, drawn as it streams, with the reader's actions sent back and the state shared.
connectAgent(el: HTMLElement, options: AgentOptions): ConversationIt needs the core from morphscreen-agent.wasm. Every option of createAnswer applies to each answer, except onOps.
AgentOptions
| Option | Type | What it does |
|---|---|---|
url |
string |
the agent's endpoint: a run's input is POSTed, its events read back |
headers |
object, or a function returning one | request headers, like your own auth, for each run |
threadId |
string |
the conversation's id; a new one when left out |
tools, context, forwardedProps |
sent with every run, as AG-UI defines them | |
onToolCall |
(call) => result |
answers a tool of yours the agent called; the conversation then goes on |
onUpdate |
(update) => void |
every update from the core: steps, custom events, warnings |
onState |
(state) => void |
the shared state changed, by the agent or the reader |
sendActions |
boolean |
send the reader's actions on as user messages (default true) |
Conversation
| Member | What it does |
|---|---|
send(content, id?) |
the reader says something (text, or AG-UI content parts); runs the agent |
run() |
runs the agent on the conversation as it is |
stop() |
stops the run in progress, which ends as truncated |
messages(), state() |
what to save |
load(messages, state?) |
starts from a saved conversation |
setState(state) |
sets the shared state |
threadId, running |
the conversation's id, and whether a run is going |
destroy() |
stops and clears it |
AG-UI agents has the guide.