Galeria de Agentes

A Galeria de Agentes reúne modelos mantidos pela plataforma para criar um novo agente sem escrever o prompt do zero. Cada importação é uma cópia independente: alterações posteriores no modelo da galeria não atualizam o agente criado.

Acesso atual

A rota /admin/gallery é exclusiva de Superadmin da plataforma e não aparece na navegação atual. Administradores e colaboradores de uma organização não conseguem abrir essa tela. Se você não tem esse acesso, crie o agente pelo fluxo normal descrito em Criando agentes.

O que aparece na galeria

Cada card pode mostrar:

• avatar, nome e uma descrição curta;
• categoria do modelo, quando cadastrada;
• modelo de IA sugerido;
• os botões Visualizar e Importar.

As categorias são mantidas dinamicamente pela plataforma, portanto os nomes disponíveis podem mudar. O número de importações não aparece no card, embora seja usado na ordenação por popularidade.

Buscar, filtrar e ordenar

1. Abra diretamente /admin/gallery com uma conta Superadmin.
2. Em Buscar modelos…, digite parte do nome ou da descrição.
3. Se necessário, escolha uma categoria no filtro Categoria ou em um dos marcadores abaixo dos filtros. Todos remove esse filtro.
4. Em Ordenar por, escolha Mais populares, Mais recentes ou Nome A-Z.

Quando nenhum modelo corresponde aos filtros, a tela mostra Nenhum modelo encontrado.

Conferir o modelo antes de importar

No card, selecione Visualizar. O detalhe mostra nome, descrição, avatar, categoria, modelo sugerido e o Prompt do Agente completo.

O detalhe é somente leitura e não contém o botão de importação. Feche-o e use Importar no card se quiser continuar.

Importar para a organização atual

1. No card, selecione Importar.
2. Em Selecionar Categoria, escolha uma categoria da organização ou mantenha Sem categoria.
3. Selecione Importar e aguarde a confirmação.

Se a organização ainda não tiver categorias, a lista mostra apenas Sem categoria e orienta criá-las em Agentes > Categorias.

O que é copiado

A importação cria um agente ativo na organização atual com:

• nome, descrição e prompt do modelo da galeria;
• modelo de IA sugerido, quando o slug corresponde a um modelo existente;
• temperatura 0,7, histórico de 30 mensagens, limite de 4.096 tokens de saída e até 14 chamadas de ferramenta por execução;
• acesso pelo Hub ativo e entradas de Telegram, WhatsApp QR, WhatsApp Oficial e API criadas como inativas;
• a categoria organizacional escolhida, quando houver.

O avatar da galeria não é copiado: o agente recebe uma nova identidade visual. A importação também não copia ferramentas, Skills, bases de conhecimento, blocos de contexto, transferências, Guardrail ou configurações multimodais.

Revise antes de usar

A tela pode informar que a importação falhou depois de o agente já ter sido criado. Antes de repetir, procure o nome em Meus Agentes para evitar duplicatas. O modelo sugerido também precisa estar disponível no plano da organização.

Preparar o agente importado

Abra o novo registro em Meus Agentes e trate o modelo como ponto de partida:

1. revise o prompt, inclusive instruções que dependam de dados ou processos específicos;
2. confirme o modelo em Modelos e os limites em Configurações avançadas;
3. conecte somente as ferramentas e bases necessárias;
4. revise as entradas: o Hub nasce ativo, enquanto os canais externos permanecem inativos;
5. execute cenários reais no teste do agente antes de colocá-lo em uso.

Uma importação bem-sucedida incrementa o contador interno do modelo. Esse contador serve para ordenar Mais populares; ele não altera o agente da organização.