Execuções e atribuição de agentes
Quando um agente de IA muda de trabalho em Kanera, o registro diz isso. Seus comentários, alterações de cartão e linhas de atividades são rotulados com o nome do agente e a pessoa para quem ele agiu, para que ninguém confunda a saída do agente com algo digitado por um colega de equipe. Enquanto um agente está trabalhando em um cartão, ele pode abrir um execução: um marcador vivo no cartão que informa ao resto da equipe que o trabalho já está sendo feito.
Como o trabalho do agente é atribuído
Kanera registra quem executou uma ação com base na credencial por trás dela.
| Conexão | Como aparece seu trabalho |
|---|---|
| OAuth, incluindo código do dispositivo | Como a pessoa que conectou o agente, com um via <agente> distintivo. O nome do agente é o nome com o qual o cliente de IA se registrou, como Claude. |
| Chave de API pessoal | Como proprietário da chave, sem rótulo de agente. Um script que você executa com sua própria chave é lido como você. |
| Agente autônomo ou chave API do espaço de trabalho/quadro | Sob o nome da conexão ou chave, não como pessoa. |
A distinção é a concessão interativa do OAuth, não o transporte. O Kanera CLI suporta ambos: login do navegador com kanera auth login --agent "Claude Code" rótulos funcionam através do agente, enquanto o login da chave de API a registra como o proprietário da chave ou a chave. Veja Trabalhe com agentes de codificação do terminal para saber como isso afeta um fluxo de trabalho de terminal.
O selo via
No feed de atividades de um cartão, um comentário escrito pelo agente mantém o nome e o avatar da pessoa e adiciona um via <agente> distintivo ao lado dele. Passe o mouse sobre o selo para ver quem escreveu o comentário e para quem, por exemplo Escrito por Claude em nome de Amelia Hart. Mudanças de cartão feitas por um agente possuem o mesmo crachá, com um Feito por… em nome de… dica de ferramenta.
O trabalho do agente ainda está sujeito à função da pessoa conectada. Kanera verifica seu acesso atual no quadro de destino para cada gravação, portanto, um agente não pode fazer nada que sua pessoa não possa fazer.
Execuções do agente
Uma execução é a sessão de trabalho de um agente em um cartão. É como um agente anuncia “Estou nisso” antes de iniciar o trabalho de várias etapas e como relata o progresso e o resultado.
Comece uma corrida
Um agente inicia uma execução com o runs.start Ferramenta MCP, fornecendo o cartão, um título curto para o trabalho e, opcionalmente, uma nota de progresso mais longa e um link onde uma pessoa pode acompanhar, como uma solicitação pull ou log de sessão. De um shell, a mesma ferramenta é kanera run start <card> "<title>", com kanera run update e kanera run done para relatar e terminar. As integrações podem usar POST /api/v1/cards/{cardId}/agent-runs no API pública.
Iniciar ou atualizar uma execução requer acesso de editor na quadro do cartão e uma credencial com capacidade de gravação. Uma chave somente leitura ou um Observador não podem abrir uma execução.
Antes de começar, um agente deve ligar runs.list para verificar se outro agente já está trabalhando no cartão, retomar sua própria execução ao vivo para a mesma tarefa ou relatar o conflito de execução ao vivo de outro agente antes de realizar trabalho sobreposto. Ele retorna execuções ao vivo por padrão ou o histórico completo de execuções do cartão com includeEnded.
O chip na peça do cartão
Enquanto uma corrida está ao vivo, o bloco da carta mostra um pequeno chip brilhante antes do título. Passe o mouse ou leia com um leitor de tela para ver o agente e o trabalho:
- Trabalhando: <agente> está trabalhando: <título>
- Esperando por uma pessoa: <agente> está esperando por você: <título>, e o chip fica âmbar.
Se mais de uma execução estiver ativa no cartão, o rótulo nomeia a primeira e adiciona (+N mais). O chip é atualizado em tempo real para todos que visualizam o tabuleiro e desaparece quando a corrida termina.
Executar estados
| Estado | Definido por | O que isso significa |
|---|---|---|
running | O agente | Trabalhando. Cada corrida começa aqui. |
blocked | O agente | Esperar por uma pessoa, como uma pergunta ou uma aprovação. O chip fica âmbar e os detalhes do cartão são exibidos Esperando por você. |
succeeded | O agente | Terminado. Termina a corrida. |
failed | O agente | Não foi possível concluir o trabalho. Termina a corrida. |
cancelled | O agente | Parou deliberadamente. Termina a corrida. |
stalled | Kanera | O agente parou de reportar. |
running e blocked estão ao vivo e mostram o chip. O agente se move entre eles e relata o progresso, com runs.update, mantendo o resumo em uma linha sobre o que está fazendo agora. succeeded, failede cancelled encerrar a execução permanentemente: uma execução finalizada não pode ser alterada e uma atualização adicional é rejeitada.
Definir uma corrida para blocked muda o chip. Ele não envia uma notificação a ninguém por si só. Caso o agente necessite de uma pessoa específica, deverá também deixar um comentário no cartão dizendo o que está esperando.
Corridas paralisadas
Cada runs.update a chamada conta como uma pulsação, incluindo aquela que não muda nada. Kanera verifica corridas silenciosas a cada minuto e marca uma corrida ao vivo stalled depois de quinze minutos sem batimento cardíaco. O runs.update ferramenta diz aos agentes para reportarem pelo menos a cada dez minutos.
Uma corrida paralisada não mostra mais o chip nem aparece no cartão Execuções do agente seção, para que um agente travado não possa deixar um cartão parecendo ocupado. O feed de atividades do cartão registra-o como Kanera marcando a execução do agente como paralisada. Porém, uma execução paralisada não é fechada: o agente pode voltar e finalizá-la com um status de terminal ou configurá-la para running para retomar.
O modelo de fluxo de trabalho do agente
Se você entregar a maior parte do trabalho de um quadro aos agentes, inicie o espaço de trabalho a partir do Fluxo de trabalho do agente modelo. Suas listas acompanham a vida de uma corrida, então o próprio quadro mostra o que os agentes estão fazendo:
| Lista | O que isso contém |
|---|---|
| Pendências | Trabalho pronto para entregar a um agente. |
| Agente trabalhando | Um agente tem um running corra no cartão. |
| Esperando por mim | O agente definiu sua execução como blocked e precisa de uma decisão sua. O resumo da execução diz o que é necessário. |
| Revisão | O trabalho está pronto para sua revisão. Verifique o resultado, geralmente uma solicitação pull no Solicitação pull campo. |
| Concluído | Você aceitou o trabalho. Kanera marca o cartão como completo. |
As corridas nunca movem ou completam cartas sozinhas. Os agentes registram a lista original antes de mover um cartão e, em seguida, releem o cartão e o tabuleiro antes da transferência. Eles consideram a lista original, as listas atualmente disponíveis e seus significados, o trabalho concluído e o trabalho restante e escolhem a lista que reflete o estado real do cartão no fluxo de trabalho daquele quadro. Voltar à lista original pode ser apropriado, mas não é automático. Os nomes e a ordem das listas não prescrevem um destino. Se a escolha não for clara, eles deixam a lista inalterada, salvam outras atualizações de rastreamento e perguntam.
Uma execução bem-sucedida pode cobrir apenas parte de uma carta. Os agentes completam o cartão somente quando o fluxo de trabalho acordado permitir e seus critérios forem atendidos; este modelo tem como padrão a aceitação humana. Antes da resposta final, eles publicam um comentário sobre o resultado com alterações, verificação, links, trabalho restante e o motivo do roteamento, encerram a execução adequadamente e verificam as atualizações salvas. As solicitações exploratórias e somente leitura não causam gravações de rastreamento e as restrições explícitas do usuário têm precedência.
O modelo também adiciona Recurso, Erro, Tarefae Pesquisa etiquetas e um cartão inicial que explica o fluxo. O agente de um administrador da organização pode criar o espaço de trabalho para você com workspaces.create e templateId: "agent-workflow".
Executa detalhes e atividades do cartão
Abra um cartão com uma corrida ao vivo e um Execuções do agente seção aparece diretamente abaixo da descrição. Cada execução mostra seu título, o agente, seu status (Trabalhando ou Esperando por você), quando foi relatado pela última vez e sua última nota de progresso.
Apenas corridas ao vivo aparecem nessa seção. Quando uma execução termina, ela desaparece e o resultado se torna uma linha no feed de atividades do cartão, como concluído: <título> — <resumo de fechamento>, ou falhou ou cancelado para os outros finais. O resumo final é a nota que o agente deixou quando encerrou a execução, portanto peça aos agentes que façam dele um registro útil do que aconteceu.
O início de uma execução é registrado, mas a alimentação do cartão não a repete; a seção ao vivo é onde o trabalho a bordo é exibido.
Notificações sobre o trabalho do agente
Kanera normalmente deixa você fora das notificações sobre suas próprias ações. O trabalho que seu agente realizou por meio do OAuth é a exceção: você é notificado sobre isso da mesma forma que seria sobre o trabalho de um colega de equipe em um cartão que você assiste ou ao qual está atribuído, porque delegar o trabalho não é o mesmo que observar isso acontecer.
Depois que um agente atua em seu nome, a gaveta de notificação ganha um Agente aba ao lado Não lido e Todos. Ele lista o que seus agentes fizeram, notificações não lidas e aquelas lidas nos últimos sete dias, e seu rótulo contém a contagem de não lidas, como Agente (1). Cada notificação traz o via <agente> distintivo. Quando você agrupa notificações por usuário, o trabalho do seu agente forma seu próprio grupo denominado <pessoa> via <agente> em vez de se fundir com o seu.
O início e o término de uma corrida são registrados na atividade do cartão, mas nunca enviam uma notificação. As notificações cobrem o que o agente realmente fez, como comentários, movimentações e conclusões.
Trabalho do agente em Trabalho realizado
O Trabalho concluído A visualização mantém a produção do agente separada do esforço das próprias pessoas. Uma linha produzida por um agente mostra uma marca brilhante ao lado da pessoa e sua dica de ferramenta diz Trabalhado por <person> via <agent>. A pilha de avatares do resumo do dia carrega a mesma marca.
As linhas de agente não são contadas como trabalho da própria pessoa. A filtragem do trabalho realizado por um membro mostra apenas as próprias ações dessa pessoa, portanto, a entrega de uma semana nunca conta silenciosamente a produção de um agente como as horas de alguém.
Encontrando atividade do agente
- Notificações: o Agente tab é a fila de revisão de tudo o que seus agentes fizeram.
- Um cartão: o feed de atividades do cartão mostra via <agente> emblemas e corridas finalizadas. Um agente pode ler o histórico completo de execução com
runs.listeincludeEnded. - Integrações: webhooks entregar
agentRun:startedeagentRun:updatedeventos para automações que reagem ao trabalho do agente.
Não há filtro em todo o quadro para a atividade do agente no feed de atividades ou no Trabalho realizado.