Ziel ändern
update_business_goalReplace an active goal’s definition on explicit request. Use create_business_goal to create a separate goal and archive_business_goal to retire one. Archived goals cannot be edited or restored.
Build the replacement
Read get_business_goals(goalId), then construct a complete flat draft from that definition. For “change only the target,” keep its metric, dates, cadence, comparator, title and segment choices while changing targetValue. Omitted optional fields take defaults, a derived title or null segments; they do not retain stored values.
Changing metric also changes the target’s meaning: 500 is 5% for booking_rate but EUR 5 for paid_revenue. Decide the new metric and target together rather than carrying a number across units blindly.
Apply or hand off
If either old or new metric is paid_revenue, the result is owner_approval_required/activates=false with a human card. Models never call confirm_business_change. Otherwise active contains the stored definition/revision, not measured progress. rejected changes nothing—read its reason. No spending or provider action occurs.
Recover
requestKey spans this actor/workspace’s goal create/update/archive intents. Exact replay retains the original expectedRevision after success and returns the old receipt. Reread the goal after replay or uncertainty before another change. Requires operator:prepare, accounting:read, operations:read and current authority, rechecked at the write.
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>",
"goalId": "<goalId>",
"expectedRevision": "<expectedRevision>",
"requestKey": "<requestKey>"
},
"name": "update_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. | |
| goalId | Yes | Exact opaque goalId returned by get_business_goals in this workspace; never a proposal ID or another tenant's identifier. | |
| 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 | Yes | 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. | |
| expectedRevision | Yes | Exact revision from the same goalId read. A changed goal requires a fresh read and renewed user intent, not automatic revision replacement. |
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 |