Exemplos de como usar Kanera com IA

Depois que um agente de IA estiver conectado ao Kanera por meio MCP, ele poderá ver seu trabalho real em todos os níveis e agir de acordo com ele. Essa é a diferença entre um assistente que adivinha a partir do texto colado e outro que raciocina com base nos dados do espaço de trabalho em tempo real – cartões, responsáveis, datas de vencimento, rótulos, campos personalizados, notas, comentários e atividades.

Os exemplos abaixo são fluxos de trabalho reais. Cada um mostra o que perguntar, por que o agente pode fazer isso e o que você recebe em troca. A maioria só lê Kanera. Aqueles que mudam estão marcados (muda Kanera) e precisa de acesso de gravação: uma conexão OAuth onde você é um editor no quadro ou uma chave de API com escopo de gravação.

Rastreie bloqueadores e transferências

Experimente estas solicitações com um agente conectado:

• "Faça com que as mensagens do produto final bloqueiem a cópia da página de destino. Relacione a cópia à revisão jurídica opcional sem torná-la um pré-requisito."
• “Mostre os cartões bloqueados no espaço de trabalho de Marketing e explique os bloqueadores e proprietários que posso ver.”
• "Observe a quadro de lançamento. Quando um cartão for desbloqueado, leia seus detalhes atuais e diga-me quem pode retirá-lo em seguida."

Para explicar cadeias inteiras, o agente usa cards.dependency_graph com um escopo de quadro, quadro ou espaço de trabalho. Também pode usar cards.set_relations, work.query_cards com blockedOnlye card.blocked / card.unblocked assinaturas de eventos. Uma corrida marcada como bloqueada é separada dessas relações de cartão. Veja Relacionamentos e bloqueios de cartões.

Revise um cronograma e proponha um reagendamento

"Revise o cronograma do quadro de lançamento. Quando a cadeia crítica está projetada para terminar, o que não tem folga e quais cartas começam antes de seus bloqueadores terminarem? Mostre as datas e o impacto no dia útil. Não mude nada."

O agente resolve o tabuleiro com boards.list_accessible, então chama work.schedule com exatamente um escopo:

{ "boardId": "<board UUID>" }

Usar { "workspaceId": "<workspace UUID>" } em vez disso, agendar o espaço de trabalho juntos. Não passe em ambos. Uma programação de quadro segue cadeias conectadas acessíveis em outros quadros. O Guia da linha do tempo explica a visão humana do mesmo cálculo.

Leia summary.projectedFinish, summary.latestDuee summary.slipDays para a previsão e seu atraso em relação à última data prometida. Por cartão, plannedStart / plannedEnd descrever o plano armazenado; earliestStart / earliestFinish levar em conta os pré-requisitos, slackDays mede espaço para escorregar, critical marca o trabalho conectado sem folga e conflicts identifica pré-requisitos planejados para terminar tarde demais. Dias significam dias úteis de segunda a sexta; cartões preenchidos são excluídos. Os cartões que a conexão não pode abrir também são excluídos, portanto descreva a previsão como o plano acessível.

Por exemplo, se um pré-requisito terminar na sexta-feira e seu dependente estiver planejado para começar nessa sexta-feira, a primeira transferência limpa será na segunda-feira: um dia útil depois. cards.dependency_graph explica quem bloqueia quem; usar work.schedule para as datas reais e folga da programação.

“Proponha datas para que o MKT-42 comece na próxima segunda-feira e termine na sexta-feira. Explique quais dependentes precisariam se mudar. Mostre a proposta antes de aplicá-la.”

Não há nenhum parâmetro de entrada hipotético em work.schedule. Leia o cronograma atual, raciocine a partir de suas durações e links e rotule os impactos propostos como estimativas. Não altere as datas salvas apenas para simular uma resposta. Quando o usuário aprovar uma alteração, releia o cartão com cards.get, então use cards.update:

{
  "cardId": "MKT-42",
  "changes": {
    "startDateLocalDate": "2026-11-02",
    "dueDateLocalDate": "2026-11-06"
  }
}

