/agents), logo acima de Fluxos de trabalho. O título da página é
Agentes. A paleta de comandos (⌘ K) também oferece essa opção.
O que é um agente
Um agente combina cinco elementos, todos salvos juntos como uma revisão:
Um agente lê os próprios arquivos vinculados para todas as pessoas que o executam e, fora isso, apenas o que o membro em nome de quem ele é executado pode ver. Ele realiza apenas as ações selecionadas para ele. O Hive trata o texto da persona e da tarefa como não confiável, portanto nada nas instruções de um agente pode ampliar suas permissões ou adicionar uma ação.
Anexar arquivos como conhecimento
Na etapa 2 do editor de agentes, Conhecimento e ferramentas, a linha Arquivos lista os arquivos da Biblioteca que o agente lê (veja Como o editor está organizado). Para adicionar um:- Selecione + Adicionar arquivos e escolha arquivos que já estão na sua Biblioteca ou abra Enviar arquivos no mesmo seletor para enviar novos arquivos.
- Abra Google Drive, OneDrive ou SharePoint no mesmo seletor para adicionar um arquivo da sua própria conta conectada: pesquise seus arquivos do Drive e do OneDrive pelo nome, começando pelos que foram alterados mais recentemente, ou navegue por um site do SharePoint, suas bibliotecas de documentos e respectivas pastas. Veja Arquivos do Google Drive, OneDrive e SharePoint.
- Arraste arquivos do seu computador para a linha Arquivos ou para o campo de composição de Construir. Um contorno tracejado com Solte arquivos para adicioná-los a este agente mostra onde eles serão adicionados.
Arquivos do Google Drive, OneDrive e SharePoint
Um arquivo que você adiciona do Google Drive, OneDrive ou SharePoint é copiado para a sua Biblioteca e depois anexado como um arquivo enviado (Anexado · Salve para manter). O agente lê a cópia, nunca o arquivo original, então uma execução nunca espera pelo original nem falha por causa dele. Você precisa da função Operador ou superior, e a conta deve ser uma que você conectou pessoalmente em Integrações; se nenhuma estiver conectada, o seletor avisa. Na linha Arquivos, uma cópia informa de onde veio e quando o Hive a verificou pela última vez, por exemplo, Copiado do Google Drive · verificado há 2 h. Apenas a pessoa que a adicionou pode atualizá-la:- Selecione Atualizar no arquivo para verificar o original agora.
- Quando você abre o agente no Agent Studio, o Hive verifica suas cópias cuja última verificação ocorreu há mais de uma hora.
- Quando você implanta o agente, o Hive verifica suas cópias novamente.
Quem pode ler os arquivos de um agente
Os arquivos e as pastas anexados a um agente fazem parte dele. Quando você o compartilha, todas as pessoas que podem executá-lo têm acesso a esses arquivos ao executá-lo na página de execução, no Ask e em Continuar no chat, até mesmo aos arquivos que só você pode abrir na Biblioteca:- Nas execuções. O agente lê os arquivos anexados na página de execução, em um chat do Ask em que alguém o seleciona e em Continuar no chat. O Hive os lê com o acesso à Biblioteca de quem salvou a versão mais recente do agente.
- Imagens. Quando o modelo do agente lê imagens (um modelo de visão), uma imagem JPEG, PNG, GIF ou WebP anexada chega até ele como a própria imagem na página de execução, no Ask e em Testar no editor. Um modelo que não lê imagens recebe a descrição da imagem feita pelo Hive (consulte Como o Hive lê os arquivos que você escolhe).
- Nos chats. A pessoa que executa o agente pode abrir um arquivo usado por ele a partir desse chat, em modo somente leitura: selecione o nome do arquivo em Fontes. Um PDF ou uma imagem abre em uma nova aba; qualquer outro arquivo é baixado.
- Em nenhum outro lugar. Os arquivos não são adicionados à Biblioteca, à busca ou ao Drive de quem executa o agente, e essa pessoa não pode abri-los fora de um chat com o agente. Abrir o original no Google Drive, OneDrive ou SharePoint só funciona se esse serviço permitir.
- Remover um arquivo do agente e salvá-lo interrompe o acesso imediatamente: novas execuções não leem mais o arquivo, ele não abre mais nos chats do agente, e as respostas anteriores nos chats que o usaram ficam ocultas. O resultado de uma execução na página de execução continua visível para quem a executou.
- Se a pessoa que salvou a versão mais recente do agente sair do espaço de trabalho ou não puder mais abrir um dos arquivos, os arquivos do agente serão lidos apenas para quem puder abri-los na própria Biblioteca, até que alguém que possa abrir todos eles salve o agente novamente.
- Uma pessoa cujo acesso à Biblioteca esteja bloqueado pelo espaço de trabalho não pode usar os arquivos de um agente, como antes. Um cliente de IA conectado ao servidor MCP do Hive não pode executar agentes nem abrir seus chats, portanto nunca lê os arquivos de um agente dessa forma.
Onde os agentes são executados
Todo agente implantado fica disponível no Ask, na própria página de execução e em fluxos de trabalho. Você não escolhe onde ele aparece. O link público é separado: você o ativa em Link público no editor.Ask Hive
Escolha o agente no seletor de agentes do campo de mensagem do Ask, em vez do Hive padrão.
Página de execução própria
Preencha o formulário do agente, execute-o, leia a resposta e veja as execuções anteriores.
Agendamentos
Execute o agente em um agendamento recorrente com prompt e fuso horário fixos.
Fluxos de trabalho
Adicione um agente implantado a um fluxo de trabalho pela Biblioteca de agentes do construtor.
Links públicos
Compartilhe um agente fora do espaço de trabalho, se essa opção estiver ativada no seu espaço de trabalho.
O que um agente pode usar em cada local de execução
As habilidades obrigatórias do seu espaço de trabalho se somam às
instruções do agente em cada um desses locais, exceto em um link público.
Usar um agente em fluxos de trabalho
Implante o agente. As revisões implantadas passam a aparecer na Biblioteca de agentes do construtor de fluxos de trabalho, em Agentes no menu Adicionar etapa e no painel Adicionar uma etapa. Uma etapa de fluxo de trabalho fica vinculada à revisão usada ao adicioná-la; quando você implanta uma mais recente, a etapa oferece Atualizar para a revisão N. Uma etapa de fluxo de trabalho lê apenas arquivos e pastas da Biblioteca ou links do Google Docs como conhecimento e fontes de execução. Por isso, a Biblioteca de agentes desabilita e exibe em cinza um agente com outros tipos de conhecimento, habilidades, subagentes ou uma operação de conector que grava dados, ou com outras fontes, e informa o que alterar. O acesso à web, Dados da própria pessoa (incluindo dados do Hive) e aplicativos conectados somente para leitura funcionam em uma etapa: consulte Web, dados do Hive e aplicativos conectados. As ações selecionadas são executadas na etapa. Um agente criado antes de existirem etapas de fluxo de trabalho precisa ser recriado a partir de um modelo reutilizável. Consulte Etapas da Biblioteca de agentes.Executar um agente diretamente
Todo agente implantado tem sua própria página de execução em/agents/<agent id>/run. Abra-a com Executar no
menu ⋯ do cartão do agente ou com Executar este agente e ver suas execuções no painel Testar
do editor. Você pode usá-la se tiver a função Operador ou superior e acesso de execução ao agente: não é necessário
poder editar o agente, e a página nunca mostra suas versões em rascunho.
A página mostra o nome e a descrição do agente e, em seguida, seu formulário:
- Campos: as entradas solicitadas pelo agente.
- Fontes: os arquivos e pastas da Biblioteca, ou outras fontes, que o agente lê nesta execução. Quando uma fonte aceita arquivos da Biblioteca, você pode adicionar um arquivo que ainda não está na Biblioteca com Enviar para a Biblioteca no seletor; o Hive o seleciona para você após o envio. Você precisa da função Operador ou superior. Cada arquivo pode ter até 25 MB e deve ser de um tipo aceito pela Biblioteca. Ele vai para a raiz da sua Biblioteca e segue as regras de compartilhamento da Biblioteca, como qualquer outro envio.
- Contas: quais das suas contas conectadas o agente usa ao trabalhar com apps conectados.
- Instruções de execução (opcional): uma observação para esta execução.
- Perguntas iniciais de conversa: as perguntas iniciais do agente, listadas em Instruções de execução (opcional). Selecione uma para inseri-la nas instruções de execução; isso não inicia a execução.
Arquivos que uma execução grava na sua Biblioteca
Um agente com um modelo de arquivo do Word ou Excel pode gravar o documento ou a pasta de trabalho que promete, como uma carta de contratação ou uma proposta, como um novo arquivo na sua Biblioteca quando você o executa na página de execução dele:- Seu arquivo. O arquivo é seu, gravado em seu nome: no nível superior da sua Biblioteca ou em uma das pastas anexadas ao agente que seja privada para você e à qual você possa adicionar arquivos. Uma pasta compartilhada com qualquer outra pessoa e uma pasta da Base de conhecimento nunca são usadas, para que o que o agente leu para você nunca vá parar onde o autor do agente ou um colega possa abrir.
- No modelo do agente. Um arquivo do Word é gravado com base no modelo do Word do agente, e uma pasta de trabalho, no modelo do Excel dele, quando você pode abrir esse modelo. Um modelo privado é usado apenas para um arquivo que permaneça privado para você; caso contrário, o arquivo usa o design do seu espaço de trabalho. Em um dos modelos iniciais do Hive, o cabeçalho e o rodapé mostram o nome da sua empresa no lugar de “[Company name]” e “[Firm name]”: o nome no cadastro da sua empresa ou, na ausência dele, o nome do seu espaço de trabalho. Se o Hive não souber nenhum dos dois, os espaços reservados permanecem no arquivo para você preencher.
- Somente arquivos novos. Uma execução nunca altera, substitui, move ou exclui um arquivo que já esteja na sua Biblioteca. Ela grava no máximo três arquivos, cada um como rascunho para você revisar.
- No resultado. Cada arquivo é listado em Artefatos no resultado da execução, com a opção Abrir, que o abre na sua Biblioteca, e a resposta também inclui um link para ele.
- Com registro. Cada arquivo gravado por uma execução é registrado no registro de auditoria como “Execução de agente criou um arquivo na Biblioteca”, com o agente, a execução e o arquivo.
Histórico de execuções
Abaixo do formulário, Histórico de execuções lista as execuções do agente, das mais recentes para as mais antigas:- Você vê suas próprias execuções. Administradores do espaço de trabalho veem as execuções de todas as pessoas e podem filtrar por pessoa.
- Cada execução informa quem a iniciou: Você nas suas próprias execuções, o nome do membro nas de outra pessoa, ou Membro do espaço de trabalho para alguém que não está mais no espaço de trabalho. A lista Execuções recentes na página do agente no Agent Studio mostra o mesmo, em cada linha e em Iniciada por quando você abre uma execução.
- Filtre por status. Carregar mais mostra execuções mais antigas.
- A lista inclui execuções iniciadas nesta página, no Ask, por um agendamento, por um fluxo de trabalho e execuções antigas iniciadas com Executar agora.
- Cada execução tem seu próprio link, então uma notificação sobre uma execução a abre aqui.
- Uma execução interrompida por um limite aparece como bloqueada, com o motivo: o espaço de trabalho está sem créditos, o limite mensal de um membro ou do agente foi atingido, o espaço de trabalho está em modo somente leitura ou tem um pagamento em atraso, ou a política de modelos não permite o modelo do agente. Consulte Créditos e uso.
- A pergunta e o início da resposta aparecem apenas nas suas próprias execuções. Na execução de outra pessoa, um administrador vê quem a executou, quando, como ela foi iniciada e seu status, mas não a pergunta, a resposta, seus gráficos ou suas etapas. Isso se aplica à página de execução, ao histórico de execuções e às execuções recentes na página do agente. A resposta de um agente em um chat do Ask faz parte desse chat, então qualquer pessoa que possa abrir o chat a vê, inclusive um administrador que possa ler os chats dos membros.
- Uma execução cujo chat do Ask foi excluído fica em modo somente leitura: você pode abri-la e ler sua resposta, mas não continuá-la.
Explorar e organizar agentes
A lista mostra os agentes dos quais você é proprietário e os agentes compartilhados com você. Administradores também podem ver os agentes de todo o espaço de trabalho.- Ordenar por Mais populares, Atualizados recentemente ou A – Z.
- Cada cartão mostra quantas vezes o agente foi executado nos últimos 30 dias e quando foi a última execução. Todas as formas de execução contam: Executar agora, agendamentos e gatilhos, a página do próprio agente, Ask e etapas de fluxos de trabalho. Para você, são contabilizadas as execuções que você iniciou; para um administrador, as de todos. Mais populares usa essas mesmas execuções para ordenar.
- Cada cartão identifica o proprietário do agente: Você ou o membro que o criou. Um agente que o Hive configurou para você no seu espaço de trabalho (consulte Sugestões para seu espaço de trabalho) mostra Hive como proprietário, nunca o nome de uma pessoa.
- Filtrar por status: Em produção, Rascunho, Pausado ou Arquivado.
- Buscar agentes por nome e descrição. Fixe os que você mais usa para que apareçam em Agentes fixados.
- Importar agente importa um agente exportado como um novo rascunho. Explorar modelos permite começar com um agente pronto criado pelo Hive (consulte Modelos do Hive). + Criar agente abre o construtor, onde você pode digitar ou ditar o que o agente deve fazer (consulte Iniciar um novo agente).
- Quando uma aba ainda não tem agentes, ela informa isso e oferece Criar agente se sua função permitir criar um. Se uma busca ou um filtro não encontrar nada, a mensagem pede que você limpe a busca ou o filtro.
Ações rápidas em um cartão de agente
Cada cartão de agente tem um menu ⋯, para você realizar ações no agente sem abri-lo:Status dos agentes
Quem pode fazer o quê
O Agent Studio segue as funções do seu espaço de trabalho (consulte Funções e permissões):- Criar um agente: Líder de departamento, Administrador ou Proprietário. As demais pessoas veem “Somente um líder, administrador ou proprietário pode criar agentes.” No Starter, um espaço de trabalho pode ter 3 agentes não arquivados, contando os de todos os membros; no Team e nos planos superiores, não há limite fixo. Ao atingir o limite, a criação ou cópia de mais um agente é recusada, e um espaço de trabalho acima do limite do plano (após uma mudança para um plano inferior, por exemplo) não pode implantar um agente até arquivar alguns.
- Executar um agente: Operador ou superior, com acesso de execução a esse agente.
- Excluir um agente: Líder de departamento ou superior.
- Gerenciar configurações de agentes do espaço de trabalho: Administrador ou superior.
- Compartilhar: um agente é privado para seu proprietário até que ele o compartilhe com colaboradores específicos. Compartilhar um agente nunca compartilha as contas conectadas do proprietário. Isso permite, porém, que todas as pessoas que podem executá-lo usem os arquivos anexados ao agente ao executá-lo na página de execução, no Ask e em Continuar no chat, e abram esses arquivos nos chats do agente, sem adicioná-los à própria Biblioteca: consulte Quem pode ler os arquivos de um agente. O nome e o ícone do agente continuam aparecendo nas respostas que ele deu em um chat do Ask, para todas as pessoas com quem o chat é compartilhado; consulte Usar um agente no Ask.
Segurança integrada
As ações de um agente seguem estas regras:- As ações selecionadas seguem o nível da conta. Uma ação selecionada do agente é executada a partir da conta do próprio membro, e o nível dessa conta — respeitando qualquer limite do espaço de trabalho — determina o comportamento: em Agir, ela é executada imediatamente; em Criar rascunho, aguarda em um cartão de aprovação; em Ler, nenhuma ação é realizada, e a resposta informa isso. Isso vale independentemente de como a execução foi iniciada: por um membro, um agendamento, um evento de app ou um sinal. Consulte O que agentes e fluxos de trabalho fazem por conta própria.
- Para onde uma ação envia. Uma ação cujo destinatário, canal, número de telefone ou link não tenha vindo das instruções do agente ou do que o membro digitou no Hive para aquela execução, como um endereço que o agente encontrou em um e-mail que leu, aguarda a aprovação desse membro em um cartão em vez de ser executada: no chat ou em Revisar decisão na página Sinais do membro. A entrada salva de um agendamento não conta como palavras da própria pessoa. Escreva você mesmo nas instruções os endereços, canais e links que o agente pode usar: Descrever e o chat de Criar nunca adicionam um que você não tenha salvo ou digitado na sua descrição e, em vez disso, informam isso (consulte Criar um agente). Consulte Para onde uma ação envia.
- Ações ativadas ou desativadas. Defina O que pode fazer como Apenas lê e responde em Avançado na etapa 3, Entradas e saída, e o agente não realizará nenhuma ação.
- Apenas ações selecionadas. Um agente realiza apenas as ações selecionadas para seus apps anexados. O Hive recusa qualquer outra ação antes que ela chegue a uma conta. Um agente configurado antes da seleção de ações por app não realiza nenhuma até que você as selecione.
- Ferramentas MCP para todas as pessoas que executam o agente. Uma ferramenta MCP selecionada é executada na conexão da própria pessoa que inicia a execução com o mesmo servidor. Quem não tem uma conexão recebe uma orientação para conectar o servidor (ou, quando o Hive não conseguiu carregar suas ferramentas, uma mensagem informando isso); quem tem duas conexões com ele recebe uma orientação para desconectar uma. Uma ferramenta que o servidor alterou desde que foi marcada é recusada com uma observação solicitando que seu autor a marque novamente no Agent Studio, e a resposta indica quaisquer ferramentas marcadas apenas para a conexão do próprio autor. Só é possível marcar novas ferramentas de servidores que a pessoa que edita o agente tenha conectado.
- Orçamentos. Limites rígidos de tempo de execução, chamadas ao modelo, etapas de ação, gravações externas e tokens. Uma execução tem, no máximo, tantos turnos quanto seu orçamento de chamadas ao modelo, e nunca mais de 16. Novos agentes começam com os valores padrão do Hive (8 chamadas ao modelo); um agente criado a partir de um modelo que encadeia várias ferramentas começa com mais; selecionar a primeira ação de um agente permite uma gravação externa por execução; e agentes criados anteriormente mantêm os orçamentos com os quais foram salvos. Quando o orçamento de gravação é excedido, o Hive recusa outras ações. Uma ação que aguarda aprovação por causa do destino do envio não usa nada do orçamento de gravação, mas conta como uma das etapas de ação da execução. O limite de tokens por execução do seu plano também se aplica, inclusive no Ask.
- Limites do espaço de trabalho. O limite de ações por hora e os limites de gastos continuam valendo para as ações. Uma ação bloqueada por esses limites é recusada, e o agente informa o motivo.
- Créditos. O trabalho do modelo de um agente, seja executado aqui, por agendamento ou quando alguém faz uma pergunta a ele no Ask, usa créditos de IA: no Business, os créditos do membro que o executa (em uma execução agendada, o proprietário do agendamento; em um link público, quem o publicou), sem limite mensal por agente além dos créditos e do limite de recarga do próprio membro; em um plano anterior, o saldo compartilhado do espaço de trabalho, até um limite mensal por agente de 2.000 créditos no Starter e Team e 10.000 no Business e Enterprise. Se você aumentou o orçamento de tokens de um agente acima do padrão, uma execução que o Hive estima custar mais de £5 (500 créditos em um plano anterior) solicita sua confirmação antes de começar; um agente com o orçamento padrão nunca solicita isso. A caixa de diálogo Implantar mostra a estimativa de custo máximo de cada execução antes de o agente entrar em operação: em libras no Business e em créditos em um plano anterior. Uma execução agendada ou iniciada por evento cujos créditos tenham acabado aguarda créditos por até 72 horas, e o cartão do agente no Agent Studio mostra 1 execução aguardando créditos (ou a quantidade correspondente), ou Executar quando os créditos voltarem? depois que uma execução tiver aguardado 72 horas (consulte Aguardando créditos).
- Falhas repetidas. Uma ação que falha três vezes em uma hora na mesma conta é pausada apenas nessa conta, e o agente informa até quando. Reconectar a conta encerra a pausa. Consulte Quando uma ação continua falhando.
- Conteúdo externo. Um agente iniciado por um evento de app (um novo e-mail, um novo negócio) lê o que alguém de fora do seu espaço de trabalho escreveu e ainda assim realiza ações. Uma ação que enviaria algo para um endereço, canal ou link extraído desse conteúdo aguarda aprovação, mas uma ação em um registro existente, como responder em um chamado de suporte, enviar ou anular uma fatura ou excluir um contato, não fica retida dessa forma. Selecione apenas ações que você considera adequado que o agente realize com esse tipo de conteúdo e mantenha baixo o orçamento de gravação dele.
- Interruptor de emergência. Quando um administrador ativa o interruptor de emergência, os agentes param de agir, assim como todo o restante. Uma execução ou um Teste já em andamento para antes de realizar uma ação, acessar algo fora do Hive (uma pesquisa na web ou um app conectado) ou salvar sua resposta. Até esse momento, pode fazer mais chamadas ao modelo, cobradas normalmente, mas nada do que produzir será salvo ou entregue. Pausar, arquivar ou desfazer a implantação do agente, ou remover a pessoa que iniciou a execução (ou movê-la para uma função abaixo de Operador), interrompe uma execução em andamento nos mesmos pontos.
- Registros. As ações concluídas são registradas no registro de auditoria.
Agentes reutilizáveis de membros ficam desativados por padrão. Você só os verá se o Hive os tiver ativado para seu espaço de trabalho. Links públicos de agentes estão disponíveis para todos os espaços de trabalho: consulte Links públicos de agentes.
Resumo dos limites
Consulte a referência de limites para ver todos os limites.
Conteúdo relacionado
Criar um agente
Descreva, configure, teste e implante seu primeiro agente.
Publicar e avaliar
Análises, feedback, agendamentos e links públicos.