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

> Escolha e use chat, publicação, análise e gestão com segurança.

## Visão geral

Esta página cobre chat, publicação, análise, geração e gestão. Prefira ferramentas específicas; `chat` delega trabalhos completos em etapas.

## Escolher chamada

O cliente escolhe conforme o pedido. Ferramentas específicas explicitam operações, costumam ser mais rápidas que `chat` e esclarecem créditos e alcance.

| Pedido | Método | Exemplo |
| - | - | - |
| Um objetivo | Ferramenta específica | Listar espaços, buscar posts, gerar imagem |
| Pesquisa, decisões e criação juntas | `chat` | Estudar marca, planejar e redigir rascunhos |

Diga o objetivo, como “Confira os espaços”, ou nomeie: “Use `list_workspaces`”.

## Delegar fluxo a `chat`

`chat` delega pesquisa, análise, escrita e mídia ao agente. Prefira ferramentas específicas para uma busca ou leitura.

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `deliverable` | Nova conversa | Material e quantidade, como três rascunhos Instagram. |
| `outputLanguage` | Nova conversa | Idioma; japonês usa `ja`. |
| `prompt` | Sim | Contexto e instruções adicionais. |
| `audience` | Não | Público. |
| `brandContext` | Não | Produto, preço, período e contexto necessário. |
| `voice` | Não | Estilo e emojis. |
| `constraints` | Não | Caracteres, CTA e expressões proibidas. |
| `workspaceId` | Não | ID do espaço. |
| `sessionId` | Não | ID da conversa para revisar o mesmo material. |

Especifique material, plataforma, conta, público, marca ou produto, estilo, idioma e tamanho.

Perguntas em `pendingQuestions` pausam o trabalho. Chame `chat` de novo com respostas em `prompt` e o mesmo `sessionId`.

## Consultar espaços e integrações

Use estas ferramentas:

* `list_workspaces` — IDs e nomes dos espaços acessíveis.
* `list_integrations` — Integrações e IDs das contas de publicação.
* `get_connect_url` — URL de conexão do provedor no NoimosAI.

Abra a URL para concluir OAuth e confira novamente com `list_integrations`.

## Salvar e publicar posts

`post` salva, publica ou agenda no formato NoimosAI. Aceita posts do cliente IA ou do resultado `chat`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `posts` | `array` | Sim | Lista de posts; IDs de conta de `list_integrations`. |
| `mode` | `string` | Não | `draft`, `publish` ou `schedule`. Se `mode` e o parâmetro antigo `schedule` forem ambos omitidos, a publicação é salva como `draft`. |
| `scheduleAt` | `string` | Condicional | Exigido com `mode: "schedule"`; inclua fuso horário. |
| `workspaceId` | `string` | Não | ID do espaço. |
| `dryRun` | `boolean` | Não | `true` verifica destino e formato sem publicar. |

Confira destino com `dryRun: true` e revise texto. Use `mode: "publish"` ou `mode: "schedule"` após aprovação; `mode: "draft"` enquanto aguarda.

> [!WARNING]
>
> `dryRun` verifica destino e formato, sem garantir publicação.

## Gerenciar posts, artigos e sites

Ferramentas dedicadas:

* `delete_posts` — Cancelar rascunhos e agendados, excluir publicados.
* `publish_article` — Publicar ou agendar em WordPress, X Articles e Substack.
* `list_pinterest_boards` — IDs de pastas Pinterest.
* `create_website` / `publish_website` — Criar e publicar sites.

Excluir publicados é irreversível. `upload_website_source` envia código local e só existe em Local.

## Gerenciar marca e conhecimento

Mantenha contexto com:

* `get_workspace_context` — Resumo de marca, metas, idioma e contas juntos.
* `get_workspace_brand` / `update_workspace_brand` — Ler ou alterar todo o guia de marca.
* `knowledge_dataset_*` / `knowledge_content_*` — Gerenciar conjuntos e conteúdos.
* `create_workspace_and_onboard` — Criar espaço e onboarding com pesquisa IA.

`get_workspace_context` fornece contexto antes de `chat`. Alterar `keywords` e `websites` com `update_workspace_brand` substitui listas inteiras. Ingestão consome créditos de embeddings. Criar espaços depende do plano e permissões.

## Responder DMs e comentários

Leia IDs e revise a mensagem.

* `send_dm` — Texto em DMs existentes de X, Instagram, Facebook e TikTok.
* `reply_to_comment` — Respostas a comentários ou menções X e Instagram.

Enviam imediatamente sem rascunho. Mostre conta, ID e texto e obtenha aprovação explícita.

IDs DM de `get_direct_messages`; comentários, entre outros, de `list_x_user_mentions`, `instagram_comments_list` e `instagram_mentioned_comment_get`.

## Busca, análise e geração específicas

A conexão carrega ferramentas do espaço: posts anteriores, busca social, tendências, GA4, Google Search Console, Semrush, análise web, pesquisa e mídia.

Ferramentas `[Billed]` consomem créditos pelo processo real. Offline ou sem autenticação pode aparecer apenas o conjunto básico, sem catálogo.

## Gerar imagens e vídeos

Confira modelos e custos; use histórico para estado e arquivos.

| Etapa | Ferramentas | Uso |
| - | - | - |
| Escolher modelo | `list_media_models`, `get_media_model_form` | Ver modelos, entradas e capacidades |
| Consultar custos | `get_media_model_cost` | Estimar créditos antes da geração |
| Gerar ou editar | `generate_image`, `generate_video`, `edit_image`, `edit_video` | Criar ou modificar mídia |
| Obter estado e arquivos | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | Acompanhar e recuperar arquivos |
| Preparar entradas | `upload_media` | Enviar arquivos locais permitidos com Local |

Peça modelos e depois estimativa e entradas de uma imagem quadrada. Gere só após revisar modelo, entradas e custo.

`upload_media` envia o arquivo ao NoimosAI. Confira arquivo e propósito e obtenha aprovação explícita para upload.

## Revisar operações com efeitos

Mesmo propostas pela IA, uma pessoa verifica alvos e conteúdo antes de:

* Publicar ou agendar posts, artigos e sites
* Enviar DMs e comentários
* Excluir publicados
* Alterar ou excluir marca e conhecimento
* Enviar arquivos locais
* Executar ferramentas que consomem créditos

Mesmo com confirmação do cliente, confira destino NoimosAI, espaço e conta.

## Páginas relacionadas

Estas páginas explicam configuração e outros acessos.

* [Conectar clientes](https://docs.noimosai.com/pt/developers/mcp/setup.md)
* [Entender os fundamentos](https://docs.noimosai.com/pt/developers/cli/overview.md)
* [Pacote npm](https://www.npmjs.com/package/@noimosai/mcp)


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