Configure Agent Business Rules
configure_agent_business_rulesSafely add or replace a named operational rules section inside an agent inbound prompt, then route the prompt patch through the governed agent.patch broker. It covers cross-business handoffs, callback language, alert promises, and client-specific operating rules, and leaves the rest of the prompt unchanged.
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": {
"agent_id": "<agent_id>",
"rules": "<rules>"
},
"name": "configure_agent_business_rules"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | replace (default) swaps the named section for these rules; append adds them to it. | |
| actor | No | Do not set. Kept for older clients; the signed-in connection identifies you. | |
| rules | Yes | Plain-language operational rules to insert as bullets, e.g. callback capture, sister-location boundaries, urgent alert handling. | |
| dry_run | No | Validate and show the prompt patch metadata without writing. | |
| agent_id | Yes | KaiCalls agent ID to update | |
| authority | No | Do not set. It cannot approve a change: the owner approves through review_url or by being signed in. | |
| source_ref | No | External source reference, such as a support ticket or assistant conversation ID. | |
| business_id | No | Business ID. Required when the agent has multiple accessible assignments. | |
| section_title | No | Prompt section heading to replace/append. Default: Operational handoff rules. | |
| idempotency_key | No | Required for writes. A retry with the same key applies the same proposed prompt change only once. | |
| queue_for_approval | No | When authority is missing, create a pending dashboard approval instead of returning needs_approval. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| error | No | Present when success is false | |
| result | No | ||
| status | No | ||
| success | Yes | Whether the tool completed successfully | |
| summary | No | ||
| agent_id | No | ||
| approval | No | ||
| request_id | No | ||
| business_id | No | ||
| rules_count | No | ||
| section_title | No |