Cloud Agents

When to reach for a cloud agent

• Daily / hourly summaries (digest emails, KPI reports).
• Inbox triage that runs while you sleep.
• Webhook responders — e.g. an agent that triages incoming Stripe events.
• Long-running workflows that exceed a single chat session.

Setting one up

1. Open Dashboard → Cloud agents.
2. Click + New cloud agent.
3. Pick a model, paste a system prompt, and add the tools you need.
4. Choose a trigger: Manual, Schedule (cron), or Webhook.
5. Save. The agent is live and runs on the next trigger.

Schedules

Cloud agents accept standard cron expressions. A few examples:

# Every hour at :00
0 * * * *

# Every weekday at 09:30
30 9 * * 1-5

# First of every month at 06:00
0 6 1 * *

Webhooks

Each webhook-triggered agent gets a unique URL of the form https://api.foxora.ai/v1/agents/<id>/invoke. Send a POST with a JSON body and the agent will start processing it.

curl -X POST https://api.foxora.ai/v1/agents/AGENT_ID/invoke \
  -H "Authorization: Bearer $FOXORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": "Hello from a webhook" }'

Logs & debugging

Every cloud agent run shows up in Dashboard → Usage with the prompt, the tool calls it made, and the final output. Failed runs keep their error trace for 30 days.