# IA: reuniões e textos em cards Transforme anotações, e-mails, relatos de bug e reuniões gravadas em cards prontos para o board. Você manda o conteúdo, a IA sugere cards (e, se quiser, uma página da wiki), e nada é criado sem a sua revisão. Este guia é para quem trabalha no projeto e para quem administra a conta: mostra como gerar, revisar e aceitar sugestões, quanto custa cada operação em créditos e como usar a sua própria chave de IA. > Versão em Markdown puro deste guia: [https://app.krakendock.com/docs/ai.md?lang=pt-BR](https://app.krakendock.com/docs/ai.md?lang=pt-BR). Use-a para colar num assistente de IA ou na documentação interna do seu time. ## Visão geral | Peça | O que faz | Onde | | ------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------- | | Texto → cards | a IA lê um texto e sugere cards | seção **IA** do projeto, aba **Texto** | | Reunião → cards e wiki | o KrakenDock transcreve a gravação e a IA sugere cards e uma página | seção **IA** do projeto, aba **Reunião gravada** | | Revisão | você edita, descarta e aceita cada sugestão | a página da solicitação | | Histórico de solicitações | tudo o que foi enviado à IA no projeto, com o resultado e o consumo | seção **IA** do projeto | | Créditos | o saldo de IA da conta e a compra de pacotes | **Plano e uso**, nas configurações da conta ou da organização | | Chaves de IA | a sua própria chave de IA, sem consumir créditos | **Chaves de IA**, nas configurações da conta ou da organização | O fluxo de uma solicitação: 1. Você envia um texto ou a gravação de uma reunião. 2. A IA analisa o conteúdo. Isso roda em segundo plano: pode sair da página, a solicitação fica no histórico. 3. As sugestões aparecem para revisão, com título, descrição, tipo, prioridade e estimativa. 4. Você ajusta o que precisar, escolhe o destino e aceita. Só então os cards (e a página da wiki) são criados. ## Gerar cards a partir de um texto ### Passo a passo 1. No projeto, abra a seção **IA**. Também dá para chegar lá pelo botão **Gerar com IA** do board, que já escolhe aquele board como destino, ou pelo menu **Criar** → **Gerar cards com IA**. 2. Na aba **Texto**, cole o conteúdo: notas de reunião, um e-mail de pedido, um relato de bug. Os botões de **Exemplos** preenchem o campo com um modelo de cada tipo. 3. Se quiser, escreva **Instruções para a IA (opcional)**, por exemplo: "escreva os cards como histórias de usuário e estime em pontos". 4. Marque **Gerar também um rascunho de página da wiki** se quiser uma página documentando o conteúdo. 5. Escolha o **Board de destino**. Dá para trocar depois, na revisão. 6. Clique em **Gerar sugestões**. Em alguns segundos, a página da solicitação mostra as sugestões. | Campo | Limite | | -------------------- | ------------------------- | | Texto | de 10 a 50.000 caracteres | | Instruções para a IA | até 2.000 caracteres | | Sugestões por pedido | até 30 cards | ### Dicas para um bom resultado - A IA cria um card para cada trabalho concreto e junta os repetidos. Ela não inventa trabalho que não está no texto. - Os cards saem no mesmo idioma do texto. - Os títulos vêm curtos e no imperativo. A descrição vem em Markdown, com critérios de aceite em checklist quando o texto permite. - O tipo segue o conteúdo: **Bug** para defeitos, **História** para funcionalidades que o usuário vê e **Tarefa** para o resto. - A prioridade segue a urgência descrita no texto (o padrão é **Média**). A estimativa, em pontos (1, 2, 3, 5, 8 ou 13), só aparece quando o esforço está claro. - As instruções orientam o foco e o formato, mas não mudam essas regras. Instruções escritas dentro do próprio texto são tratadas como conteúdo, não como ordens. ## Gerar cards a partir de uma reunião gravada ### Enviar a gravação 1. Na seção **IA**, abra a aba **Reunião gravada**. O menu **Criar** → **Enviar reunião** leva direto para ela. 2. Preencha o **Título da reunião** (de 2 a 200 caracteres) e o **Idioma falado**: Português (Brasil), Inglês ou Espanhol. 3. Arraste o arquivo ou clique para escolher. O KrakenDock lê a duração no navegador e mostra uma estimativa de créditos. 4. Clique em **Enviar e processar**. O arquivo vai direto do navegador para o armazenamento, com barra de progresso e o botão **Cancelar envio**. 5. A reunião passa pelas etapas **Recebida → Transcrevendo → Gerando sugestões → Em revisão**. A página se atualiza sozinha, e você pode sair e voltar depois. 6. Quando a reunião chegar em **Em revisão**, clique em **Ver sugestões**. A IA sempre gera, junto com os cards, um rascunho de página da wiki com resumo, participantes, decisões, itens de ação e perguntas em aberto. Você decide na revisão se ele vira página. As reuniões enviadas ficam na lista **Reuniões gravadas**, na mesma aba, com status, duração e data. ### Formatos e limites | Item | Aceito | | ------- | ------------------------------------ | | Áudio | MP3, M4A, AAC, WAV, WebM, OGG e Opus | | Vídeo | MP4 e WebM | | Tamanho | até 500 MB por arquivo | | Duração | até 2 horas | Se o navegador não conseguir ler a duração, o envio continua: o KrakenDock mede a duração real depois do upload e calcula o custo nessa hora. Gravações com mais de 2 horas são recusadas, mesmo que o navegador não tenha percebido antes. ### Transcrição - A transcrição identifica quem fala. Cada pessoa aparece como **Falante 1**, **Falante 2** e assim por diante. - Na página da reunião, a **Transcrição** fica disponível com os falantes e os horários. Use **Mostrar** e **Ocultar** para abrir e fechar. - Escolha o idioma certo em **Idioma falado**. Ele melhora bastante a qualidade da transcrição. - Se a gravação não tem fala (só música ou silêncio), o processamento falha com "Não detectamos fala no áudio." ## Revisar e aceitar as sugestões A página da solicitação mostra o que foi enviado, a **Análise da IA** (um resumo de como ela entendeu o conteúdo), as sugestões e, se pedido, o rascunho da wiki. ### Editar, descartar e restaurar - Clique numa sugestão para abrir os detalhes. Lá você edita o título, a **Descrição**, o **Tipo**, a **Prioridade** e a **Estimativa (pontos)**. As setas levam à sugestão anterior e à próxima. - **Descartar sugestão** tira a sugestão do aceite. **Restaurar** traz de volta. - Marque e desmarque as sugestões que vão ser aceitas agora. **Selecionar todas** e **Limpar seleção** ajudam com listas grandes. - As sugestões que você não aceitar continuam pendentes. Dá para voltar à solicitação e aceitá-las depois. ### Card pai e subtarefas Quando o conteúdo descreve claramente um trabalho maior e as suas partes, a IA sugere um card pai com subtarefas. A revisão mostra "Subtarefa de: …" em cada parte e a contagem de subtarefas em cada pai. - A IA só agrupa quando a relação está clara. Ela não divide trabalho só para criar subtarefas. - A hierarquia tem um nível só: uma subtarefa não tem subtarefas. - Se você descartar o pai, as subtarefas aparecem com o aviso "Será criada sem card pai" e viram cards comuns. ### Rascunho da wiki - Edite o **Título da página** e o **Conteúdo da página**, ou clique em **Descartar**. - No aceite, marque **Criar a página na wiki** e escolha a **Página pai na wiki** (ou **Raiz da wiki**). - Para criar só a página, descarte as sugestões de cards que você não quer e clique em **Criar só a página da wiki**. ### Onde os cards são criados No painel **Aceitar sugestões**: - **Board**: o board de destino. Vem preenchido com o escolhido na solicitação. - **Coluna**: por padrão, a **Primeira coluna (padrão)** do board. - **Sprint** (só em boards Scrum, para quem pode gerenciar sprints): sem sprint escolhida, os cards vão para o **Backlog (padrão)**. Clique em **Aceitar N cards**. Tudo é criado de uma vez: os cards pais primeiro e as subtarefas já ligadas a eles. Quando tudo estiver revisado, a solicitação fica **Concluída**. ## Histórico de solicitações A seção **IA** do projeto mostra o **Histórico de solicitações**: tudo o que foi enviado à IA no projeto, do mais novo para o mais antigo. Cada linha mostra: - a origem (**Texto** ou **Reunião**) e quem enviou; - o status: **Na fila**, **Processando**, **Aguardando revisão**, **Concluída** ou **Falhou**; - quantas sugestões vieram e quantas foram aceitas; - o consumo: tokens e créditos, ou **Chave própria** quando a operação usou a sua chave. Abra uma linha para voltar à revisão a qualquer momento. Uma solicitação de texto que falhou tem o botão **Tentar novamente**. Uma reunião que falhou é reprocessada pela página da reunião, no botão **Reprocessar**. ## Créditos de IA Os créditos medem o uso da IA com as chaves da plataforma. Com a sua própria chave (veja [Chave própria (BYOK)](#chave-propria-byok)), nada é consumido. Quem paga é a conta dona do projeto: num projeto pessoal, os créditos do dono do projeto; num projeto de organização, os da organização. Quem colabora num projeto de outra pessoa usa os créditos dela. ### Quanto custa cada operação | Operação | Custo | | -------------------------------------- | ------------------------------------------------------------------ | | Transcrever uma reunião | 1 crédito por minuto de áudio (cada minuto iniciado conta) | | Gerar sugestões (texto ou transcrição) | 1 crédito a cada 10 mil tokens processados, arredondando para cima | Uma reunião consome as duas coisas: a transcrição e a geração das sugestões a partir dela. Por exemplo, uma reunião de 30 minutos custa 30 créditos de transcrição, mais alguns créditos para gerar as sugestões. Um texto curto costuma custar 1 ou 2 créditos. ### Créditos por plano | Plano | Créditos por mês | | ------------------ | ---------------- | | Free (pessoal) | 30 | | Pro (pessoal) | 500 | | Free (organização) | 30 | | Pro (organização) | 2.000 | | Business | 10.000 | - Os créditos do plano renovam a cada período e não acumulam. - Num upgrade no meio do período, você recebe na hora a diferença de créditos do plano novo, proporcional ao tempo que falta. - Veja os planos em [https://app.krakendock.com/pricing](https://app.krakendock.com/pricing). ### Reserva e cobrança - Antes de cada operação, o KrakenDock reserva o custo estimado. Se o saldo não cobre, a operação nem começa. - Na reunião, a reserva usa a duração lida pelo navegador. Depois, o custo é calculado pela duração real. - Na geração, a reserva considera o tamanho do conteúdo e o tamanho máximo da resposta. Por isso, mesmo um texto curto precisa de pelo menos 2 créditos livres para começar. A cobrança final usa só os tokens realmente gastos, e a sobra da reserva volta ao saldo. - Se a operação falhar, a reserva é liberada. - Para usar os créditos da plataforma, você precisa ter o e-mail verificado. ### Comprar créditos Quando os créditos do plano não bastam, compre um pacote avulso, sem mudar de plano. 1. Abra **Plano e uso**: em Configurações, para a conta pessoal, ou em **Configurações da organização**. 2. Em **Créditos de IA** → **Comprar créditos**, escolha um pacote de 100, 500 ou 2.000 créditos e clique em **Comprar**. 3. Pague por PIX, boleto ou cartão de crédito na página de pagamento. Os créditos entram quando o pagamento é confirmado. - Os créditos dos pacotes valem por 12 meses após o pagamento. - O consumo segue esta ordem: primeiro os créditos do plano do mês, depois os pacotes, do que vence antes para o que vence depois. - Para comprar, preencha os **Dados de cobrança** e tenha o e-mail verificado. Numa organização, é preciso a permissão **Gerenciar cobrança**. - Os preços estão em [https://app.krakendock.com/pricing](https://app.krakendock.com/pricing). ### Acompanhar o consumo Em **Plano e uso**, você vê: - **Uso de créditos**: quantos créditos foram usados no período, os minutos de áudio transcritos, os tokens de IA e as operações com chave própria. Um aviso aparece quando restam menos de 10%. - **Créditos de IA**: os **Créditos do plano restantes**, o **Saldo de pacotes** e os créditos **Reservados** por operações em andamento. Cada solicitação também mostra o próprio consumo no [histórico](#historico-de-solicitacoes). ## Chave própria (BYOK) Com a sua própria chave de IA (BYOK, _bring your own key_), as operações usam a sua conta no provedor e não consomem créditos do KrakenDock. Funciona em qualquer plano. ### Configurar a chave 1. Abra **Chaves de IA**: - conta pessoal: Configurações → **Chaves de IA**; - organização: **Configurações da organização** → **Chaves de IA**. 2. Há uma chave para cada uso: **Modelo de linguagem** (gerar as sugestões) e **Transcrição de áudio** (transcrever reuniões). 3. Escolha o **Provedor**, confira o **Modelo** e cole a **Chave de API**. 4. Clique em **Salvar chave**. O KrakenDock pode pedir para você confirmar a sua identidade (senha ou código do autenticador). - A chave é guardada criptografada e nunca mais é exibida. A tela mostra só os 4 últimos caracteres. - **Substituir** troca a chave. **Remover** volta a usar os créditos do plano. - A chave não é testada ao salvar. Uma chave errada aparece na próxima solicitação, com a mensagem "A chave de IA configurada é inválida." - As chaves valem para todos os projetos da conta (pessoal ou organização). ### Provedores e modelos | Uso | Provedor | Modelo sugerido | | -------------------- | ------------- | ----------------------- | | Modelo de linguagem | Google Gemini | `gemini-3.5-flash-lite` | | Transcrição de áudio | Deepgram | `nova-3` | O campo **Modelo** aceita outro modelo do mesmo provedor, desde que a sua chave tenha acesso a ele. As duas chaves são independentes. Com só a chave de transcrição, uma reunião não consome créditos na transcrição, mas a geração das sugestões ainda consome. Para uma reunião não consumir nada, configure as duas. ## Permissões | Ação | Permissão necessária | | ----------------------------------------------- | ------------------------------------------------------------- | | Gerar cards a partir de texto | **Gerar com IA** (`ai:generate`) no projeto | | Enviar e reprocessar reuniões | **Enviar reuniões** (`meeting:upload`) no projeto | | Ver o histórico, as sugestões e as transcrições | ser membro do projeto | | Aceitar sugestões de cards | **Editar cards** (`card:write`) | | Colocar os cards numa sprint | **Gerenciar sprints** (`sprint:manage`) | | Criar a página da wiki | **Editar wiki** (`wiki:write`) | | Chaves de IA da conta pessoal | o dono da conta | | Chaves de IA da organização | **Gerenciar credenciais de IA** (`org:ai_credentials:manage`) | | Comprar créditos para a organização | **Gerenciar cobrança** (`org:billing:manage`) | - Os papéis de projeto **Admin** e **Write** já incluem **Gerar com IA** e **Enviar reuniões**. O papel **Read** não inclui. - A seção **IA** só aparece para quem tem uma dessas duas permissões. - Quem pode ver as sugestões mas não pode aceitá-las vê o aviso "Você pode ver as sugestões, mas não tem permissão para aceitá-las." ## Privacidade e retenção ### O que é enviado aos provedores - **Para o modelo de linguagem** (Google Gemini): o nome e a chave do projeto, o texto enviado ou a transcrição da reunião (com o título da reunião) e as instruções para a IA. - **Para a transcrição** (Deepgram): o arquivo de áudio ou vídeo e o idioma escolhido. - Nada mais do projeto vai para os provedores: outros cards, comentários, membros e a wiki ficam de fora. - Com a sua chave própria, o conteúdo vai para a sua conta no provedor, e vale o contrato que você tem com ele. ### Por quanto tempo os dados ficam | Dado | Retenção | | ------------------------------------ | ----------------------------------------------------- | | Gravação da reunião | apagada 7 dias depois do fim do processamento | | Envio não concluído | a reunião é removida depois de 24 horas sem o arquivo | | Transcrição | fica no projeto | | Texto enviado, sugestões e histórico | ficam no projeto | - Depois que a gravação é apagada, a reunião mostra "Gravação removida (retenção de 7 dias)". A transcrição continua lá. - Reuniões, transcrições, solicitações e consumo de créditos são visíveis só para os membros do projeto, mesmo num projeto público. ## Usar a IA pelo servidor MCP Outra forma de usar IA com o KrakenDock é conectar o seu assistente (Claude, por exemplo) ao servidor MCP. O assistente lê e cria cards, move cards entre colunas, gerencia sprints e escreve na wiki, com as permissões do seu token. Nesse caso, quem processa o texto é o modelo do seu assistente, e nenhum crédito do KrakenDock é consumido. Veja como configurar em [Servidor MCP](https://app.krakendock.com/docs/mcp). ## Solução de problemas | Mensagem | O que fazer | | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | | "Seus créditos de IA acabaram." | compre um pacote em **Plano e uso**, aguarde o próximo período ou configure uma [chave própria](#chave-propria-byok) | | "A chave de IA configurada é inválida." | substitua a chave em **Chaves de IA**, na conta ou na organização dona do projeto | | "O provedor de IA retornou um erro." ou "A IA retornou uma resposta inválida." | tente de novo (**Tentar novamente** na solicitação, **Reprocessar** na reunião) | | "A IA está indisponível no momento." | tente mais tarde | | "Não detectamos fala no áudio." | confira se o arquivo é a gravação certa e se tem som | | "O áudio excede o limite de 2 horas." | divida a gravação em partes menores | | "Formato não suportado." | converta para um dos [formatos aceitos](#formatos-e-limites) | | "O envio do arquivo não foi concluído." | envie a gravação de novo | | "A IA não encontrou trabalho acionável" | o texto não descreve tarefas. Escreva com mais detalhes ou use as instruções para orientar a IA | | A seção **IA** não aparece no projeto | peça a permissão **Gerar com IA** ou **Enviar reuniões** a quem administra o projeto | Uma reunião sem transcrição só pode ser reprocessada enquanto a gravação existe. Depois dos 7 dias, envie a gravação de novo. ## Perguntas frequentes ### A IA cria cards sozinha? Não. A IA só sugere. Os cards e a página da wiki só são criados quando alguém com permissão aceita as sugestões. ### Posso sair da página enquanto a IA trabalha? Sim. O processamento roda em segundo plano. A solicitação fica no [histórico](#historico-de-solicitacoes), e a página da reunião se atualiza sozinha quando você volta. ### Por que a reunião consumiu mais créditos do que a estimativa? A estimativa do envio cobre só a transcrição. A geração das sugestões a partir da transcrição é cobrada à parte, pelos tokens. Se o navegador não leu a duração, o custo da transcrição também só é conhecido depois do processamento. ### Os créditos que sobram passam para o mês seguinte? Os créditos do plano não acumulam. Os créditos de pacotes valem por 12 meses e continuam disponíveis até acabarem ou vencerem. ### Posso usar ChatGPT, Claude ou um modelo local? Hoje a geração usa o Google Gemini e a transcrição usa o Deepgram, com as chaves da plataforma ou com as suas. Para trabalhar com outro assistente de IA, conecte-o ao [servidor MCP](https://app.krakendock.com/docs/mcp). ### Em que idioma saem os cards? No idioma do conteúdo enviado. Uma reunião em espanhol gera cards em espanhol, mesmo num projeto em português. Para outro idioma, peça nas instruções. ### Quem vê o que eu mandei para a IA? Os membros do projeto. O texto enviado, as transcrições e o histórico nunca aparecem para visitantes, mesmo num projeto público. ## Veja também - [Primeiros passos](https://app.krakendock.com/docs/getting-started): crie a conta, o projeto e o primeiro board. - [Boards, cards e sprints](https://app.krakendock.com/docs/boards): o que fazer com os cards depois de aceitos. - [Servidor MCP](https://app.krakendock.com/docs/mcp): use o KrakenDock a partir do seu assistente de IA. - [Planos e preços](https://app.krakendock.com/pricing): créditos por plano e pacotes avulsos.