Essas datas ilustram de segunda a sexta; resolver frases relativas usando a zona do usuário de session.get e repita as datas escolhidas. Frases de data de início também são suportadas. Leia work.schedule novamente depois de salvar para relatar o resultado real. As datas dos sucessores não mudam automaticamente. A aplicação deste exemplo altera o Kanera e requer acesso de gravação.

Observe a integridade do cronograma

"Assista ao quadro de lançamento. Diga-me quando o primeiro conflito de agendamento aparece, quando ele é resolvido ou quando uma alteração de data do caminho crítico empurra o término projetado para mais tarde. Leia a programação antes de relatar, mostre os links dos cartões afetados e deixe as datas inalteradas."

Um host compatível assina separadamente schedule.conflict_detected, **schedule.conflict_resolved**e schedule.critical_path_slipped, com escopo definido para o quadro e seu espaço de trabalho. Comece com um work.schedule leia para que os problemas existentes sejam incluídos; os eventos anunciam mudanças após uma linha de base, não um replay. Leia o cronograma em cada ocorrência, ignore as gravações da própria conexão quando apropriado e desduplique as repetidas eventId valores. Veja Inscreva-se em eventos para cargas úteis, atualização e limites de entrega.

Para uma revisão matinal, peça “meus conflitos de agendamento, trabalhos críticos e cartões que perderam o início planejado”. work.my_day retorna estes em schedule.conflicts, schedule.criticale schedule.lateToStart ao lado de urgência e Próximo. Para uma revisão entre projetos, work.portfolio_summary retorna o rollup suportado com por quadro conflictCount, criticalCount, projectedFinish, latestDuee slipDays; perfure as quadros afetadas com work.schedule.

Se a linha do tempo ou as dependências estiverem desativadas, o agente reportará TIMELINE_DISABLED ou DEPENDENCIES_DISABLED e pede ao administrador relevante para ativar o recurso quando necessário. Deve continuar com o trabalho disponível em vez de tentar novamente a operação recusada.

Coloque o trabalho de hoje em ordem

"Mostre minha próxima fila, mova o cartão de liberação de pagamentos para o topo e coloque a revisão da documentação imediatamente após." (muda Kanera)

O agente lê primeiro as entradas classificadas atuais, resolve as cartas solicitadas e usa âncoras de entrada para fazer o movimento exato. Ele altera a ordem de serviço sem alterar datas de vencimento, listas de fluxo de trabalho ou um campo personalizado de Prioridade. Peça-lhe que mostre a ordem proposta antes de aplicar uma remodelação mais ampla.

Planeje o trabalho e acompanhe-o conforme o código chega

Este é o fluxo de trabalho que mostra o que o MCP realmente desbloqueia: um agente de codificação que planeja no Kanera e depois atualiza o mesmo cartão enquanto faz o trabalho real. Como o editor do agente e o Kanera podem ser acessados ​​por meio do MCP, o cartão de rastreamento permanece preciso por si só: ninguém troca de aba para marcar caixas.

Passo 1 – planeje no cartão. Aponte o agente para o trabalho e peça para ele registrar o plano onde a equipe possa vê-lo:

"Leia este repositório e o cartão 'Atualizar dependências'. Escreva um plano de implementação na descrição do cartão e adicione uma lista de verificação com um item por projeto que precisa ser atualizado." (muda Kanera)

O agente inspeciona a base de código, elabora um plano, atualiza a descrição do cartão com ele e cria um item da lista de verificação por projeto. Agora, o cartão é a fonte da verdade do esforço, não uma conversa descartável.

Passo 2 – faça o trabalho e deixe o agente fechar sua própria lista de verificação. Na mesma sessão (ou posterior), faça com que o agente implemente a mudança nos projetos:

"Trabalhe na lista de verificação desse cartão. Atualize as dependências em cada projeto e, à medida que cada um for criado e aprovado, marque o item da lista de verificação como concluído." (muda Kanera)

À medida que o agente termina cada projeto, ele marca o item correspondente no cartão de acompanhamento. Qualquer pessoa que observe o quadro verá o progresso real em tempo real – a lista de verificação é preenchida à medida que o código é realmente enviado, não quando alguém se lembra de atualizá-lo. Cada check-off é registrado como o agente agindo em seu nome, com um via <agente> crachá, para que o cartão funcione como uma trilha de auditoria do que o agente fez e quando.

