send instruction.md

send_instruction()

call.send_instruction(instruction) sends a real-time instruction to the agent without changing the current task. Use it for context injection and behavioral nudges.

Signature

call.send_instruction(instruction: str) -> None

await call.sendInstruction(instruction: string): Promise<void>

Properties

Return value: None / Promise<void>

Example

@agent.on_task_complete("collect_order_id")
def on_order_id_collected(call: guava.Call):
    order = lookup_order(call.get_field("order_id"))
    call.send_instruction(
        f"Order #{'{'}order['id']{'}'} is {order['status']} "
        f"with an estimated delivery of {order['eta']}. "
        f"Share this with the caller naturally."
    )

agent.onTaskComplete("collect_order_id", async (call: guava.Call) => {
  const order = await lookupOrder(await call.getField("order_id") as string);
  await call.sendInstruction(
    `Order #
${'{'}order.id{'}'} is ${'{'}order.status{'}'} `
    + `with an estimated delivery of ${'{'}order.eta{'}'}.`
    + `Share this with the caller naturally.`
  );
})

Tip:

Unlike call.set_task(), call.send_instruction() doesn't replace the agent's current objective. Use it to inject context or steer behavior mid-conversation — for example, after a database lookup reveals something the agent should know.