Primeiros Passos

Do login à primeira automação rodando. Sem instalar nada para começar.

Antes de começar: três palavras

A plataforma inteira gira em torno de três conceitos. Entendendo estes, o resto se explica sozinho:

Onde as coisas ficam

Existem duas telas, e saber para que serve cada uma poupa muito tempo:

O Menu lateral fica recolhido na borda esquerda e se abre ao passar o mouse. Ele dá acesso às telas de gestão: runtimes, conectores, cofre de senhas, insights, empresa. Você vai usá-lo principalmente para ajustar algo que já está em produção sem precisar abrir o agente numa nova versão.

1. Criar o agente

Em Meus Agentes de Processo, clique no botão de novo agente. O formulário tem três campos, só isso:

Clique em Criar & Abrir. O Agent Builder abre com o fluxo vazio, pronto para receber a primeira etapa.

2. Montar o fluxo

O fluxo é uma sequência de cards da esquerda para a direita. Cada card é uma etapa. Clique no card +, no fim do fluxo, e escolha o tipo:

Dois atalhos do mesmo menu: Clonar duplica uma etapa já existente do fluxo naquele ponto, com tudo o que ela tem, e o grupo Orquestração de Agentes cria as etapas que disparam outros agentes, explicadas em Subprocesso de Agentes. Para o primeiro agente, os três tipos da tabela bastam.

Na etapa de Execução, o Tipo de Ação do Agente define o que ela faz de fato. Há ainda campos presentes em toda etapa, como nome, descrição, condição para executar e o que fazer quando ela falhar.

A referência completa, com cada tipo, cada ação e cada campo, está em Etapas e Ações. Vale a leitura quando você quiser ir além do básico. Para o primeiro agente, o que vem abaixo é suficiente.

Abra a etapa com duplo clique no card. A configuração tem duas partes:

1. Na aba Propriedades, dê um nome à etapa e escolha a ação.
2. Na aba Mapeamento, detalhe o que essa ação faz. O painel muda conforme a ação escolhida. Veja Mapeamento de Dados.

O que você preenche depende do tipo de trabalho que o agente faz:

✦ Ou peça ao Copilot e pule quase tudo isso

Tudo que você acabou de ler pode ser feito descrevendo em português o que o agente deve fazer. O Copilot fica no cabeçalho do Builder, enxerga o fluxo aberto e constrói dentro dele.

Pedidos como "cria uma etapa que abre o portal de notas" ou "escreve uma regra em Python que soma os valores da lista" já voltam como etapas montadas, prontas para você revisar.

Para agir sobre os campos de uma página específica, ele precisa conhecer a tela primeiro. É aí que entra a gravação, que o próprio Copilot aciona quando você pede.

O uso diário é coberto por uma cota por usuário, que renova todo dia, vale igual em qualquer agente e dá conta de várias sessões de modelagem. Se você trabalha em volume e não quer esperar a renovação, dá para cadastrar a sua própria chave da Anthropic (BYOK), pelo rodapé do painel do Copilot ou pelo cartão Copilot de Modelagem no seu perfil: o limite diário deixa de valer e o consumo passa a ser cobrado na sua conta.

O detalhe completo do que ele sabe fazer, as convenções que segue, os limites e como a chave é protegida está em Copilot.

3. Testar com o Debug

Não espere o fluxo estar pronto para testar. Clique em Debugar, no cabeçalho do Builder, e acompanhe: os cards ganham borda verde ou vermelha conforme executam, e um console mostra o que aconteceu em cada etapa.

Se a sua conta ainda não tem nenhum runtime cadastrado, o campo RUNTIME já vem com a Sandbox selecionada e o debug roda ali mesmo. Nada para instalar.

O Debug não consome crédito, então teste à vontade. Quando algo falhar, ele tem ferramentas para você não precisar rodar tudo de novo a cada tentativa: reiniciar a partir de uma etapa, fixar a saída de uma etapa lenta e ignorar uma etapa temporariamente. Veja Debug e Depuração.

4. Conectar outros sistemas

