Run a managed agent for one of your users

import os

from celesto import ManagedAgentsClient


if not os.environ.get("CELESTO_API_KEY"):
    raise RuntimeError("Set CELESTO_API_KEY before running this script.")

celesto = ManagedAgentsClient()

agent = celesto.agents.create(
    name="support-bot",
    model="openai/gpt-5.4-mini",
    instructions="Answer order questions in one short paragraph.",
)

for event in celesto.runs.stream(
    agent["id"], input="Where is my order?", end_user_id="usr_8837"
):
    if event.name == "message.delta":
        print(event.data.get("text", ""), end="", flush=True)

budget = celesto.end_users.get("usr_8837")["budget"]
print(f"\nSpent {budget['spent_usd']} of {budget['cap_usd']}")

run = celesto.runs.create(
    agent["id"], input="Where is my order?", end_user_id="usr_8837"
)
print(run["output"], run["usage"]["cost_usd"])

from decimal import Decimal

celesto.end_users.update("usr_8837", budget_cap_usd=Decimal("5.00"))
celesto.settings.update(default_end_user_budget_usd=Decimal("0.50"))