Esse ciclo de “planejar no cartão e depois relatar o progresso de volta ao cartão” funciona para qualquer esforço de várias etapas – atualizações de dependências, migrações, refatorações ou um recurso dividido em tarefas.

Deixe o quadro mostrar que o agente está trabalhando

Um trabalho longo fica invisível até terminar, e é assim que duas pessoas acabam fazendo o mesmo trabalho. Em vez disso, um agente pode se anunciar no cartão:

"Antes de começar PLAT-42, abra um agente executado nele e mantenha-o atualizado conforme você avança. Marque-o como bloqueado se precisar de uma decisão minha." (muda Kanera)

O agente liga runs.start com um título curto, e o bloco do cartão mostra imediatamente um chip ativo nomeando o agente e o trabalho. A partir de então runs.update é o relatório de progresso e a pulsação:

1. runs.start — { cardId: "PLAT-42", title: "Implementing OAuth refresh", }. A ficha aparece no bloco e a corrida ao vivo aparece abaixo da descrição da carta.
2. Trabalhe e continue reportando. runs.update com { runId, summary: "Refresh rotation done; wiring the retry path." }. Cada chamada é um batimento cardíaco, então envie uma pelo menos a cada dez minutos em um trabalho longo – mesmo que seja vazio.
3. runs.update com status: "blocked" quando precisar de você. O chip fica âmbar e o resumo diz o que está esperando, então a pergunta fica no cartão, e não enterrada em um registro de bate-papo.
4. runs.update com status: "succeeded" (ou failed, ou cancelled) para fechá-lo. O chip é limpo, a corrida permanece no histórico do cartão e o resultado é registrado no feed de atividades.

Peça runs.list primeiro quando vários agentes compartilham um tabuleiro: mostra o que já está em voo para que dois deles não iniciem o mesmo cartão. Se um agente travar no meio da corrida, Kanera marcará a corrida paralisada após quinze minutos, em vez de deixar o cartão parecendo ocupado para sempre.

Reaja quando algo mudar, sem ser solicitado

Os prompts acima são executados quando você os digita. Um cliente que suporta Assinaturas de eventos MCP, como ChatGPT, também pode continuar observando e agir no momento em que um cartão é criado, alterado, movido ou comentado, ou quando sua próxima fila muda. Kanera entrega o troco ao cliente; o cliente executa a tarefa que você descreveu. Nada está configurado no Kanera e o encerramento da tarefa encerra a assinatura.

Responda às perguntas em um cartão enquanto estiver fora.

"Assista ao quadro de lançamento. Quando um novo comentário fizer uma pergunta, leia o cartão e seu tópico e responda com a resposta se estiver no cartão ou nas notas vinculadas. Se não for, responda que irei acompanhar e me diga." (muda Kanera)

Cada novo comentário chega como um evento com o texto do comentário e o cartão. O agente lê o thread completo com comments.list antes de responder, por isso nunca responde a partir de um resumo de uma linha. Como cada evento diz quem fez a alteração e se o próprio agente a fez, uma tarefa como esta verifica actor.self e pula suas próprias respostas em vez de responder a si mesmo.

Mantenha um canal de partes interessadas atualizado.

"Avise-me sempre que um cartão for colocado na lista Concluído no quadro Móvel, com um resumo de uma linha do que foi enviado."

O evento move carrega a lista de destinos, para que o agente possa filtrar por Concluído e ler apenas os cartões que chegarem até ele. Combine isso com um destino de bate-papo ou deixe o cliente postar o resumo onde as partes interessadas leem.

Faça a triagem do novo trabalho assim que ele chegar.

"Assista à lista de admissão no quadro de suporte. Para cada novo cartão, sugira um rótulo de prioridade e um proprietário com base na descrição e em cartões anteriores semelhantes, e deixe a sugestão como comentário. Não troque o cartão." (muda Kanera: apenas o comentário)

Um card.created o evento é acionado assim que o cartão existe. O agente lê com cards.get, procura cartões semelhantes e comenta sua sugestão para uma pessoa aceitar. A decisão permanece humana; a pesquisa é feita antes que alguém abra o cartão.

