Como perguntar à IA, anexar arquivos, rodar agentes, aprovar propostas e criar skills e agentes.

Antes de tudo, um administrador ou um gestor de IA precisa ativar um provedor em Configurações → IA → LLM. Sem isso, a conversa e os agentes não respondem.

A conversa

Abra o Chat na barra lateral. Toda conversa pertence a um projeto (coleção): é dele que a IA tira o contexto, e é por ele que as conversas ficam organizadas para você retomar depois. Administradores podem também conversar sobre a wiki inteira.

Dentro de um documento, o botão Chat com IA, no topo, abre a mesma conversa no painel lateral, já com o documento como contexto. O atalho ⌘. (Ctrl+. no Windows e no Linux) abre ou fecha o último painel lateral usado — de saída, o da IA.

Fontes: a resposta lista os documentos de onde saiu. Clique para abrir.
Anexos: pelo clipe, envie até 3 arquivos por mensagem. De PDF, Word (.docx), texto (.txt) e Markdown a IA lê o texto; de imagens (PNG, JPG, WebP e GIF, até 5 MB) ela vê o conteúdo. PDF escaneado não tem texto para ler, e não há OCR: a IA avisa em vez de inventar.
@: no campo de mensagem, @ arma uma skill ou manda a IA ler um documento específico. O escolhido vira um chip acima do campo.
Parar: o botão de parar interrompe a resposta; o que já chegou fica na tela.
Avaliar: 👍 ou 👎 em cada resposta. No 👎 você pode dizer o motivo — é o que mostra ao time onde a IA está errando.

Conversas longas não se perdem: quando o histórico passa do que o modelo comporta, as partes antigas viram um resumo para a IA, e você continua vendo todas as mensagens.

A IA redigindo um documento

Peça “escreva a ata desta reunião” ou “redija a especificação a partir deste card”. A conversa mostra o documento pronto, e você decide se ele entra na wiki:

No Chat: Ver prévia e Criar documento (ou Criar · {modelo}).
No painel de um documento: Ver mudanças, Atualizar este, Criar novo ou Descartar.

Se o projeto tem mais de um modelo para aquele tipo e nenhum foi escolhido, a conversa pergunta qual usar — a escolha vale só para esse documento.

Agentes

Um agente é uma IA com ferramentas. Enquanto a conversa responde com o que já está escrito, o agente trabalha: pesquisa na base, lê documentos e anexos, aplica skills e escreve. Se quem configurou o agente marcou essas ferramentas, ele também consulta o ClickUp (com o token de quem disparou, em Configurações → Integrações), busca na web, pergunta no meio do trabalho e chama outros agentes.

Rodar um agente

Na conversa, escolha o agente no seletor de agentes do projeto.
Descreva a tarefa e envie. Alguns agentes trazem atalhos com tarefas prontas.
O agente roda em segundo plano: você pode sair da tela, e o progresso fica salvo na conversa.
Se faltar informação e ele puder perguntar, ele pergunta, às vezes com opções para escolher, e espera a sua resposta (por até 30 minutos, por padrão).

Cada pessoa roda um agente por vez em cada projeto. Para parar no meio, use Parar a execução.

O que o agente grava e o que ele propõe

Documento novo: o agente grava na hora, até o limite de criações configurado para ele. Se não servir, mande para a lixeira.
Mudança num documento que já existe: vira uma proposta, que só entra na wiki quando você aprova. Use aprovar ou o X para descartar (com motivo opcional). Com várias, Aprovar todas (N) pede confirmação e aplica na ordem da lista.

Aprovar grava uma nova versão do documento, que pode ser desfeita pelo histórico.

Skills

Uma skill é uma instrução reutilizável: “resuma no formato da nossa ata”, “revise o texto no tom da marca”. Escreva uma vez e o time inteiro usa na conversa com @. Agentes também podem usar skills durante o trabalho.

Para criar: Configurações → IA → Skills. Dê nome, descrição e as instruções. A skill pode valer para o workspace inteiro ou só para um projeto, e pode estar ligada a um tipo de documento — aí ela já sabe a forma do que produz.

Criar e ajustar um agente

Em Configurações → IA → Agentes (administrador ou gestor de IA; o gestor só consulta a lista):

Campo	O que define
Nome, descrição e instruções	Quem o agente é e como trabalha
Projeto dedicado (opcional)	Vazio = aparece em todos os projetos e trabalha no projeto aberto. Preenchido = só naquele
Ferramentas	O que ele pode fazer. O agente novo já vem com busca, leitura, proposta de edição e criação de documento; ClickUp, busca na web, perguntar e chamar outro agente você marca
Skills	Quais skills ele pode usar (vazio = todas)
Tipo produzido	O tipo de documento que ele redige, com o modelo do projeto
Modelo	Provedor e modelo próprios, se não quiser o padrão do workspace
Limites de execução	Idas ao modelo, documentos criados e tokens por execução. Vazio usa o padrão do sistema

Em cada projeto, a seção Agentes de Configurar projeto restringe quais agentes aparecem no seletor daquele projeto. Nenhum marcado = todos os que podem aparecer ali.

Tipos de documento e modelos

Em Configurações → Tipos de documento você define os modelos do time: história, especificação, casos de teste, ata, e o que mais precisar. Cada tipo tem um texto inicial e instruções para a IA. Um projeto pode usar uma variante de um tipo (por exemplo, a especificação no formato de um cliente) sem mudar o dos outros.

Análise de conflitos

A IA compara os documentos de uma coleção e aponta os que se contradizem — um prazo diferente em dois documentos, uma regra descrita de dois jeitos. Não há botão na wiki para isso: rode pela ferramenta MCP analisar_conflitos (veja Servidor MCP). Com a busca semântica ligada, ela compara só os documentos parecidos; sem ela, a IA vê um lote limitado da coleção.

Busca semântica

Com a Busca semântica ligada no servidor (veja Self-host), a conversa e os agentes encontram documentos pelo sentido da pergunta, e os agentes conseguem conferir uma afirmação contra a base. O ⌘K continua procurando por palavras.

Em Configurações → IA → Busca semântica você escolhe o modelo de embedding e, ao ligar ou trocar o modelo, usa Reindexar tudo para o conteúdo existente entrar no índice. Os tipos de documento marcados como não indexáveis ficam de fora.

Manual: conversa, agentes e skills