Diretrizes para criação de tópicos
Os criadores de tópicos devem planejar a finalidade, o conteúdo e os requisitos de acesso de um tópico antes de criá-lo. Um tópico bem definido agrupa agentes e ferramentas relacionados em torno de um tipo reconhecível de trabalho de negócios e fornece ao Agent Hub um conjunto focado de recursos a serem considerados quando os usuários trabalham dentro do tópico.
Use as diretrizes a seguir ao planejar um tópico.
Organizar Tópicos em Áreas Comerciais
Crie tópicos em torno de uma área de negócios ou tipo de trabalho reconhecível, em vez de em torno das equipes que desenvolvem ou possuem os agentes.
Por exemplo, um tópico Finanças pode conter agentes que suportam reconciliação, fechamento de período e relatórios financeiros. Organizar os agentes dessa forma ajuda os usuários a selecionar um tópico com base no trabalho que desejam realizar, em vez de exigir que eles saibam qual equipe possui um determinado agente.
Manter Tópicos Focados
Inclua agentes e ferramentas que sejam relevantes para a finalidade do tópico e ofereçam suporte aos tipos de solicitações que os usuários provavelmente farão.
Quando um usuário trabalha em um tópico, o orquestrador considera os agentes e as ferramentas associados a esse tópico em vez de todos os recursos disponíveis. Manter o tópico focado fornece um conjunto relevante de recursos a serem considerados pelo Agent Hub.
Usar Descrições e Nomes de Tópicos Limpos
Dê a cada tópico um nome e uma descrição claros que comuniquem seu objetivo comercial e ajudem os usuários a entender quando usá-lo.
O Agent Hub usa a descrição do tópico ao responder perguntas sobre os recursos do tópico, como Com o que esse tópico pode ajudar? O orquestrador não usa a descrição do tópico para selecionar agentes ou ferramentas ao processar solicitações.
Por exemplo:
Nome: Finanças
Descrição: Use este tópico para trabalhar com agentes e ferramentas que suportam reconciliação, fechamento de período e relatórios financeiros.
Adicionar uma Imagem de Tópico Reconhecível
Adicione uma imagem que ajude os usuários a reconhecer o tópico quando abrirem e trabalharem com ele. Escolha uma imagem que represente a área de negócios ou a finalidade do tópico e ajude a distingui-la de outros tópicos.
As imagens do tópico são exibidas com o tópico quando o usuário trabalha dentro do tópico.
Selecionar Recursos que Suportam a Finalidade do Tópico
Adicione agentes e ferramentas que ofereçam suporte à área de negócios ou ao trabalho representado pelo tópico. Antes de adicionar um recurso, considere se seus recursos são relevantes para as solicitações que os usuários provavelmente enviarão enquanto trabalham no tópico.
Evite adicionar um recurso apenas porque ele está disponível. Cada recurso deve ter uma relação clara com o propósito do tópico.
Para obter informações sobre como adicionar ou remover agentes e ferramentas de tópicos existentes, consulte Modificar um Tópico.
Acesso ao Tópico do Plano
Considere quem precisa usar, gerenciar e administrar o tópico ao planejar sua configuração.
Um administrador do Hub de Agentes controla o acesso ao recurso Tópicos. Um administrador de tópico controla o acesso ao tópico individual.
O acesso ao tópico pode fornecer aos usuários um caminho de acesso aos agentes associados ao tópico, em vez de exigir acesso direto a cada agente individualmente. Outro acesso obrigatório ao Agent Hub e ao AI Registry ainda se aplica.
Ao planejar o acesso, conceda aos usuários somente o nível de acesso necessário para suas responsabilidades. Os usuários que só precisam trabalhar em um tópico não precisam das mesmas permissões que os usuários que gerenciam o tópico ou administram o acesso.
Para obter informações sobre como funciona o acesso a tópicos, consulte Entender o Acesso Baseado em Tópico.
Para obter informações sobre como configurar o acesso a um tópico, consulte Conceder aos Usuários ou às Atribuições Acesso a um Tópico.
Por que isso importa
Um tópico bem planejado ajuda os usuários a reconhecer quando o tópico é relevante, fornece ao Agent Hub um conjunto focado de agentes a serem considerados e facilita o acesso apropriado aos recursos de negócios relacionados.
Para obter informações sobre como criar e configurar um tópico, consulte Criar e Configurar um Tópico.