Proteja um cartão crítico.

"Assistir PLAT-42. Se alguma coisa mudar, incluindo comentários, envie-me uma breve nota dizendo o que mudou e quem mudou."

Assine um cartão quando um cartão de liberação, contrato ou incidente não puder ser alterado silenciosamente. O evento nomeia o ator, então a nota diz se foi um colega de equipe, uma automação ou outro agente.

Saiba quando suas prioridades mudam.

"Sempre que minha fila Próximos for alterada porque alguém a reordenou, diga-me o que foi movido e o que está agora no topo."

Um priorities.changed O evento é acionado quando sua fila ganha, perde ou reordena uma entrada, inclusive quando um cartão na fila é concluído ou reatribuído. Não carrega cartões, então o agente lê a fila com priorities.list, compara-o com a ordem vista da última vez e ignora as alterações onde actor.self é verdade ou actor.userId é você. Somente sua própria fila pode ser assistida.

Obtenha um briefing matinal.

"Todos os dias da semana pela manhã, diga-me o que está atrasado, o que está vencido esta semana e o que está no topo da minha próxima fila."

Um my_day.ready O evento chega às 8h nos dias de semana em seu fuso horário, enquanto seu e-mail de resumo diário está ativado. O agente responde com um work.my_day chamada, que retorna cartões vencidos, com vencimento esta semana, lista de verificação vencida e cartões atribuídos ociosos, além do chefe da próxima fila.

Dois hábitos tornam essas tarefas confiáveis: pedir ao agente para leia o cartão antes de escrever, uma vez que os eventos são resumos, e para usar chaves de idempotência para gravações repetíveis, já que a mesma alteração pode chegar mais de uma vez. A entrega é feita com o melhor esforço em alguns minutos; se o cliente estiver inacessível por mais tempo, a tarefa deverá se recuperar lendo o estado atual em vez de esperar uma repetição.

Triagem matinal em um único prompt

"Mostre-me tudo o que foi atribuído a mim no espaço de trabalho, agrupado por urgência. Sinalize qualquer coisa atrasada, qualquer coisa sem data de vencimento e qualquer coisa que não tenha sido movida em uma semana."

Para um início rápido, work.my_day retorna trabalhos vencidos, com vencimento nesta semana, lista de verificação vencida e ocioso, além de sua próxima fila em uma chamada. Para agrupamentos personalizados, a consulta de trabalho limitada extrai toda a fila do espaço de trabalho de uma só vez. Ele pode filtrar por data de vencimento, estado de atraso, inatividade e último movimento e, em seguida, revelar as duas ou três coisas que precisam de você hoje. No aplicativo, Home e My Cards fornecem versões humanas desse fluxo de trabalho.

Atualização instantânea de stand-up

"Prepare meu stand-up: o que fechei ontem, o que estou trabalhando hoje e tudo o que está bloqueado."

O agente lê as atividades recentes e os cartões atribuídos e, em seguida, elabora uma atualização detalhada. Cole-o no Slack ou leia-o. O embutido prepare_standup_update prompt faz exatamente isso se o seu cliente exibir prompts.

Revisão do quadro para um gerente

"Resuma o quadro do roteiro. Identifique bloqueadores, cartas obsoletas, cartas sem dono e o que provavelmente escapará deste sprint."

Um agente com acesso de leitura do quadro pode combinar metadados do quadro, páginas limitadas de cartões, filtros de trabalho obsoletos e históricos de cartões selecionados para revisar um quadro da mesma forma que um lead faria – não apenas listando cartões, mas raciocinando sobre o risco. Ótimo antes de uma reunião de planejamento.

Transforme uma reunião em cartões

"Aqui estão minhas anotações da ligação do cliente. Rascunhos de cartões para cada item de ação com um título, uma descrição do Markdown e uma lista de sugestões. Mostre-me os rascunhos primeiro - não crie nada ainda."

O agente propõe cartões estruturados. Você revisa, edita e diz:

"Crie aqueles na lista de entrada e rotule-os customer-request." (muda Kanera)

