Partilhar um agente de programação traz consigo um pequeno vocabulário. A maior parte das palavras é comum, razão pela qual são frequentemente usadas de forma vaga. Esta página clarifica o significado de cada uma no muti, num parágrafo por termo, para que qualquer definição possa ser citada isoladamente.
Sala de agentes
Uma sala de agentes é um espaço partilhado onde um agente de programação em execução na máquina de uma pessoa pode ser acedido por um pequeno grupo de pessoas da sua confiança. A sala guarda a conversa, a timeline de pedidos e as aprovações. O agente, a sua subscrição, os seus ficheiros e as suas credenciais permanecem na máquina do proprietário. Nada é partilhado por predefinição; a sala é o limite e nada passa de uma sala para outra. A versão detalhada está em O que é uma sala de agentes?
Agente
Um agente é um runtime como o Claude Code ou o Codex associado a um único diretório de trabalho numa máquina, com um handle, um avatar, um estado online, um modo de permissão e uma caixa de entrada. Uma máquina pode alojar vários agentes; um agente pode estar presente em várias salas. Os agentes recebem o nome da função que desempenham (api, site, notes) e não do modelo subjacente.
Proprietário
O proprietário é a pessoa em cuja máquina um agente é executado. O proprietário aprova pedidos de terceiros, define autorizações permanentes e é a única pessoa que pode autorizar um dos quatro tipos de ações perigosas ou responder a um prompt de credenciais. O proprietário não está sujeito a modos de permissão no seu próprio agente, mas as suas ações são registadas como as de qualquer outro utilizador.
Membro
Um membro é uma pessoa presente numa sala que não é o seu proprietário. Os membros enviam pedidos, visualizam a timeline e recebem resultados. O que um membro pode executar é determinado por aprovações e autorizações permanentes, nunca pelo simples facto de estar na sala.
Caixa de entrada
A caixa de entrada é a fila por agente onde os pedidos aguardam enquanto a máquina está offline ou ocupada. Cada agente processa a sua caixa de entrada por ordem, um pedido de cada vez; agentes diferentes na mesma máquina correm em paralelo. O proprietário pode remover ou reordenar itens na fila.
Pedido
Um pedido é uma tarefa individual enviada a um agente. Tem um identificador público como R20260906-01 e um estado: pendente, aprovado, em execução, concluído, com falha, cancelado ou expirado. Um pedido pode ser cancelado, repetido ou retomado sob o mesmo identificador após uma interrupção.
Timeline
A timeline é o registo em tempo real e persistente de um pedido: mensagens, chamadas de ferramentas com resumos de argumentos, diffs de ficheiros com caminhos e contagem de linhas, comandos com códigos de saída e o final do output, artefactos (ficheiros, imagens, links), aprovações, takeovers e erros. É transmitida em direto para todos os presentes na sala e fica lá guardada para consulta posterior.
Modo de permissão
Um modo de permissão é o conjunto de regras do próprio agente sobre o que pode ser executado sem pedir autorização, herdado do runtime: no Claude Code, plan, default, acceptEdits e bypassPermissions. É configurado pelo proprietário para cada agente. Consulte Modos de permissão do Claude Code, explicados.
Autorização permanente
Uma autorização permanente é a decisão de um proprietário que permite a uma pessoa específica executar um agente específico numa determinada sala sem aprovação pedido a pedido. Pode ser revogada a qualquer altura; revogá-la cancela os pedidos que essa pessoa tenha em fila. Os quatro tipos de ações perigosas são sempre pausados, mesmo com uma autorização permanente ativa.
Aprovação
Uma aprovação é uma pausa na execução que aguarda que o proprietário aprove, rejeite ou continue em modo só de leitura, opcionalmente com uma nota que tem o mesmo peso do pedido. São pedidas aprovações para fazer push para um branch partilhado, eliminar dados, gastar dinheiro e aceder a credenciais, independentemente do nível de confiança, expirando ao fim de um período definido se não houver resposta. Consulte quatro ações sobre as quais um agente deve sempre perguntar antes de executar.
Takeover
Um takeover é a solicitação de intervenção humana feita por um agente durante uma execução. Takeovers relacionados com credenciais (inícios de sessão, códigos de autenticação de dois fatores, chaves) são encaminhados para o proprietário. Dúvidas sobre intenção («queria dizer staging?») são encaminhadas para quem fez o pedido. Ambas as partes acompanham a troca de mensagens na mesma timeline.
Pedir um agente emprestado
Pedir um agente emprestado significa utilizar o agente de outra pessoa, na máquina e com a subscrição dela, a partir do seu próprio contexto, sob uma autorização revogável. Quem pede emprestado recebe a utilização, a timeline e os resultados, nunca o acesso à conta, às credenciais ou aos ficheiros. Consulte Pedir um agente emprestado.
Daemon
O daemon é o processo ligeiro em segundo plano na máquina do proprietário que deteta runtimes instalados, faz polling ao serviço de salas através de uma ligação de saída, executa pedidos localmente e envia eventos para a timeline. Nunca envia ficheiros, variáveis de ambiente ou chaves, e não abre portas de rede. Instalado como serviço, inicia com a sessão e reinicia automaticamente se falhar.
Máquina
Uma máquina é um computador emparelhado com uma conta muti pelo seu proprietário. Nada é executado até que o proprietário aprove a máquina na aplicação web. As máquinas reportam os seus endereços locais e públicos para que um proprietário com vários equipamentos os consiga distinguir, podendo o acesso ser revogado em qualquer altura.
Artefacto
Um artefacto é um ficheiro, imagem ou link gerado por um agente durante um pedido. Os artefactos ficam disponíveis nos resultados da sala para download, incluindo imagens produzidas pelo agente fora do seu diretório de trabalho.
Se não encontrar aqui algum termo, a secção de FAQ na página principal aborda o funcionamento geral do produto, e cada artigo mencionado aprofunda um conceito em detalhe.
Publicado a · Atualizado a