Todas las herramientas

word_append

Documentos · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Agrega texto al final de un documento de Word (.docx) existente en `path`, conservando el contenido (`content`) y el formato existentes del documento. Requiere confirm=true: se llama sin él y devuelve una vista previa en lugar de modificar el archivo. Las mismas reglas de acceso a archivos que word_create (Escritorio/Documentos/Descargas pueden necesitar una concesión de Archivos y carpetas). Devuelve `{appended, chars_appended, path}`. Para crear un nuevo documento utilice word_create; para leer uno use word_read.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglésmacOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to modify",
      "type": "boolean"
    },
    "content": {
      "description": "Text to append",
      "type": "string"
    },
    "path": {
      "description": "Path to the existing .docx file",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para word_append. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "/Users/demo/Documents/meeting-notes.docx"
}

Windows

Propósito

Agrega texto a un documento de Word (.docx) existente.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglésWindows
{
  "properties": {
    "confirm": {
      "description": "Must be true to append",
      "type": "boolean"
    },
    "content": {
      "description": "Text to append",
      "type": "string"
    },
    "path": {
      "description": "Path to .docx file",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para word_append. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.docx"
}