Personalizações do agente base

A página inicial do agente é a principal tela de entrada para um agente. É onde os usuários começam sua interação em um ambiente delimitado. Normalmente, ele fornece o nome, o ícone e a atribuição do agente e pode incluir outros elementos com base em sua finalidade, como interações passadas, dashboards ou galerias de mídia, para fornecer contexto e acesso rápido a recursos relevantes.

Acertar esses elementos fundamentais é essencial. Eles estabelecem identidade, definem expectativas e sinalizam confiança antes que a primeira mensagem seja enviada.

A home page do agente é composta por vários elementos distintos. Cada elemento desempenha uma função específica para ajudar os usuários a entender e se envolver com o agente.

Icon

O ícone é o primeiro sinal visual que os usuários associam ao seu agente. Deve ser claro, proposital e consistente com sua marca.

Siga estas diretrizes ao criar o ícone do agente:

• Use uma imagem simples e reconhecível que reflita a finalidade do agente.
• Verifique se o ícone funciona em tamanhos pequenos. Ele aparece em superfícies de interface do usuário compactas, como a barra de título, o seletor de chat e o repositório de agentes.
• Evite texto no ícone. Os nomes são identificados separadamente.
• Siga as diretrizes de ícone de aplicativo do Teams para requisitos de tamanho, forma e cor.

Name

O nome é o identificador exclusivo que os usuários veem ao longo de toda a experiência com o agente — na barra de título, no seletor de agentes, no histórico de chat e na loja de agentes. Ele deve comunicar imediatamente o propósito do agente.

Siga estas diretrizes ao nomear seu agente:

• Use um nome claro e conciso que reflita a função ou o domínio do agente. Por exemplo: Gerenciador de Tíquetes da Contoso ou Agente de Pipeline de Vendas.
• Evite declarações superlativas como "melhor", "incrível" ou "nº 1".
• Evite nomes excessivamente genéricos que não diferenciem o agente de outras pessoas.
• Para agentes declarativos, o name valor em manifest.json, o arquivo JSON do agente declarativo e name_for_human em qualquer arquivo JSON de plug-in deve ser idêntico.
• Não use frases instrucionais, URLs, emojis ou caracteres ocultos no nome.

Atribuição

A atribuição exibe o publicador ou a organização por trás do agente. Ele aparece na home page do agente e ajuda os usuários a verificar a origem do agente antes de se envolverem com ele.

A atribuição Clear dá suporte à confiança do usuário. Os usuários que podem identificar quem criou um agente e responsabilizar essa entidade são mais propensos a se envolver com confiança. Essa confiança é especialmente importante em ambientes empresariais em que os agentes podem lidar com fluxos de trabalho ou dados confidenciais.

Verifique se sua atribuição reflete o nome real da organização, conforme registrado no Partner Center. Evite uma atribuição enganosa que sugira que o agente é da Microsoft ou oficial, caso ele seja publicado de forma independente.

Sugestões de prompt

Os prompt starters são sugestões curtas e clicáveis que aparecem na tela de boas-vindas do agente. Eles orientam os usuários para interações significativas antes de digitarem qualquer coisa.

Sugestões de prompt eficazes:

• Refletir casos de uso reais. Cada iniciador deve corresponder a uma tarefa que o agente pode realmente realizar.
• Use uma linguagem simples e voltada para a ação. Lidere com um verbo ou uma pergunta clara. Evite jargões.
• Abranja uma gama de recursos do agente. Não agrupe todos os iniciantes em um único recurso.
• Mantenha-os breves. Cada prompt starter não deve exceder 128 caracteres.

Experiência inicial do usuário

Quando um usuário acessa seu agente pela primeira vez, a página inicial exibe o ícone, o nome, a atribuição e as sugestões de prompt do agente. Nenhum histórico de conversas está presente. Este é o momento para causar uma forte primeira impressão.

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

• Estabeleça a identidade e a finalidade imediatamente. Os usuários devem saber o que o agente faz em segundos após a chegada.
• Reduza a barreira para começar. Os prompt starters removem o problema de prompt em branco, dando aos usuários pontos de entrada concretos e confiáveis.
• Defina expectativas precisas. A combinação de nome, atribuição e sugestões de prompt devem comunicar em conjunto o que o agente pode ou não fazer.

Para obter mais diretrizes sobre como projetar experiências de primeira execução, acesse o design centrado em humanos para agentes.

Retornando a experiência do usuário

Quando um usuário retornando abre o agente, a home page apresenta contexto adicional para ajudá-lo a continuar de onde parou.

Seletor de chat

O seletor de chat, embora não seja personalizável, permite que os usuários naveguem facilmente pelo histórico de sessão de chat com o agente. Ele aparece na exibição do usuário retornando como uma lista navegável de conversas passadas, permitindo que os usuários retomem interações anteriores sem repetir o contexto.

List

A lista, embora não personalizável, é um componente opcional que apresenta itens recentes ou relevantes do domínio do agente diretamente na home page. Ele fornece acesso rápido a saídas anteriores, itens rastreados ou conteúdo coletado sem a necessidade de um novo prompt.

Página inicial

Para agentes que vão além de uma única entrada no chat, você pode estender a home page com exibições de navegação e de lista. Esses componentes facilitam a descoberta e a habilitação de interações mais avançadas e familiares, semelhantes a um painel.

Navigation

A navegação permite que os agentes apresentem várias exibições ou modos em uma única página inicial. Por exemplo, um agente pode oferecer uma guia Página Inicial e uma guia Insights , para que os usuários possam alternar entre uma interface de conversa e uma exibição de resumo de dados.

Use a navegação quando o agente tiver superfícies significativamente distintas que se beneficiam do acesso persistente de nível superior.

Conteúdo relacionado

• Diretrizes de validação para agentes. Requisitos para envio à loja do nome do agente, prompts, respostas de Cartões Adaptáveis e muito mais.
• Conceitos básicos de design de aplicativo do Teams. Diretrizes de layout, ícones, tipografia, cores e formas para aplicativos do Teams e do Copilot.