> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Visão geral do Agent Studio

> Crie agentes de IA especializados com base no Cérebro empresarial e na Biblioteca, que executam só as ações selecionadas, e use-os no Ask, em agendamentos e fluxos de trabalho.

No Agent Studio, você cria **agentes especializados que configura para uma tarefa — com base no seu Cérebro empresarial e limitados pelas suas regras.** O Ask Hive é um assistente de uso geral. Um agente é um especialista salvo e com controle de versões, como um assistente de cobrança que escreve no seu tom, um redator de propostas que conhece seus modelos ou um assistente de triagem para uma caixa de entrada compartilhada.

Na barra lateral, selecione **Agent Studio** (`/agents`), logo acima de **Fluxos de trabalho**. O título da página é
**Agentes**. A paleta de comandos (<kbd>⌘</kbd> <kbd>K</kbd>) também oferece essa opção.

## O que é um agente

Um agente combina cinco elementos, todos salvos juntos como uma **revisão**:

| Parte | O que controla |
| - | - |
| **Instruções** | O trabalho, a persona e o objetivo do agente, escritos em linguagem simples. |
| **Entradas** | Como alguém o inicia: um **Prompt** de texto livre (o padrão), **Hive escolhe** ou um **Formulário** estruturado com campos tipados. |
| **Conhecimento** | Arquivos e pastas da Biblioteca que ele pode ler. Todas as pessoas que podem executar o agente têm acesso a eles ao executá-lo na página de execução, no Ask e em Continuar no chat, mesmo que seja um arquivo que só você pode abrir: veja [Quem pode ler os arquivos de um agente](#who-can-read-an-agents-files). Até cerca de 50.000 tokens no total, eles são enviados inteiros ao modelo. Acima disso, o agente recebe uma lista (nome, data, primeiras linhas) e abre os arquivos de que precisa um por vez: nas execuções, quando alguém faz uma pergunta a ele no Ask, quando outro agente lhe atribui uma tarefa, como etapa de um fluxo de trabalho, em um Teste de rascunho e no seu [link público](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links), em que cada abertura é menor. Um [teste completo](https://docs.get-hive.ai/agents/build-an-agent.md) ainda lê os arquivos inteiros. Totais de uma planilha vinculada (CSV, TSV ou Excel), como uma soma, uma média ou uma contagem, são calculados com exatidão sobre todas as linhas, em vez de estimados pelo modelo. Veja [Como o Hive lê os arquivos que você escolhe](https://docs.get-hive.ai/pt-br/library/library.md#how-hive-reads-the-files-you-choose). |
| **Integrações** | Os aplicativos conectados com os quais ele trabalha. Ele sempre pode ler um aplicativo vinculado e realiza apenas as ações que você ativa para ele, como **Enviar e-mail** no Gmail ou **Criar negócio** no HubSpot. Cada ação ativada exibe **Executa automaticamente quando alguém executa este agente.** |
| **Comportamento do agente** | **O que ele pode fazer** (**Apenas lê e responde** ou **Pode realizar ações nos seus aplicativos**), quais dados da própria pessoa ele pode ler (**Dados da própria pessoa**), **Pesquisar na web**, **Criar imagens**, **Criatividade** (**Preciso**, **Equilibrado** ou **Criativo**) e o que acontece **Quando os créditos ou limites se esgotam**. |

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](https://docs.get-hive.ai/agents/build-an-agent.md#how-the-editor-is-laid-out)). 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](#files-from-google-drive-onedrive-and-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.

Os arquivos enviados vão para a sua Biblioteca como arquivos privados e passam pelas verificações habituais: até 10 arquivos por vez,
cada um de um tipo compatível e com no máximo 25 MB. Você precisa da função Operador ou superior para enviar arquivos.

Cada arquivo enviado aparece imediatamente na linha **Arquivos**. Ele exibe **Processando…** enquanto o Hive lê
seu conteúdo e depois **Anexado · Salve para manter** quando o agente já pode usá-lo. Salve o agente (**Salvar
rascunho** ou **Publicar alterações** para um agente publicado) para manter o anexo como parte de uma nova revisão; até lá, **Descartar alterações** remove o anexo, e o
arquivo permanece na sua Biblioteca. Se um envio falhar, o indicador do arquivo mostra o motivo junto com **Tentar novamente** e
**Remover**. O mesmo acontece se um arquivo ainda estiver sendo processado após 10 minutos ou se o Hive não conseguir verificar
seu status 10 vezes seguidas.

Selecione o nome de um arquivo na linha **Arquivos** para abri-lo na mesma prévia usada pela Biblioteca: um arquivo do Word ou
PowerPoint abre nas suas [páginas](https://docs.get-hive.ai/pt-br/library/library.md#pages-and-text), com **Texto** a um clique de distância.
A prévia abre com suas próprias permissões de acesso à Biblioteca, então um arquivo que você não pode abrir na Biblioteca não exibe a opção de abrir
aqui, apenas **×** para removê-lo. Abrir um arquivo nunca altera o agente.

### 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](https://docs.get-hive.ai/pt-br/integrations/overview.md); 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.

Nada é verificado em segundo plano, e a abertura do agente por outra pessoa não inicia uma verificação. Quando o
original muda, o Hive o copia novamente e mantém o conteúdo anterior no histórico de versões
do arquivo. O agente usa o novo conteúdo imediatamente, inclusive nas versões implantadas, como faria
após uma edição em um arquivo da Biblioteca. Se uma verificação não conseguir acessar o original, a cópia continua funcionando e
a linha **Arquivos** informa o motivo, como **Não foi possível atualizar: reconecte o Google Drive**. Veja [Arquivos copiados
do Google Drive, OneDrive e SharePoint](https://docs.get-hive.ai/pt-br/library/library.md#files-copied-from-google-drive-onedrive-and-sharepoint).

### 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](https://docs.get-hive.ai/pt-br/library/library.md#how-hive-reads-the-files-you-choose)).
* **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](https://docs.get-hive.ai/developers/mcp-server.md) não pode executar agentes nem abrir seus
  chats, portanto nunca lê os arquivos de um agente dessa forma.

Os arquivos que uma pessoa escolhe para uma execução (uma fonte de execução ou um arquivo em um campo de formulário) continuam sendo lidos com
as permissões de acesso dessa pessoa, assim como os arquivos de um agente ao qual outro agente delega uma tarefa e
os de uma execução iniciada com **Executar agora**, por um agendamento ou por um encaminhamento de Sinais. Uma
etapa de fluxo de trabalho lê os arquivos de um agente com as permissões do membro sob cuja identidade o fluxo de trabalho é
executado, e um [link público](https://docs.get-hive.ai/agents/publish-and-evaluate.md) os lê com as permissões de quem o publicou.

## Onde os agentes são executados

Todo agente implantado fica disponível no Ask, na [própria página de execução](#run-an-agent-directly) 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.

> [card] [Ask Hive](https://docs.get-hive.ai/pt-br/ask/ask-hive.md)
>
> Escolha o agente no seletor de agentes do campo de mensagem do Ask, em vez do Hive padrão.

> [card] [Página de execução própria](#run-an-agent-directly)
>
> Preencha o formulário do agente, execute-o, leia a resposta e veja as execuções anteriores.

> [card] [Agendamentos](https://docs.get-hive.ai/admin/scheduled-tasks.md)
>
> Execute o agente em um agendamento recorrente com prompt e fuso horário fixos.

> [card] [Fluxos de trabalho](https://docs.get-hive.ai/workflows/workflow-steps.md)
>
> Adicione um agente implantado a um fluxo de trabalho pela Biblioteca de agentes do construtor.

> [card] [Links públicos](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> 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

| Onde é executado | O que lê | Ações |
| - | - | - |
| Um chat do Ask | Seus [arquivos anexados](#who-can-read-an-agents-files), além dos dados do membro que declara em **Dados da própria pessoa** e dos apps anexados, com a sua identidade, além da web quando permitido. As ferramentas **Cérebro empresarial**, **Gráfico** e **Imagem** e um arquivo aberto também funcionam, dentro desse escopo. | Suas ações selecionadas, realizadas a partir das suas próprias contas conforme o nível de cada conta permite, respeitando qualquer limite do espaço de trabalho: imediatamente em **Agir**, após sua aprovação em **Criar rascunho** e nunca em **Ler** (os cartões de aprovação aparecem no chat). Em **Agir**, uma ação cujo destinatário, canal, número ou link não tenha vindo das instruções do agente ou das suas próprias mensagens ainda aguarda sua aprovação no chat. A resposta informa o que o agente fez. |
| Uma configuração de execução (um chat próprio do Ask ou um formulário na página do agente) | Seus [arquivos anexados](#who-can-read-an-agents-files), além das fontes de execução que você escolhe, dos dados do membro que declara em **Dados da própria pessoa** e dos apps anexados e conectados, com a sua identidade, além da web quando permitido. | Suas ações selecionadas, realizadas a partir das suas próprias contas conforme o nível de cada conta permite, respeitando qualquer limite do espaço de trabalho: imediatamente em **Agir**, após sua aprovação em **Criar rascunho** e nunca em **Ler**, e registradas na execução, até cinco por execução. Em **Agir**, uma ação cujo destinatário, canal, número ou link não tenha vindo das instruções do agente ou do que você digitou para a execução ainda aguarda sua aprovação. Com um modelo de arquivo do Word ou Excel, até três [novos arquivos na sua Biblioteca](#files-a-run-writes-to-your-library). |
| Uma etapa de fluxo de trabalho | Seu conhecimento e suas fontes de execução, os dados do membro que declara em **Dados da própria pessoa** e os apps anexados e conectados, com a identidade do membro sob a qual o fluxo de trabalho é executado, além da web quando permitido. Uma pesquisa na web pode incluir qualquer conteúdo que a etapa tenha lido, e o provedor de pesquisa do Hive recebe esse conteúdo. | Suas ações selecionadas, realizadas a partir das contas desse membro conforme o nível de cada conta permite, respeitando qualquer limite do espaço de trabalho: imediatamente em **Agir**, após aprovação em **Criar rascunho** e nunca em **Ler**. Até cinco por etapa. Em **Agir**, uma ação cujo destinatário, canal, número ou link não tenha vindo das instruções do agente ou de um valor fixo digitado na etapa ainda aguarda aprovação. |
| Um link público | Apenas seu próprio conhecimento e a mensagem do visitante. | Nenhuma. |

As [habilidades obrigatórias](https://docs.get-hive.ai/skills/skills.md#how-hive-uses-skills) 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](https://docs.get-hive.ai/workflows/workflow-steps.md#web-hive-data-and-connected-apps-in-an-agent-library-step). 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](https://docs.get-hive.ai/workflows/workflow-steps.md#agent-library).

## 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](https://docs.get-hive.ai/pt-br/library/library.md). 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.

Um agente antigo, salvo antes da existência das configurações de execução, mostra um formulário mais simples: seus campos,
**Instruções de execução (opcional)** e **Executar agora**, sem envios nem Continuar no chat.

Selecione **Executar**. A resposta aparece abaixo do formulário, em primeiro lugar, com suas fontes e os arquivos
criados recolhidos logo abaixo. Quando suas instruções de execução pedem um gráfico, como “crie um gráfico da receita por
região”, o agente o cria a partir de uma planilha anexada a ele ou que ele lê, ou de números que você
digitou, e o gráfico é exibido e salvo com a resposta, com a fonte indicada abaixo, como em
[Visualizar dados](https://docs.get-hive.ai/ask/tools-and-modes.md). Uma execução iniciada pelo Agent Studio — **Executar agora**, um agendamento, um
evento de app, um sinal ou outro agente — também mantém os gráficos que criou, até quatro, exibidos abaixo da
resposta quando você abre a execução; um gráfico criado a partir de números de exemplo é identificado como dados de exemplo, e a
resposta informa isso. Os gráficos são exibidos ou ocultados exatamente como a resposta da execução. Se o agente permitir perguntas de acompanhamento, **Continuar no chat** abre a execução como um
chat do Ask para você continuar a conversa, aproveitando até 50 respostas anteriores; depois disso,
o Hive solicita que você inicie uma nova sessão. Caso contrário, cada execução fornece uma resposta: execute novamente para
fazer uma nova pergunta.

Uma execução começa assim que você seleciona **Executar**. O Hive lê as fontes uma vez, com seu acesso atual,
quando o agente trabalha na resposta: se você não puder mais abrir uma fonte, a execução falha e informa isso.
Uma etapa de agente salvo em um fluxo de trabalho funciona da mesma forma. Se a execução reteve alguma ação devido ao destino
do envio, a resposta informa quantas aguardam sua aprovação em **Revisar decisão** na
página **Sinais**.

### Arquivos que uma execução grava na sua Biblioteca

Um agente com um [modelo de arquivo](https://docs.get-hive.ai/agents/build-an-agent.md#ground-it-in-your-knowledge) 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](https://docs.get-hive.ai/approvals/audit-log.md) como
  “Execução de agente criou um arquivo na Biblioteca”, com o agente, a execução e o arquivo.

A execução de uma etapa de fluxo de trabalho (incluindo uma execução agendada ou por evento de app), um **Teste** do autor e um
[link público](https://docs.get-hive.ai/agents/publish-and-evaluate.md) nunca gravam arquivos: use a etapa
[Criar PDF](https://docs.get-hive.ai/workflows/workflow-steps.md#create-pdf) de um fluxo de trabalho para salvar um PDF a partir dele. Você precisa da
função Operador ou superior e de acesso à Biblioteca, como para qualquer arquivo que você adiciona.

Se o modelo de IA do agente falhar durante uma execução, a execução informa qual modelo falhou, o que o
provedor de IA relatou (por exemplo, que rejeitou a solicitação, com o status HTTP e o
código de erro do provedor) e o que fazer em seguida: aguardar e tentar novamente quando o provedor estiver ocupado, alterar
a solicitação quando um filtro de segurança a tiver bloqueado ou tentar novamente e depois escolher outro modelo nas
configurações do agente quando o provedor continuar rejeitando a solicitação. A mesma mensagem aparece no Agent Studio, no
Ask e na etapa de agente salvo de um fluxo de trabalho.

### 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](https://docs.get-hive.ai/admin/credits-and-usage.md).
* 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](https://docs.get-hive.ai/pt-br/get-started/inbox.md#suggested-for-your-workspace)) 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](https://docs.get-hive.ai/agents/build-an-agent.md#templates-by-hive)). **+ Criar agente** abre o construtor, onde você pode digitar ou ditar o que o agente deve fazer (consulte [Iniciar um novo agente](https://docs.get-hive.ai/agents/build-an-agent.md#start-a-new-agent)).
* 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:

| Ação | O que faz | Quem vê |
| - | - | - |
| **Editar** / **Abrir** | Abre o agente. Proprietários e administradores que podem editá-lo veem **Editar**; as demais pessoas veem **Abrir**. | Todas as pessoas que podem ver o agente |
| **Executar** | Abre a [página de execução](#run-an-agent-directly) do agente, com seu formulário e histórico de execuções. Apenas para agentes com status **Ativo** que você pode executar. | Membros que podem executar o agente |
| **Usar no Ask** | Inicia um novo chat do Ask com o agente selecionado. Apenas para agentes com status **Ativo** que você pode executar. | Membros que podem executar o agente |
| **Fixar** / **Desafixar** | Adiciona o agente a **Agentes fixados** ou o remove de lá. | Todas as pessoas |
| **Copiar link** | Copia um link que abre o agente no Agent Studio. Apenas pessoas que podem ver o agente podem abri-lo. | Todas as pessoas |
| **Duplicar** | Copia o agente para um novo rascunho privado, depois que você dá um nome a ele. | Membros que podem editar o agente e criar agentes |
| **Compartilhar** | Abre as configurações de compartilhamento do agente. | Proprietários e administradores que podem gerenciar o acesso ao agente |
| **Link público** | Abre o link público do agente, onde você pode ativá-lo ou revogá-lo. Consulte [Links públicos de agentes](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links). | Proprietários e administradores, nos agentes de sua propriedade |
| **Arquivar** | Arquiva o agente após sua confirmação. Ele fica em modo somente leitura e seu histórico é mantido. Se o agente estiver ocupado nesse momento (por exemplo, enquanto uma de suas execuções está começando), o Hive aguarda alguns segundos; se ele continuar ocupado, você verá “O Hive está ocupado com este agente. Tente novamente em instantes.” e nada terá mudado, então tente novamente. Pausar funciona da mesma forma. | Proprietários e administradores |
| **Excluir permanentemente** | Exclui um agente arquivado depois que você digita o nome dele para confirmar. Isso não pode ser desfeito. Suas execuções anteriores e o uso correspondente permanecem nos registros do espaço de trabalho e continuam contando para o uso do seu plano. Isso inclui um agente que você já compartilhou por link público: o link permanece desativado, e as conversas que visitantes tiveram nele e o uso correspondente permanecem nos seus registros. Chats que usaram o agente permanecem como chats comuns, e execuções de fluxos de trabalho que o usaram ainda podem ser abertas: a etapa dele mostra **Agente excluído**, e os resultados dessa etapa e das etapas seguintes não são mais exibidos, embora o status, os tempos e o custo de cada etapa continuem visíveis. Você não pode excluir o agente enquanto uma de suas execuções ainda estiver em andamento. | Proprietários e administradores |

### Status dos agentes

| Status | Significado |
| - | - |
| `draft` (**Rascunho**) | Ainda em construção. Você pode visualizá-lo, mas não pode agendá-lo nem publicá-lo. |
| `deployed` (**Ativo**) | Uma revisão salva está ativa e pode ser usada no Ask, em agendamentos e em fluxos de trabalho. |
| `paused` (**Pausado**) | Temporariamente interrompido. **Retomar** o reativa na mesma revisão. |
| `archived` (**Arquivado**) | Desativado e oculto do uso normal. |

## Quem pode fazer o quê

O Agent Studio segue as funções do seu espaço de trabalho (consulte [Funções e permissões](https://docs.get-hive.ai/admin/roles-and-permissions.md)):

* **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](#who-can-read-an-agents-files). 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](https://docs.get-hive.ai/pt-br/ask/ask-hive.md#use-an-agent-in-ask).

Administradores podem desativar o Agent Studio para o espaço de trabalho ou limitar seu uso a membros e grupos selecionados nas [configurações do espaço de trabalho](https://docs.get-hive.ai/admin/workspace-settings.md).

## 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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do).
* **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](https://docs.get-hive.ai/agents/build-an-agent.md)). Consulte [Para onde uma ação envia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#where-an-action-sends).
* **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](https://docs.get-hive.ai/admin/earlier-plans.md), 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](https://docs.get-hive.ai/workflows/runs-and-errors.md#waiting-for-credits)).
* **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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#when-an-action-keeps-failing).
* **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](https://docs.get-hive.ai/admin/safety-and-control.md), 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](https://docs.get-hive.ai/approvals/audit-log.md).

Você ainda pode ver o status de uma execução salva e interromper uma execução não concluída se a fonte dela na Biblioteca ficar
indisponível. Uma execução concluída mantém sua resposta: você pode abri-la depois, mesmo que tenha perdido
acesso a uma fonte que ela leu. A perda de acesso vale a partir da sua próxima execução ou pergunta, que não
lerá mais essa fonte nem a citará.

> [!NOTE]
>
> 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](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links).

## Resumo dos limites

| Item | Limite |
| - | - |
| Prompt base | 16.000 caracteres |
| Persona, objetivo | 4.000 caracteres cada |
| Entradas | 50 |
| Vínculos de conhecimento | 100 |
| Apps anexados | 20, com até 50 ações selecionadas cada |
| Habilidades | 10 |
| Perguntas iniciais de conversa | 12 |
| Chamadas ao modelo (turnos) em uma execução | O orçamento de chamadas ao modelo do agente (8 por padrão), até 16 |
| Novos arquivos que uma execução grava na Biblioteca | 3 |
| Delegações a outros agentes | 20, com até 5 níveis de profundidade |
| Agentes por espaço de trabalho (agentes de todos os membros que não estão arquivados) | Sem limite no Business e Team; 3 no Starter |
| Tokens por execução, em todas as execuções, incluindo agendadas, por evento e públicas (entrada / saída) | 3.000.000 / 300.000 no Business, Team e Enterprise (no Enterprise, pode variar conforme o contrato); 300.000 / 30.000 no Starter |
| Modelos para execuções iniciadas por um agendamento, evento de app ou sinal | Efficient ou Balanced; Frontier é recusado, a menos que a chave própria da sua organização esteja em uso |

Consulte a [referência de limites](https://docs.get-hive.ai/developers/limits-reference.md#agent-studio) para ver todos os limites.

## Conteúdo relacionado

> [card] [Criar um agente](https://docs.get-hive.ai/agents/build-an-agent.md)
>
> Descreva, configure, teste e implante seu primeiro agente.

> [card] [Publicar e avaliar](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> Análises, feedback, agendamentos e links públicos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.