automated-prompts-tool
Manage automated chatbot prompts that run at scheduled intervals: create, update, delete, list, inspect, and page through stored responses. Control response visibility and verify job scheduling.
Instructions
This tool manages Rhombus MIND automated prompts - scheduled chatbot jobs that run a prompt at a recurring interval and store each response. Use it to list, inspect, create, update, delete, page through past responses for, share, or re-verify the schedule of an automated prompt.
Modes (set "requestType"):
list: List all automated prompts in the org. Optional 'lastEvaluatedKey' / 'maxPageSize' for pagination.
get: Get a single automated prompt's settings. Requires 'promptUuid'.
create: Create a new automated prompt. Requires 'prompt', 'invokeAt' (ISO 8601 with offset, must be at least 15 minutes in the future), 'frequencyValue', 'frequencyUnit', and 'permissionGroupUuid'. Optional 'responseTemplate' and 'notifyUserUuids'.
update: Selectively update an automated prompt. Requires 'promptUuid'; only the fields you set will be changed. To change the role, the caller must have access to both the current and new role. Pass an empty 'notifyUserUuids' array to clear notifyees.
delete: Delete an automated prompt and all of its stored responses. Requires 'promptUuid'.
get-history: Page through responses generated by an automated prompt. Requires 'promptUuid'. Optional 'lastEvaluatedKey' / 'maxPageSize'.
share-response: Update the visibility of one stored response. Requires 'chatUuid' and 'visibility' (PUBLIC, ORG_WIDE, SELECT_USERS, PRIVATE).
verify-scheduled: Re-verify that the job is scheduled to trigger; the server reschedules it if missing. Requires 'promptUuid'.
Notes:
Use 'user-tool' to look up user UUIDs and resolve them to names/emails. 'notifyUserUuids' must be members of the chosen 'permissionGroupUuid'.
'invokeAt' is an ISO 8601 timestamp; both 'Z' and '+/-HH:mm' offsets are accepted. The tool converts it to milliseconds for the API.
Timestamps in the output are ISO 8601 strings with timezone offset (defaults to America/Los_Angeles when no org timezone is available).
'submitTestPrompt' is intentionally not exposed by this tool.
Output filtering (all tools):
includeFields(string[]): Dot-notation paths to keep in the response (e.g."vehicleEvents.vehicleLicensePlate"). Omit to return all fields.filterBy(array): Predicates to filter array items. Each entry:{field, op, value}where op is one of= != > >= < <= contains. All conditions are ANDed. Example:[{field:"vehicleLicensePlate", op:"=", value:"ABC123"}]WARNING: some tool responses exceed 400k characters — use these params to request only the data you need.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestType | Yes | The type of automated prompt request to make. | |
| promptUuid | Yes | UUID of the automated prompt. Required for 'get', 'update', 'delete', 'get-history', and 'verify-scheduled'. | |
| chatUuid | Yes | UUID of a chat record (an individual response generated by an automated prompt). Required for 'share-response'. | |
| visibility | Yes | Visibility for a shared chat response. Required for 'share-response'. One of PUBLIC, ORG_WIDE, SELECT_USERS, PRIVATE. | |
| prompt | Yes | The prompt MIND will execute every time the job runs. Required for 'create', recommended for 'update'. | |
| responseTemplate | Yes | Optional template that guides the shape of MIND's response. Used by 'create' and 'update'. | |
| frequencyValue | Yes | How many time units between runs (e.g. 1 for 'every 1 day'). Required for 'create' alongside frequencyUnit. | |
| frequencyUnit | Yes | Unit for the recurrence (HOURS, DAYS, WEEKS, MONTHS). Required for 'create' alongside frequencyValue. | |
| invokeAt | Yes | When the automated prompt should first run. Required for 'create'. Must be at least 15 minutes in the future. Time format is in ISO 8601 format. Both UTC ("2025-08-04T20:54:27.123Z") and time zone offsets ("2025-08-04T13:54:27.123-07:00") are accepted to ensure an unambiguous point in time. | |
| permissionGroupUuid | Yes | UUID of the permission group/role that owns the job. Users in this role (or a higher role) can view and edit the job, and MIND uses this role's permissions when running the prompt. Required for 'create'. | |
| notifyUserUuids | Yes | User UUIDs to email-notify when MIND finishes a run. These users must be members of the permission group set above. Used by 'create' and 'update'. Pass an empty array to clear existing notifyees on 'update'. | |
| lastEvaluatedKey | Yes | Pagination cursor returned by a previous 'list' or 'get-history' call. Pass to fetch the next page. | |
| maxPageSize | Yes | Maximum number of items per page for 'list' and 'get-history'. | |
| includeFields | Yes | Dot-notation field paths to include in the response (e.g. "vehicleEvents.vehicleLicensePlate"). Pass null to return all fields. WARNING: some responses can exceed 400k characters — use includeFields to request only the data you need. For high-volume tools this may be required to get a complete answer. | |
| filterBy | Yes | Filter array items in the response by field values. All conditions are ANDed. Example: [{field: "vehicleLicensePlate", op: "=", value: "ABC123"}, {field: "confidence", op: ">", value: 0.8}] Use alongside includeFields to get only the specific records and fields you need. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| settings | No | Returned by 'get', 'create', and 'update'. | |
| settingsList | No | Returned by 'list'. | |
| lastEvaluatedKey | No | Pagination cursor for the next page; absent when no more pages. | |
| chatHistory | No | Returned by 'get-history'. | |
| verifyResult | No | Returned by 'verify-scheduled'. Schedule expression and timezone for the next trigger. | |
| success | No | Returned by 'delete' and 'share-response'. | |
| error | No | An error message if the request failed. |