Deckary Word AI agent tool reference
Reference the reading, writing, formatting, review, and run-control operations used by Deckary's Word AI agent.
Last verified: 2026-09-04
Deckary's Word AI agent uses a closed set of document tools plus shared run-control tools. The model chooses an operation, but the Word add-in resolves the live selection or target, enforces destructive-edit policy, performs the Word JavaScript API call, and returns host-observed evidence.
Read tools#
| Tool | Purpose |
|---|---|
read_selection | Read the current Word selection and its fingerprint |
read_document_summary | Read a bounded summary of the active document |
read_paragraphs | Read bounded paragraphs and create current target references |
search_doc_text | Find text occurrences and return current targets |
read_doc_section | Read a section and expose paragraph or section references |
Search and read results authorize later targeted work. A dependent target write must wait until the agent has observed the returned references.
Write tools#
| Tool | Purpose |
|---|---|
edit_doc_text | Perform a unique mechanical document find-and-replace |
apply_doc_edits | Apply a preflighted batch of exact target replacements |
replace_selection | Replace the current selection with one plain-text paragraph |
insert_text | Insert plain text at the verified current selection or cursor |
insert_blocks | Insert native headings, paragraphs, or list items |
replace_selection_with_blocks | Replace selected whole paragraphs with native structured blocks |
apply_style | Apply a built-in Word style |
apply_text_format | Format selected or targeted text with optional paragraph-role filters |
add_comment | Add a Word comment to a verified target |
Destructive selection and target replacements may require allow_destructive_edit. That flag is supplied only after the user approves the pending operation; it is not a general permission to rewrite the document.
Review tool#
verify_doc_structure checks supported document-structure conditions in the Word host. The current tool accepts document scope; unsupported selection, recent-mutation, or target-reference scopes are rejected instead of being approximated.
Shared run tools#
| Tool | Purpose |
|---|---|
ask_user | Ask for a decision required to continue safely |
resolve_pending | Resume or resolve a pending approved operation |
finish_run | Close the run only after required outcomes and evidence are settled |
The shared Office run treats conversation text as context, not proof that a document changed. A mutation must have a host-observed artifact before finish_run can support a completion claim.
See Editing and review for workflow examples.