Quando o agente precisar falar com algo além do navegador, enviar um e-mail, consultar uma IA, gravar numa planilha, ler um banco de dados, use um conector.

1. Abra o painel Conectores pelo cabeçalho do Builder e clique em Novo Conector.
2. Escolha o serviço no catálogo e preencha as credenciais. Campos de senha são criptografados automaticamente.
3. Use Testar para validar a conexão antes de salvar.
4. Arraste o conector salvo para o canvas: uma etapa já vinculada a ele nasce no + em que você soltar, ou no fim do fluxo se soltar em outro ponto.

O catálogo completo, com os campos de cada serviço, está em Conectores. Ao lado do painel Conectores fica o painel Agentes, com os agentes que este processo pode chamar. Os dois se arrastam para o fluxo: Agent Builder → Criar ou configurar uma etapa arrastando do painel.

5. Preparar o seu runtime

Até aqui você trabalhou na Sandbox. Para o agente operar de verdade, ele precisa de um Runtime seu: um programa que fica rodando numa máquina sua e executa os agentes.

Por que ter o seu:

• Acesso ao que é seu. Sistemas internos, VPN, rede da empresa, impressora, pastas locais. A máquina é sua, o alcance é o dela.
• Credenciais de verdade. O Cofre de Senhas e conectores com credencial só operam em runtime próprio.
• Produção. Execução agendada, disparo por API, webhook e o botão RUN rodam no seu runtime.
• Sem disputa. A capacidade é sua, não compartilhada com outras contas.

O caminho é curto:

1. No painel Runtimes do Builder (ou em Meus Runtimes, no Menu), cadastre um runtime com nome e descrição. Em Instalações por ambiente, ele já vem com uma instalação só para Desenvolvimento, Homologação e Produção, que é o suficiente para começar (veja Instalações por ambiente).
2. No card do runtime recém-criado, baixe o agent.config.json da instalação. Ele já vem preenchido com a chave de ativação dela e tudo mais que o runtime precisa.
3. Baixe o pacote do runtime pelo atalho de download no cabeçalho do Builder, extraia numa pasta e coloque o agent.config.json ali dentro.
4. Abra o executável. Não há instalador nem login. Em instantes a instalação aparece LIVE no card. No Windows, ele também pode rodar direto na bandeja do sistema, sem janela nenhuma, confirmando na tela que subiu: veja Executar em segundo plano.
5. De volta ao Builder, selecione esse runtime no campo RUNTIME. O agente novo está em Desenvolvimento, como mostra o botão Dev preenchido ao lado do campo, e o runtime recém-cadastrado já tem instalação nesse ambiente. Quando o runtime não tem instalação em Desenvolvimento, o agente vai junto para um ambiente que ele tem (com aviso) e o botão Dev fica desabilitado. Para rodar em Desenvolvimento, edite o runtime e escolha, por exemplo, Compartilhar com Produção em Desenvolvimento (veja Os botões Dev, Homolog e Prod).

6. Publicar a versão

Enquanto você constrói, o agente está em desenvolvimento e só roda em Debug. Publicar é o que o transforma em algo que a operação pode usar.

1. Olhe o indicador de pendências, no cabeçalho. Ele lista o que falta: fluxo ainda sem etapa, etapa sem configuração, runtime não selecionado, modelo não salvo, script com erro de sintaxe. Enquanto não estiver verde, o botão de publicar nem aparece.
2. Clique em Publicar versão e descreva o que mudou. Esse texto é o que você vai ler daqui a seis meses para entender o que essa versão trouxe.

A partir daí, a versão publicada é a que roda em produção. Você pode abrir uma nova versão quando quiser, sem afetar quem está executando, e voltar a uma versão anterior em segundos. Veja Versionamento.

7. Executar e acompanhar

Com a versão publicada, o agente pode ser disparado de quatro formas:

Para acompanhar o que está acontecendo:

• Control Room: o que está rodando agora, com log ao vivo e botões de pausar e parar.
• Trilha de Auditoria: o histórico completo, mensagem por mensagem, com evidências em PDF.
• Dashboards: volume, taxa de sucesso e quanto tempo e dinheiro a automação economizou.

Para onde ir depois