> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar herramientas

> Elige herramientas de chat, publicación, análisis y gestión y úsalas con seguridad.

## Descripción general

Esta página explica chat, publicaciones, análisis, generación y gestión. Prioriza herramientas individuales para objetivos concretos; `chat` delega procesos completos de varios pasos.

## Elegir la llamada

El cliente elige según la petición. Las herramientas individuales explicitan acciones, suelen ser más rápidas que `chat` y aclaran créditos y alcance.

| Petición | Método | Ejemplo |
| - | - | - |
| Un objetivo definido | Herramienta individual | Listar espacios, buscar posts, generar una imagen |
| Investigación, decisiones y creación combinadas | `chat` | Investigar marca, planificar y redactar varios borradores |

Indica el objetivo, como «Revisa espacios disponibles», o directamente «Usa `list_workspaces`».

## Delegar procesos a `chat`

`chat` delega investigación, análisis, escritura y medios al agente. Para una búsqueda o consulta, prefiere herramientas individuales.

| Parámetro | Obligatorio | Descripción |
| - | - | - |
| `deliverable` | Conversación nueva | Entregable y cantidad, por ejemplo tres borradores Instagram. |
| `outputLanguage` | Conversación nueva | Idioma de salida; japonés usa `ja`. |
| `prompt` | Sí | Contexto e instrucciones adicionales. |
| `audience` | No | Público objetivo. |
| `brandContext` | No | Producto, precio, fechas y contexto necesario. |
| `voice` | No | Estilo y emojis. |
| `constraints` | No | Caracteres, CTA y expresiones prohibidas. |
| `workspaceId` | No | ID del espacio. |
| `sessionId` | No | ID de conversación para revisar el mismo material. |

Indica entregable, plataforma, cuenta, público, marca o producto, estilo, idioma y longitud.

Las preguntas aparecen en `pendingQuestions` y pausan el proceso. Llama otra vez a `chat` con respuestas en `prompt` y el mismo `sessionId`.

## Consultar espacios e integraciones

Usa estas herramientas para revisar y conectar destinos:

* `list_workspaces` — IDs y nombres de espacios accesibles.
* `list_integrations` — Integraciones e IDs de cuentas de publicación.
* `get_connect_url` — URL de conexión del proveedor en NoimosAI.

Abre la URL para completar OAuth y revisa de nuevo con `list_integrations`.

## Guardar borradores y publicar

`post` guarda, publica o programa en formato NoimosAI. Acepta posts del cliente IA o del resultado `chat`.

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| `posts` | `array` | Sí | Lista de posts; usa IDs de cuenta de `list_integrations`. |
| `mode` | `string` | No | `draft`, `publish` o `schedule`. Si se omiten tanto `mode` como el parámetro antiguo `schedule`, la publicación se guarda como `draft`. |
| `scheduleAt` | `string` | Condicional | Requerido con `mode: "schedule"`; incluye zona horaria. |
| `workspaceId` | `string` | No | ID del espacio. |
| `dryRun` | `boolean` | No | `true` revisa destino y formato sin publicar. |

Revisa destino con `dryRun: true` y el texto. Usa `mode: "publish"` o `mode: "schedule"` solo tras aprobar; `mode: "draft"` mientras esperas.

> [!WARNING]
>
> `dryRun` revisa destino y formato, sin garantizar publicación.

## Gestionar posts, artículos y sitios

Herramientas dedicadas:

* `delete_posts` — Cancelar borradores y programados, eliminar publicados.
* `publish_article` — Publicar o programar artículos en WordPress, X Articles y Substack.
* `list_pinterest_boards` — Obtener IDs de tableros Pinterest.
* `create_website` / `publish_website` — Crear y publicar sitios.

Eliminar publicaciones es irreversible. `upload_website_source`, para enviar código local, solo está en Local.

## Gestionar marca y conocimientos

Mantén el contexto con:

* `get_workspace_context` — Resumen de marca, objetivos, idioma y cuentas juntos.
* `get_workspace_brand` / `update_workspace_brand` — Leer o actualizar toda la guía de marca.
* `knowledge_dataset_*` / `knowledge_content_*` — Gestionar conjuntos y contenidos de conocimientos.
* `create_workspace_and_onboard` — Crear espacio y configurar con investigación IA.

`get_workspace_context` aporta contexto antes de `chat`. Actualizar `keywords` y `websites` con `update_workspace_brand` sustituye cada lista completa. La ingesta consume créditos por embeddings. Crear espacios depende del plan y permisos.

## Responder DM y comentarios

Obtén IDs mediante lectura y revisa el mensaje.

* `send_dm` — Enviar texto a hilos DM existentes de X, Instagram, Facebook y TikTok.
* `reply_to_comment` — Responder comentarios o menciones en X o Instagram.

Envían al instante, sin borrador. Presenta cuenta, ID y texto y obtén autorización explícita antes.

IDs DM: `get_direct_messages`; comentarios: entre otros `list_x_user_mentions`, `instagram_comments_list` y `instagram_mentioned_comment_get`.

## Herramientas individuales de búsqueda y generación

La conexión carga herramientas del espacio: posts anteriores, búsqueda social, tendencias, GA4, Google Search Console, Semrush, análisis web, investigación y medios.

Las marcadas `[Billed]` consumen créditos según el proceso real. Sin conexión o autenticación puede aparecer solo el conjunto básico, sin catálogo.

## Generar imágenes y vídeos

Revisa modelos y costes; usa historial para estado y archivos.

| Paso | Herramientas | Uso |
| - | - | - |
| Elegir modelo | `list_media_models`, `get_media_model_form` | Revisar modelos, entradas y capacidades |
| Consultar coste | `get_media_model_cost` | Presupuesto de créditos previo |
| Generar o editar | `generate_image`, `generate_video`, `edit_image`, `edit_video` | Crear medios o modificar existentes |
| Obtener estado y archivos | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | Seguir proceso y descargar |
| Preparar entradas | `upload_media` | Subir archivos locales permitidos por Local |

Pide modelos y después presupuesto y entradas para una imagen cuadrada. Genera solo tras revisar modelo, entradas y coste.

`upload_media` envía el archivo a NoimosAI. Revisa archivo y finalidad y obtén autorización explícita para subirlo.

## Revisar operaciones con efectos

Aunque lo proponga la IA, una persona debe revisar destino y contenido antes de:

* Publicar o programar posts, artículos y sitios
* Enviar DM o comentarios
* Eliminar posts publicados
* Cambiar o eliminar marca y conocimientos
* Subir archivos locales
* Ejecutar herramientas que consumen créditos

Incluso con confirmación del cliente, revisa destino NoimosAI, espacio y cuenta.

## Páginas relacionadas

Estas páginas explican configuración y otros accesos.

* [Conectar clientes](https://docs.noimosai.com/es/developers/mcp/setup.md)
* [Entender los conceptos básicos](https://docs.noimosai.com/es/developers/cli/overview.md)
* [Paquete npm](https://www.npmjs.com/package/@noimosai/mcp)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.