Ziel setzen oder Geldziel vorschlagen
create_business_goalCreate an additional goal on explicit request. First check every active get_business_goals page: overlapping goals are not merged or replaced. Use update_business_goal to change a goal and archive_business_goal to retire it.
Translate the requested target
Choose metric, targetValue and cadence together. “20 bookings each week” uses bookings/20/weekly; “20 bookings by the deadline” uses once for the entire inclusive UTC-day span. Weekly repeats the full target in each Europe/Berlin reporting week, even a clipped first/last week; do not divide or prorate it. Resolve ambiguous dates or cadence before creating.
The target’s units follow the metric. A display title or segment label cannot establish missing measurement coverage. Select only an existing, evidenced segment rather than inventing one from the wording.
Check the outcome
Non-money goals become active. Paid revenue instead returns owner_approval_required/activates=false with proposalId/nextAction for a human Owner card; models never confirm. rejected changes nothing—read its reason. A stored definition is not measured progress, and creation spends nothing or triggers a provider action.
Use a fresh requestKey for each new intent across this actor/workspace’s goal create/update/archive operations. Replay returns its old receipt; keyless legacy calls are non-idempotent. After uncertainty read stored goals instead of creating again. Requires operator:prepare, accounting:read, operations:read and current authority.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"metric": "<metric>",
"targetValue": "<targetValue>",
"startsOn": "<startsOn>",
"deadlineOn": "<deadlineOn>"
},
"name": "create_business_goal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional display label; omitted derives a label from the goal. A label does not change measurement or source coverage. | |
| metric | Yes | Measurement: original paid revenue, inquiry count, booking count or booking rate. Money goals require Owner approval. | |
| cadence | No | once targets the entire date span; weekly repeats the full targetValue per business reporting week in that span. Omitted means once. | once |
| startsOn | Yes | First included valid UTC calendar day, YYYY-MM-DD. | |
| comparator | No | Minimum to reach or maximum to stay within; omitted means at_least. | at_least |
| deadlineOn | Yes | Last included valid UTC calendar day, YYYY-MM-DD, on or after startsOn. Clarify ambiguous dates before a write. | |
| requestKey | No | Caller-generated request UUID. Keep it with the same exact operation, actor and payload; a reused key with changed contents is rejected. After an uncertain result read the goal, never invent another key. | |
| segmentKey | No | Existing segment identifier; omitted or null means tenant-wide. An invented identifier does not establish measurable source coverage. | |
| targetValue | Yes | Safe integer in EUR cents for paid_revenue, counts for inquiries/bookings, or basis points for booking_rate (100 = 1%; maximum 10000). No currency conversion. | |
| segmentLabel | No | Display label for segmentKey; omitted or null when no segment is selected. Not a source selector. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | Flat stored goal definition and identity/revision metadata; no measured actual, progress or pace. | |
| goalId | No | Stored goal identity, present with active/archived results. | |
| reason | No | Rejection reason; no goal change was applied. | |
| status | Yes | Read before reporting success: stored active/archived goal, unactivated Owner request, or rejected change. | |
| replayed | No | Original receipt replay, not proof of current goal or request state. | |
| revision | No | Revision of the returned active/archived goal, not a measured-progress revision. | |
| activates | Yes | True only for an active non-money result; an Owner request never activates the goal. | |
| nextAction | No | Exact existing card/read continuation for an unactivated Owner request; models never confirm. | |
| proposalId | No | Stored Owner-request identity, present with owner_approval_required; not a goal ID. | |
| presentation | No | The request receipt is retained even if its card could not be displayed. Read the same proposal; never prepare again. | |
| lifecycleStatus | No |