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

# Utiliser les outils

> Choisissez et utilisez les outils de chat, publication, analyse et gestion en sécurité.

## Vue d’ensemble

Cette page couvre chat, publication, analyse, génération et gestion. Préférez un outil individuel pour un objectif précis ; `chat` délègue tout un travail en plusieurs étapes.

## Choisir l’appel

Le client choisit selon la demande. Les outils individuels sont explicites, généralement plus rapides que `chat` et facilitent le suivi des crédits et du périmètre.

| Demande | Méthode | Exemple |
| - | - | - |
| Un objectif défini | Outil individuel | Lister des espaces, chercher des posts, générer une image |
| Recherche, décisions et création combinées | `chat` | Étudier une marque, planifier, rédiger plusieurs brouillons |

Indiquez l’objectif, comme « Vérifie les espaces disponibles », ou nommez l’outil : « Utilise `list_workspaces` ».

## Déléguer un travail à `chat`

`chat` délègue recherche, analyse, rédaction et médias à l’agent. Préférez les outils individuels pour une seule recherche ou lecture.

| Paramètre | Obligatoire | Description |
| - | - | - |
| `deliverable` | Nouvelle conversation | Livrable et quantité, par exemple trois brouillons Instagram. |
| `outputLanguage` | Nouvelle conversation | Langue de sortie ; le japonais utilise `ja`. |
| `prompt` | Oui | Contexte et instructions complémentaires. |
| `audience` | Non | Public visé. |
| `brandContext` | Non | Produit, prix, dates et contexte utile. |
| `voice` | Non | Style et usage des émojis. |
| `constraints` | Non | Limites de caractères, CTA et formulations interdites. |
| `workspaceId` | Non | ID de l’espace cible. |
| `sessionId` | Non | ID de conversation pour réviser le même livrable. |

Précisez livrable, plateforme, compte, public, marque ou produit, style, langue et longueur.

Les questions apparaissent dans `pendingQuestions` et suspendent le travail. Rappelez `chat` avec vos réponses dans `prompt` et le même `sessionId`.

## Consulter espaces et intégrations

Utilisez ces outils pour vérifier et connecter les cibles :

* `list_workspaces` — IDs et noms des espaces accessibles.
* `list_integrations` — Intégrations et IDs des comptes de publication.
* `get_connect_url` — URL de l’écran de connexion du fournisseur dans NoimosAI.

Ouvrez l’URL pour terminer OAuth, puis revérifiez avec `list_integrations`.

## Enregistrer et publier des posts

`post` crée des brouillons, publie ou programme au format NoimosAI. Accepte les posts du client IA ou des résultats de `chat`.

| Paramètre | Type | Obligatoire | Description |
| - | - | - | - |
| `posts` | `array` | Oui | Liste des posts ; IDs de destination issus de `list_integrations`. |
| `mode` | `string` | Non | `draft`, `publish` ou `schedule`. Si `mode` et l’ancien paramètre `schedule` sont tous deux omis, la publication est enregistrée en `draft`. |
| `scheduleAt` | `string` | Conditionnel | Requis pour `mode: "schedule"` ; inclure le fuseau. |
| `workspaceId` | `string` | Non | ID de l’espace cible. |
| `dryRun` | `boolean` | Non | `true` vérifie destination et format sans publication. |

Vérifiez d’abord avec `dryRun: true`, puis le texte. Utilisez `mode: "publish"` ou `mode: "schedule"` après approbation seulement ; `mode: "draft"` en attente.

> [!WARNING]
>
> `dryRun` vérifie destination et format, sans garantir la publication.

## Gérer posts, articles et sites

Utilisez ces outils dédiés :

* `delete_posts` — Annuler brouillons et posts programmés, supprimer les posts publiés.
* `publish_article` — Publier ou programmer sur WordPress, X Articles et Substack.
* `list_pinterest_boards` — IDs des tableaux Pinterest.
* `create_website` / `publish_website` — Créer et publier des sites.

La suppression publiée est irréversible. `upload_website_source`, qui transmet le code local, est réservé à Local.

## Gérer marque et connaissances

Ces outils maintiennent le contexte :

* `get_workspace_context` — Résumé de marque, objectifs, langue et comptes réunis.
* `get_workspace_brand` / `update_workspace_brand` — Lire ou modifier tout le guide de marque.
* `knowledge_dataset_*` / `knowledge_content_*` — Gérer jeux de données et contenus de connaissances.
* `create_workspace_and_onboard` — Créer un espace avec intégration et recherche IA.

`get_workspace_context` fournit le contexte avant `chat`. Modifier `keywords` et `websites` via `update_workspace_brand` remplace chaque liste entière. L’ingestion consomme des crédits d’embedding. La création d’espace dépend du forfait et des autorisations.

## Répondre aux DM et commentaires

Lisez les IDs cibles, puis vérifiez le message.

* `send_dm` — Envoyer dans les fils DM existants de X, Instagram, Facebook et TikTok.
* `reply_to_comment` — Répondre aux commentaires ou mentions X et Instagram.

Ces outils envoient immédiatement, sans brouillon. Présentez compte, ID et texte et obtenez une approbation explicite.

IDs DM : `get_direct_messages` ; IDs de commentaires : notamment `list_x_user_mentions`, `instagram_comments_list` et `instagram_mentioned_comment_get`.

## Outils individuels de recherche et génération

La connexion charge les outils disponibles : anciens posts, recherche sociale, tendances, GA4, Google Search Console, Semrush, analyse de sites, recherche et médias.

Les outils `[Billed]` consomment des crédits selon le traitement réel. Hors ligne ou sans authentification, seuls les outils de base peuvent apparaître, sans catalogue.

## Générer images et vidéos

Vérifiez modèles et frais avant génération ; l’historique fournit ensuite état et fichiers.

| Étape | Outils | Usage |
| - | - | - |
| Choisir le modèle | `list_media_models`, `get_media_model_form` | Vérifier modèles, entrées et capacités |
| Vérifier les coûts | `get_media_model_cost` | Estimer les crédits avant génération |
| Générer ou modifier | `generate_image`, `generate_video`, `edit_image`, `edit_video` | Créer ou modifier les médias |
| Lire état et fichiers | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | Suivre le traitement et récupérer les fichiers |
| Préparer les entrées | `upload_media` | Téléverser les fichiers locaux autorisés via Local |

Demandez les modèles, puis l’estimation et les entrées pour une image carrée. Générez après examen du modèle, des entrées et du devis seulement.

`upload_media` envoie le fichier à NoimosAI. Vérifiez fichier et objectif et obtenez l’accord explicite avant téléversement.

## Vérifier les opérations ayant un effet

Même proposées par l’IA, ces actions nécessitent un examen humain du contenu et des cibles :

* Publier ou programmer posts, articles et sites
* Envoyer DM et commentaires
* Supprimer des posts publiés
* Modifier ou supprimer marques et connaissances
* Téléverser des fichiers locaux
* Exécuter des outils consommant des crédits

Même avec une confirmation du client, vérifiez destination NoimosAI, espace et compte.

## Pages associées

Ces pages expliquent configuration et autres accès.

* [Connecter les clients](https://docs.noimosai.com/fr/developers/mcp/setup.md)
* [Comprendre les bases](https://docs.noimosai.com/fr/developers/cli/overview.md)
* [Paquet npm](https://www.npmjs.com/package/@noimosai/mcp)


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