Esse padrão de “elaborar, revisar, aplicar” é a maneira mais segura de permitir que um agente crie trabalho: você sempre vê o plano antes de qualquer coisa chegar ao Kanera.

Depois de aprovado, o agente cria o plano completo em uma chamada, com etiquetas, destinatários e data de vencimento de cada cartão já definidos, e verifica cada cartão primeiro para que um nome de etiqueta ou colega de equipe errado interrompa o lote antes que qualquer coisa chegue. Os cartões criados pelo seu agente são monitorados por você automaticamente, então as respostas a eles chegam às suas notificações, marcadas via <agente>.

Receba respostas enquanto o agente trabalha

"Publique o plano de migração no DEV-938, peça a @Priya para assinar e continue verificando a resposta dela enquanto inicia os testes." (muda Kanera)

O agente menciona Priya em seu comentário, que a notifica por caixa de entrada, e-mail e push. Um agente em execução na sua máquina não tem um endereço que Kanera possa retornar, portanto, ele verifica suas notificações a cada poucos minutos com notifications.list, vendo apenas o que há de novo desde a última vez que olhou e nenhum dos seus próprios escreve. Quando Priya responde, lê o comentário e segue em frente.

Capture um lembrete sem escolher um quadro

"Lembre-me de renovar o seguro do local na próxima semana." (muda Kanera)

Quando você não nomeia nenhum quadro, o agente adiciona o item como uma tarefa aberta no Caixa de entrada página do seu privado Bloco de rascunho em vez de perguntar para onde deveria ir. Mais tarde, pergunte "o que está na minha caixa de entrada?" para lê-lo novamente ou "marque o seguro" para verificá-lo. Nomeie um tabuleiro quando o item pertencer à equipe e o agente cria um cartão lá.

As datas funcionam da maneira que você as diz. "Fazer MKT-42 com vencimento amanhã às 13h" define amanhã em seu próprio fuso horário com o horário de vencimento da tarde, e o agente informa a data usada.

Volte para um cartão na hora certa

"Lembre-me do MKT-42 na sexta-feira às 15h." (muda Kanera)

Quando você nomeia um cartão que já existe, o agente define uma conta privada lembrete nele em vez de criar uma tarefa. Ele informa a hora exata em que foi resolvido, em seu próprio fuso horário, e Kanera notifica você uma vez quando chegar o prazo, através dos canais que você escolheu para Lembretes do seu cartão. Os lembretes chegam com até oito semanas de antecedência. Pergunte "quais lembretes eu tenho?" para listá-los ou "limpar meu lembrete no MKT-42" para remover um. Em vez disso, "Watch MKT-42" segue a atividade do cartão.

Anexe evidências de uma sessão de codificação

"Anexe a captura de tela da página de login com falha e o log de teste ao DEV-938 e, em seguida, resuma o que o log diz que falhou." (muda Kanera)

Um agente trabalhando em sua máquina recebe um link de upload único para cada arquivo e o carrega com curl, para que capturas de tela e registros longos nunca passem pelo chat. Ele pode então ler o log do cartão com cards.get_attachmente veja as capturas de tela anexadas para responder a perguntas sobre elas.

Pesquisa cruzada que entende o contexto

“Encontre todos os cartões, notas ou comentários que mencionem a migração de pagamentos e diga-me quais ainda estão abertos.”

A pesquisa MCP abrange cartões, notas, comentários e nomes de arquivos anexos em todo o espaço de trabalho. O agente não apenas retorna correspondências — ele as agrupa, informa o que foi feito e o que está aberto e aponta os threads que importam.

Limpeza e higiene

"Liste os cartões atribuídos neste espaço de trabalho sem data de vencimento e sem rótulos e sugira um rótulo de prioridade e uma data de vencimento realista para cada um com base na descrição." (as sugestões são somente leitura; aplicá-las altera Kanera)

O agente propõe metadados para que seu quadro permaneça reportável. Aprove o lote e ele poderá definir rótulos, datas de vencimento e valores de campos personalizados em uma única passagem.

Mantenha um cartão atualizado sobre uma discussão externa

