Engage

Use this when the user explicitly asks to apply current Engage knowledge-base files to the assistant's private retrieval index, normally after one or more knowledge-file changes. The refresh safely replaces indexed chunks only after new chunks are ready and retains the previous working index if ingestion fails. Reuse the same idempotency key only when retrying the exact same requested refresh.

refresh_knowledge_index

Use this when the user explicitly asks to change assistant behavior for exactly one Engage channel. Call get_channel_overrides first and pass its checksum. For website chat, Facebook Messenger, SMS, or email, use response_length, max_questions, greeting, signoff, or additional_instructions. For voice, use only the voice-specific fields. Omitted fields and all other channels are preserved; an explicit null removes one field so its default applies. Set remove_override true, with no updates, to remove the entire selected channel override. Voice changes affect future calls, not calls already in progress.

update_channel_override

Use this when the user explicitly asks to change the title, category, description, alternative text, caption, tags, or active state of one Engage media asset. Call get_media_asset first, send only fields the user asked to change, and pass its exact configuration version. Deactivation can disable downstream use. This tool cannot upload, replace, archive, or delete media. Reuse an idempotency key only when retrying the exact same intended change.

update_media_asset_metadata

Use this when the user explicitly asks to update the bound tenant's Engage prompt profile. Call get_prompt_profile first, preserve all fields not requested to change, and pass the complete profile object with its exact current checksum. Reuse the same idempotency key only when retrying the exact same intended change.

update_prompt_profile

Use this when the user explicitly asks to add one attached JPEG, PNG, or WebP image to the bound tenant's private Engage media library. Include only metadata the user supplied or approved. The upload creates a new active asset and does not replace, publish, approve, archive, or delete existing media. Reuse the same idempotency key only when retrying the exact same upload.

upload_media_asset

Use this when the user explicitly asks to create or replace one UTF-8 Markdown or text file in the bound tenant's Engage knowledge base. Read an existing file first and pass its checksum, or use 'absent' only when creating a new path. Reuse the same idempotency key only when retrying the same intended change.

upsert_knowledge_file