> ## 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.

# Usare gli strumenti

> Scegli e usa chat, pubblicazione, analisi e gestione in sicurezza.

## Panoramica

Questa pagina presenta chat, pubblicazione, analisi, generazione e gestione. Preferisci strumenti specifici; `chat` delega interi lavori articolati.

## Scegliere la chiamata

Il client sceglie secondo la richiesta. Gli strumenti specifici esplicitano l’operazione, sono di solito più rapidi di `chat` e chiariscono crediti e ambito.

| Richiesta | Metodo | Esempio |
| - | - | - |
| Un obiettivo | Strumento specifico | Elencare spazi, cercare post, creare un’immagine |
| Ricerca, decisioni e creazione insieme | `chat` | Studiare il brand, pianificare e scrivere più bozze |

Indica l’obiettivo, come «Controlla gli spazi», o il nome: «Usa `list_workspaces`».

## Delegare un flusso a `chat`

`chat` delega ricerca, analisi, scrittura e media all’agente. Per una sola ricerca o lettura usa strumenti specifici.

| Parametro | Obbligatorio | Descrizione |
| - | - | - |
| `deliverable` | Nuova conversazione | Materiale e quantità, ad esempio tre bozze Instagram. |
| `outputLanguage` | Nuova conversazione | Lingua; il giapponese usa `ja`. |
| `prompt` | Sì | Contesto e istruzioni aggiuntive. |
| `audience` | No | Pubblico. |
| `brandContext` | No | Prodotto, prezzo, periodo e contesto utile. |
| `voice` | No | Stile ed emoji. |
| `constraints` | No | Caratteri, CTA ed espressioni vietate. |
| `workspaceId` | No | ID spazio. |
| `sessionId` | No | ID conversazione per rivedere lo stesso materiale. |

Specifica materiale, piattaforma, account, pubblico, brand o prodotto, stile, lingua e lunghezza.

Le domande in `pendingQuestions` sospendono il lavoro. Richiama `chat` con risposte in `prompt` e lo stesso `sessionId`.

## Controllare spazi e integrazioni

Usa questi strumenti:

* `list_workspaces` — ID e nomi degli spazi accessibili.
* `list_integrations` — Integrazioni e ID account per pubblicare.
* `get_connect_url` — URL di connessione del provider in NoimosAI.

Apri l’URL per OAuth, poi ricontrolla con `list_integrations`.

## Salvare e pubblicare post

`post` salva bozze, pubblica o programma nel formato NoimosAI. Accetta post del client IA o del risultato `chat`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| - | - | - | - |
| `posts` | `array` | Sì | Elenco post; ID account da `list_integrations`. |
| `mode` | `string` | No | `draft`, `publish` o `schedule`. Se vengono omessi sia `mode` sia il parametro precedente `schedule`, il post viene salvato come `draft`. |
| `scheduleAt` | `string` | Condizionale | Richiesto con `mode: "schedule"`; includi fuso orario. |
| `workspaceId` | `string` | No | ID spazio. |
| `dryRun` | `boolean` | No | `true` verifica destinazione e formato senza pubblicare. |

Verifica destinazione con `dryRun: true` e controlla il testo. Usa `mode: "publish"` o `mode: "schedule"` dopo approvazione; `mode: "draft"` nell’attesa.

> [!WARNING]
>
> `dryRun` verifica destinazione e formato, senza garantire la pubblicazione.

## Gestire post, articoli e siti

Strumenti dedicati:

* `delete_posts` — Annullare bozze e programmati, eliminare pubblicati.
* `publish_article` — Pubblicare o programmare su WordPress, X Articles e Substack.
* `list_pinterest_boards` — ID bacheche Pinterest.
* `create_website` / `publish_website` — Creare e pubblicare siti.

Eliminare pubblicati è irreversibile. `upload_website_source` per il codice locale è solo Local.

## Gestire brand e conoscenze

Mantieni il contesto con:

* `get_workspace_context` — Riepilogo brand, obiettivi, lingua e account insieme.
* `get_workspace_brand` / `update_workspace_brand` — Leggere o aggiornare l’intera guida.
* `knowledge_dataset_*` / `knowledge_content_*` — Gestire dataset e contenuti.
* `create_workspace_and_onboard` — Creare spazio e onboarding con ricerca IA.

`get_workspace_context` fornisce contesto prima di `chat`. Cambiare `keywords` e `websites` con `update_workspace_brand` sostituisce le liste intere. L’ingestione consuma crediti per embedding. La creazione dipende da piano e permessi.

## Rispondere a DM e commenti

Leggi gli ID, poi verifica il messaggio.

* `send_dm` — Testo a thread DM esistenti su X, Instagram, Facebook e TikTok.
* `reply_to_comment` — Risposte a commenti o menzioni su X o Instagram.

Inviano subito senza bozza. Mostra account, ID e testo e ottieni consenso esplicito prima.

ID DM da `get_direct_messages`; commenti da `list_x_user_mentions`, `instagram_comments_list` e `instagram_mentioned_comment_get`, tra gli altri.

## Ricerca, analisi e generazione specifiche

La connessione carica strumenti per post precedenti, ricerca social, tendenze, GA4, Google Search Console, Semrush, analisi web, ricerca e media.

Gli strumenti `[Billed]` consumano crediti secondo l’elaborazione reale. Offline o senza autenticazione può comparire solo l’insieme base, senza catalogo.

## Generare immagini e video

Verifica modelli e costi; recupera stato e file dalla cronologia.

| Fase | Strumenti | Uso |
| - | - | - |
| Scegliere modello | `list_media_models`, `get_media_model_form` | Verificare modelli, input e capacità |
| Controllare costi | `get_media_model_cost` | Preventivo crediti prima della generazione |
| Generare o modificare | `generate_image`, `generate_video`, `edit_image`, `edit_video` | Creare o modificare media |
| Recuperare stato e file | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | Seguire il processo e recuperare file |
| Preparare input | `upload_media` | Caricare file locali consentiti con Local |

Chiedi i modelli e poi preventivo e input per un’immagine quadrata. Genera dopo aver verificato modello, input e costo.

`upload_media` invia il file a NoimosAI. Verifica file e finalità e ottieni consenso esplicito al caricamento.

## Verificare operazioni con effetti

Anche se proposte dall’IA, una persona verifica contenuto e destinazione prima di:

* Pubblicare o programmare post, articoli e siti
* Inviare DM e commenti
* Eliminare post pubblicati
* Modificare o eliminare brand e conoscenze
* Caricare file locali
* Eseguire strumenti che consumano crediti

Anche con conferma del client, verifica destinazione NoimosAI, spazio e account.

## Pagine correlate

Queste pagine descrivono configurazione e altri accessi.

* [Connettere i client](https://docs.noimosai.com/it/developers/mcp/setup.md)
* [Comprendere le basi](https://docs.noimosai.com/it/developers/cli/overview.md)
* [Pacchetto npm](https://www.npmjs.com/package/@noimosai/mcp)


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