Primeiros Passos
Nesta página
Da primeira visita à primeira conversa são necessários apenas alguns minutos de trabalho: escolha onde o agente será executado, adicione-o pelo módulo AI Agent e diga olá. Esta página percorre todo o caminho, começando pelos passos mais simples.
Lista de verificação de configuração
Marque os itens à medida que avançar — seu progresso é salvo neste navegador e você pode imprimir a lista para levar para o local.
O ecrã de boas-vindas
A primeira vez que abre o módulo AI Agent numa instalação sem agentes, vê Welcome to AI Agent. Lista o que ainda é necessário, passo a passo — por exemplo, Enable Model Router e Top up your balance se o Model Router ainda não estiver configurado — e termina com a adição do seu primeiro agente.
Figura 1: O ecrã de boas-vindas numa instalação sem agentes ainda
Clique em Add Agent para começar. Read the documentation traz-lhe até aqui e Skip setup for now oculta o ecrã até estar pronto. Se ainda não tiver hardware, Order hardware abre a página de encomenda.
Passo 1 — Escolher onde o agente é executado
Clicar em Add Agent — no ecrã de boas-vindas, ou na parte inferior do seletor de agentes assim que tiver agentes — abre a caixa de diálogo Add Agent: "Where should this agent run? You can add more of either kind later."
Figura 2: O seletor de agentes — alterne entre agentes ou escolha Add Agent na parte inferior
Figura 3: Escolher um Physical Agent ou um Cloud Agent
| Opção | O que é | Escolha quando |
|---|---|---|
| Physical Agent | "Pair an on-site device with a serial number or QR code." O agente é executado num AI Agent Processor no seu local | Pretende que o agente e os seus dados fiquem num hardware que controla fisicamente, ou precisa da ligação mais rápida na sua rede local |
| Cloud Agent | "Launch a Cloud Agent Instance in a region you choose. No pairing." O Performance Hub executa o agente por si | Ainda não tem hardware, está a gerir vários locais a partir de um único agente ou pretende um agente numa região específica |
Ambos os tipos têm o mesmo chat, memory, skills, cópias de segurança, orçamentos e controlo de acessos, e pode executar uma combinação na mesma instalação.
Passo 2 — Adicionar o seu agente
Adicionar um Physical Agent
Ligue e ponha em funcionamento primeiro:
- Coloque o dispositivo num local ventilado e seguro (orientações de colocação).
- Ligue o cabo Ethernet antes de ligar à corrente, se possível. Se tiver de utilizar Wi-Fi, ligue primeiro à corrente, junte-se à rede Wi-Fi de configuração do agente conforme indicado no ecrã e siga a página de configuração para introduzir os dados de Wi-Fi.
- Ligue a alimentação. O dispositivo arranca e fica on-line num espaço de alguns minutos. Se tiver ligado um ecrã HDMI, este mostra o estado da rede do dispositivo e que aguarda a adição a uma instalação.
Em seguida, emparelhe-o. A forma mais rápida: digitalize o autocolante de QR de emparelhamento no dispositivo com o seu telemóvel, o que abre a caixa de diálogo de emparelhamento com o número de série preenchido. Ou, na caixa de diálogo Add Agent, escolha Physical Agent para abrir Add Physical Agent.
A caixa de diálogo relembra-o: "Make sure the AI Agent Processor is powered on and connected to your network first." Tem três campos — o número de série ou ID do dispositivo, com um botão Scan QR code ao lado, seguido de Device name e Location — e uma secção Advanced settings recolhida por baixo. Preencha-os:
| Campo | Notas |
|---|---|
| Número de série ou ID do dispositivo | O primeiro campo. Digite o número de série do adesivo com QR code ou da etiqueta na parte inferior ou traseira da unidade, ou clique em Scan QR code para escanear o adesivo com sua câmera |
| Device name | O que todos verão no seletor de agentes, por exemplo, Meeting Room Agent ou Café Counter. Escolha algo que as pessoas reconheçam |
| Location | Onde a unidade está fisicamente, por exemplo, Level 3 meeting rooms ou Comms cabinet. Escolha um local existente ou digite um novo |
Figura 4: Pronto para pareamento — o diálogo confirma que o dispositivo está on-line
O diálogo verifica se o dispositivo está on-line enquanto você digita e exibe Device is online quando o encontra. Se você ver "This device is not online yet. Make sure it is powered on and connected.", confirme se o dispositivo está com energia e conectado à rede (a tela HDMI mostra seu estado de rede), aguarde um minuto e tente novamente. Um dispositivo pode pertencer a apenas uma instalação por vez — se ele já estiver pareado em outro lugar, remova-o de lá primeiro ou use Mover para outra instalação se ele for seu.
Clique em Add e o pareamento é concluído em instantes: o dispositivo recebe sua identidade de instalação, seus detalhes de conexão segura e suas configurações padrão.
Adicionar um Cloud Agent
No diálogo Add Agent, escolha Cloud Agent para abrir Add Cloud Agent: "Choose a name, region, and size. The agent is added to this facility automatically."
Figura 5: Adicionar Cloud Agent — nome, região e tamanho
- Name — o que todos verão no seletor de agentes, por exemplo, Retail Ops Cloud Agent ou Head Office Agent.
- Region — onde a instância do Cloud Agent é executada. A região com Lowest latency to you é selecionada para você. Para escolher outra, clique em Choose a different region, pesquise na lista e selecione uma. Escolha uma região próxima às pessoas que usam o agente ou uma que atenda às suas necessidades de residência de dados.
- Tamanho — Small, Medium ou Large, cada um com seus recursos, preço por hora e estimativa mensal. Medium é marcado como Recommended para cargas de trabalho regulares; Small é "Only for very simple, lightweight or budget-conscious agents that will do minimal work.". Clique em Show all instance sizes para ver mais opções. "Cloud Agents are charged based on the size and resources you provision." — View pricing docs tem os detalhes.
- Opcionalmente, expanda Advanced settings (abaixo).
- Clique em Launch.
Figura 6: Escolhendo uma região diferente para um Cloud Agent
O diálogo exibe então o progresso da inicialização — Provisioning the instance, Initialising agent e Adding to this facility — até Cloud agent is ready. "Setting up this region for the first time may take a few extra minutes." Você não precisa esperar: "Progress updates here automatically. You can leave this page and come back."
Se a inicialização falhar, o diálogo informará isso e "Nothing was charged for this attempt." Tente novamente ou escolha outro tamanho ou região.
Configurações avançadas (opcional)
Ambos os diálogos têm uma seção Advanced settings para alterar os padrões ao adicionar o agente. Tudo aqui pode ser alterado posteriormente em Gerenciamento de dispositivos, então, em caso de dúvida, mantenha os padrões.
Figura 7: Configurações avançadas ao adicionar um Physical Agent
Figura 8: Configurações avançadas ao adicionar um Cloud Agent
- Restore from a backup — desativado por padrão. "Seed this agent from another device's cloud backup — including devices that have been removed." Escolha a Backup source e o ponto de restauração, e o agente começará com o estado desse backup. Consulte Restore & recovery.
- Cloud backup — ativado por padrão, com Keep backups for definido como 90 dias e Storage regions definido como Automatic. Ajuste a retenção ou escolha regiões específicas antecipadamente se você tiver requisitos de residência de dados. Consulte Backups.
- MCP access — ativado por padrão, com escopo para esta instalação. "Lets the agent use Performance Hub tools through a device-bound service account. You can refine what it can access later in the agent's settings." Consulte Connecting to Performance Hub.
- Restrict access to this agent — desativado por padrão, para que qualquer pessoa com acesso à instalação possa abrir o agente. Ative-o e "Only you will be able to open it. You can grant access to others later in the agent's settings." Consulte Access control.
- Budgets & limits — "Optional spend caps for this agent's AI usage. All limits are off by default." Ative um Daily limit, Monthly limit ou Lifetime cap e insira um valor. Consulte Budgets & limits.
Quem adiciona o agente se torna seu proprietário para fins de controle de acesso.
Etapa 3 — Conheça seu agente
O novo agente é selecionado automaticamente no alternador de agentes e sua interface é carregada. Um agente totalmente novo leva alguns minutos para se configurar inicialmente; o módulo exibe o progresso e abre o agente assim que ele estiver pronto — não é necessário atualizar a página.
Em um agente totalmente novo, um breve assistente de configuração dentro do agente orienta você por quatro etapas rápidas:
- Defina o básico. Nomeie seu agente e escolha como ele se comporta: o que acontece quando você envia uma mensagem a ele durante uma tarefa (direcioná-lo imediatamente ou enfileirar sua mensagem como acompanhamento) e como ele lida com aprovações de comandos.
- Migre, se desejar. Opcionalmente, traga a memória, as habilidades e o histórico de chat de um assistente existente de outro computador, ou pule esta etapa se estiver começando do zero. Consulte Migrando para o seu agente.
- Apresente-se. Diga ao agente seu nome e cargo, fale sobre sua organização e com o que você deseja ajuda no dia a dia. Tudo vai para a memória de longo prazo e molda sua personalidade.
- Assista a uma breve demonstração. Um tour ao vivo de dois minutos: leitura da web, trabalho com arquivos, lembrança de coisas em conversas e agendamento de tarefas, terminando com sugestões adaptadas ao que você informou.
Você pode pular o assistente a qualquer momento e terminar depois — o assistente reaparece até ser concluído, e tudo o que ele configura pode ser alterado posteriormente nas configurações do agente. Quando terminar, o chat do agente estará pronto para sua primeira solicitação — consulte Usando seu agente.
Etapa 4 — Dê a ele algo real para fazer
Observação: O que o agente pode ver no Performance Hub depende de quais módulos e integrações sua instalação conectou. Exemplos que utilizam dados em tempo real — visitas, reservas, eventos de portas e assim por diante — exigem que esses dados estejam fluindo para o Performance Hub a partir de módulos como o AI Insights & People ou seus outros sistemas conectados. Se um módulo não estiver conectado em sua instalação, o agente informará que não pode ver esses dados.
Boas primeiras tarefas que mostram o que ele pode fazer:
- "O que você consegue ver no Performance Hub para esta instalação?" — observe-o enumerar suas capacidades.
- "Resuma os números de visitantes desta semana em comparação com a semana passada." — dados em tempo real, primeira pergunta.
- "Todos os dias úteis às 7h, prepare um breve briefing matinal e me notifique." — sua primeira automação com uma notificação por push.
- Arraste uma planilha ou PDF para a conversa e peça um resumo — ele vai direto para o espaço de trabalho do agente.
Veio de outra plataforma de agente de IA? A habilidade de migração integrada pode transferir os dados do seu antigo agente — consulte Migrando para o seu agente.
O que já foi resolvido
Como a adição do agente conecta tudo, observe o que você não precisou fazer: nenhuma chave de API de modelo de IA (pré-conectada com o modelo auto), nenhuma configuração de backup (horária, desde a primeira hora), nenhuma alteração de firewall, nenhuma instalação de software. A etapa recomendada restante é uma rápida olhada em Budgets & limits para definir um limite de gastos mensal com o qual você se sinta confortável.
Páginas relacionadas
- Usando seu agente — trabalho do dia a dia
- Gerenciamento de dispositivos — métricas, atualizações e configurações
- O hardware — o AI Agent Processor, posicionamento e o adesivo QR de pareamento
- Solução de problemas — problemas de pareamento e correções