Personalizações fundamentais de agentes

A página inicial do agente é a principal página de entrada de um agente. É onde os utilizadores iniciam a sua interação num ambiente com âmbito definido. Normalmente fornece o nome, ícone e atribuição do agente, podendo incluir outros elementos com base no seu propósito — como interações passadas, dashboards ou galerias de media — para fornecer contexto e acesso rápido a funcionalidades relevantes.

Acertar nestes elementos fundamentais é essencial. Estabelecem a identidade, definem expectativas e sinalizam confiança antes de a primeira mensagem ser enviada.

Descrição geral da home page do agente, que mostra a barra de título, o ícone, o nome, a atribuição, a caixa de entrada de chat, as sugestões de pedidos, a vista de utilizador recorrente com lista e seletor de chats, e a home page, incluindo navegação e histórico.

A página inicial do agente é composta por vários elementos distintos. Cada elemento desempenha um papel específico em ajudar os utilizadores a compreender e a interagir com o agente.

Elemento Description
Barra de título Apresenta informações básicas sobre o agente, navegação e opções básicas.
Ícone O elemento de branding do agente, que facilita o reconhecimento pelos utilizadores.
Nome O identificador ou título único do agente, ajudando os utilizadores a reconhecer o seu propósito ou função.
Attribution Mostra o meio ou organização por trás do agente, permitindo aos utilizadores verificar a sua autenticidade e fiabilidade.
Caixa de entrada de chat O principal meio para os utilizadores interagirem com o agente, permitindo-lhes inserir consultas ou comandos. A caixa de entrada de chat segue as mesmas diretrizes do Microsoft 365 Chat nativo, garantindo uma experiência consistente.
Inícios de pedidos Sugestões curtas e clicáveis que aparecem no ecrã de boas-vindas do agente antes do utilizador escrever qualquer coisa. Orientam os utilizadores sobre como começar e o que o agente pode fazer.

Icon

O ícone é o primeiro sinal visual que os utilizadores associam ao seu agente. Deve ser claro, intencional e consistente com a sua marca.

Siga estas orientações ao desenhar o ícone do seu agente:

  • Use uma imagem simples e reconhecível que reflita o propósito do agente.
  • Garante que o ícone funciona em tamanhos pequenos. Aparece em superfícies compactas de interface como a barra de título, o seletor de chat e a loja de agentes.
  • Evita texto no ícone. Os nomes são identificados separadamente.
  • Siga as diretrizes de ícones da aplicação Teams para requisitos de tamanho, forma e cor.

Note

Os ícones fazem parte do pacote da tua aplicação. Certifique-se de que os seus ativos de ícones cumprem os requisitos da Teams Store antes de publicar. Saiba mais em diretrizes de validação para agentes.

Name

O nome é o identificador único que os utilizadores veem ao longo da experiência do agente — na barra de título, no seletor de agentes, no histórico de chat e na loja do agente. Deve comunicar imediatamente o propósito do agente.

Siga estas orientações ao nomear o seu agente:

  • Use um nome claro e conciso que reflita a função ou domínio do agente. Por exemplo: Gestor de Tickets da Contoso ou Agente de Pipeline de Vendas.
  • Evite afirmações superlativas como "melhor", "incrível" ou "#1".
  • Evite nomes demasiado genéricos que não diferenciem o agente dos outros.
  • Para agentes declarativos, o name valor em manifest.json, o ficheiro JSON do agente declarativo e name_for_human em qualquer ficheiro JSON de plugin deve ser idêntico.
  • Não use frases instrutivas, URLs, emojis ou caracteres ocultos no nome.

Importante

O nome do agente na interface deve corresponder exatamente ao nome definido no manifesto. Inconsistências podem causar falhas de validação ao publicar na loja.

Atribuição

A atribuição apresenta o publicador ou a organização responsável pelo agente. Aparece na página inicial do agente e ajuda os utilizadores a verificar a fonte do agente antes de interagirem com ela.

A atribuição clara apoia a confiança do utilizador. Os utilizadores que conseguem identificar quem desenvolveu um agente — e responsabilizar essa entidade — têm maior probabilidade de interagir com confiança. Esta confiança é especialmente importante em ambientes empresariais onde os agentes podem tratar de fluxos de trabalho ou dados sensíveis.

Certifique-se de que a sua atribuição reflete o nome real da sua organização registada no Centro de Parceiros. Evite atribuições enganosas que impliquem um agente criado pela Microsoft ou de primeira parte se o agente for publicado de forma independente.

Inícios de pedidos

Os prompt starters são sugestões curtas e clicáveis que aparecem no ecrã de boas-vindas do agente. Orientam os utilizadores para interações significativas antes de escreverem qualquer coisa.

Inícios de pedidos eficazes:

  • Refletir casos de uso reais. Cada início de pedido deve corresponder a uma tarefa que o agente possa efetivamente executar.
  • Use uma linguagem simples e orientada para a ação. Começa com um verbo ou uma pergunta clara. Evite jargão.
  • Abrangem várias capacidades do agente. Não agrupes todos os iniciantes numa única funcionalidade.
  • São breves. Cada início de prompt não pode exceder 128 caracteres.

Experiência inicial do utilizador

Quando um utilizador acede ao seu agente pela primeira vez, a página inicial mostra o ícone do agente, nome, atribuição e iniciadores de prompts. Não há histórico de conversas presente. Este é o momento para causar uma forte primeira impressão.

A experiência de primeira execução deve:

  • Estabeleça imediatamente identidade e propósito. Os utilizadores devem saber o que o agente faz em segundos após a chegada.
  • Reduzir a barreira para começar. Os iniciadores de prompts eliminam o problema do prompt em branco ao fornecer aos utilizadores pontos de entrada concretos e de confiança.
  • Defina expectativas precisas. A combinação entre nome, atribuição e inícios de pedidos deve comunicar claramente o que o agente pode e não pode fazer.

Para mais orientações sobre como desenhar experiências de primeira execução, consulte Design centrado no ser humano para agentes.

Retornando a experiência do usuário

Quando um utilizador que regressa abre o agente, a página inicial revela contexto adicional para o ajudar a retomar de onde parou.

Seletor de chat

O seletor de chat, embora não personalizável, permite aos utilizadores navegar facilmente pelo histórico de sessões de chat com o agente. Aparece na visualização do utilizador que retorna como uma lista navegável de conversas passadas, permitindo que os utilizadores retomem interações anteriores sem repetir contexto.

Listar

A lista, embora não personalizável, é um componente opcional que apresenta itens recentes ou relevantes do domínio do agente diretamente na página inicial. Proporciona acesso rápido a resultados anteriores, itens rastreados ou conteúdos selecionados sem necessidade de um novo prompt.

Página inicial

Para agentes que vão além de uma única entrada de chat, pode expandir a home page com vistas de navegação e de listas. Estes componentes tornam as funcionalidades mais fáceis de descobrir e permitem interações mais ricas e familiares — semelhantes a um dashboard.

Ecrã a mostrar o design da navegação dentro da experiência Microsoft Copilot.

A navegação permite aos agentes apresentar múltiplas vistas ou modos numa única página inicial. Por exemplo, um agente pode oferecer um separador Início e um separador de Insights , permitindo que os utilizadores alternem entre uma interface conversacional e uma vista de resumo de dados.

Utilize a navegação quando o seu agente tiver superfícies claramente distintas que beneficiem de acesso persistente ao nível superior.

Conteúdo relacionado

  • Last updated on