office-artifacts

Office Artifacts

Use document_artifact for substantial Office deliverables that should remain editable in the canvas. Do not paste long document, spreadsheet, or deck bodies only into chat when the user asked for an editable file.

Workflow

1. Create or open the artifact with document_artifact:create or document_artifact:open.
2. Before content-sensitive edits, call document_artifact:read with file_id or path.
3. Apply saved changes with document_artifact:edit.
4. Use version_history or restore_version when the user asks to audit or roll back.

Canvas context may list opened Office files with file_id, path, version, size, and timestamp. It intentionally omits full file contents; use read when the content matters.

Minimal Calls

Create:

{
  "tool_name": "document_artifact:create",
  "tool_args": {
    "kind": "document",
    "title": "Project Brief",
    "format": "docx",
    "content": "Draft text here."
  }
}

For spreadsheets, content can be CSV, TSV, or a Markdown table; the tool writes real cells, not one text blob per row.

Read:

{
  "tool_name": "document_artifact:read",
  "tool_args": {
    "file_id": "abc123"
  }
}