"Adicione um comentário ao cartão 'lançamento de SSO' resumindo este tópico de e-mail e mova-o para Em andamento." (muda Kanera)

O agente escreve um comentário resumido conciso e atualiza a lista do cartão, para que o quadro reflita a realidade sem que ninguém digite novamente o status manualmente. Cada mudança traz consigo um via <agente> crachá na atividade do cartão, para que ele permaneça auditável.

Se você conhece a chave do cartão, use-a diretamente: "Adicione este resumo ao PLAT-42 e marque-o como completo." Chaves atuais, chaves históricas exatas e links canônicos de cartão Kanera podem ser usados como referências de cartão MCP. Um link canônico desambigua o caso raro em que a mesma chave é visível em mais de uma organização.

Divida uma lista ocupada em seções

"Na lista de pendências do quadro Roadmap, adicione separadores azuis intitulados 'Próximo lançamento' e 'Mais tarde'. Coloque 'Próximo lançamento' antes do PLAT-42, coloque 'Mais tarde' após o separador de pesquisa existente e mova PLAT-57 imediatamente abaixo de 'Próximo lançamento'." (muda Kanera)

O agente lê as cartas e separadores atuais do tabuleiro, resolve as âncoras solicitadas e cria ou move cada separador de primeira classe para uma posição exata. Cartões e separadores compartilham uma linha de pedido, de modo que o agente também pode posicionar um cartão em relação a um separador. As divisórias permanecem específicas do quadro mesmo quando a lista de fluxo de trabalho é compartilhada com outros quadros.

Balanceamento de carga de trabalho em uma equipe

"Neste espaço de trabalho, mostre o trabalho atribuído aberto por pessoa. Quem está sobrecarregado, quem tem espaço e quais cartões poderiam ser movidos de maneira razoável?"

A consulta de trabalho em equipe limitada retorna trabalhos visíveis atribuídos, não atribuídos, vencidos e obsoletos em todo o escopo selecionado. O agente pode raciocinar sobre a carga de toda a equipe e propor o rebalanceamento — depois, com sua aprovação, reatribuir cartões específicos. (reatribuindo alterações Kanera)

Rollups entre quadros para um agente

"Dê-me um resumo da entrega para esta organização. Mostre o trabalho ativo, atrasado, com vencimento em breve, não atribuído e concluído recentemente por espaço de trabalho e quadro e, em seguida, indique as áreas que precisam de atenção."

work.portfolio_summary retorna diretamente a organização limitada, o espaço de trabalho e os rollups do quadro. O agente lê primeiro os agregados e depois inspeciona apenas os tabuleiros ou cartões que necessitam de detalhes de apoio. O rollup está disponível por meio do MCP, a API pública, kanera portfolioe kanera.work.portfolio() no SDK. Não requer uma página da web do portfólio.

Rascunho de uma nota que você já escreveu

"Transforme minha nota de 'reformulação da integração do terceiro trimestre' em um cartão com um título claro e uma descrição Markdown que descreve as etapas como uma lista de verificação."

O draft_card_from_notes O prompt transforma o pensamento solto em uma nota de Kanera em um trabalho estruturado e acionável.

Dicas para aproveitar ao máximo

• Mantenha as credenciais autônomas restritas. Use um Leia Chave de API ou conexão de serviço para triagem, resumos e pesquisa quando a automação nunca deve fazer alterações. O OAuth pessoal é compatível com leitura/gravação, portanto, configure as permissões e confirmações da ferramenta no cliente MCP.
• Peça um plano primeiro. Para qualquer coisa que altere Kanera, solicite rascunhos ou propostas de plano, revise-o e diga "aplicar".
• Seja específico sobre o escopo. Nomeie o quadro, a lista, o espaço de trabalho ou a pessoa para que o agente direcione os dados corretos.
• Deixe funcionar em todas as áreas. Os maiores ganhos vêm de questões que uma visão de quadro único não consegue responder: carga de trabalho, pesquisa entre projetos e status de entrega entre projetos.

Para configuração, chaves de API, escopos e a lista completa de recursos e ações que o agente pode usar, consulte Conecte Kanera ao seu agente de IA, o referência técnica, e o inventário de ferramentas.