Galeria de modelos de Prompt

O Que é a Galeria

A galeria é uma pequena coleção de prompts iniciais escritos manualmente e mantidos dentro da plataforma. Cada modelo é o corpo completo e funcional de um prompt — não um esqueleto para preencher lacunas. Você escolhe o modelo que corresponde ao tipo de prompt que deseja, edita o que não se encaixa no seu agente e salva o resultado como um registro de Prompt personalizado.

Os modelos não são registros de metadados personalizados que você pode editar diretamente; eles fazem parte do pacote. Depois de inserido no Prompt Builder, o Prompt personalizado resultante é seu e pode ser alterado como quiser.

Categorias de Modelos

Os modelos são agrupados por Tipo de Prompt. Cada categoria existe para um tipo diferente de trabalho:

Consulte Prompts personalizados por agente para a lista completa dos tipos de prompt e como cada um contribui para o system prompt montado.

Modelos de Instruções Personalizadas

Três modelos cobrem as posições mais comuns no espectro de densidade de regras:

Regras Principais — Compacto

O conjunto de regras mais enxuto. Cerca de 150 tokens. Use-o quando o orçamento de tokens estiver apertado e você confiar no modelo de IA para acertar a maioria dos detalhes. Cobre: comportamento de priorizar ferramentas, limite máximo de tamanho da resposta, marcadores de formatação (rótulos em negrito, tabelas para 3 ou mais registros), a sintaxe de links e alertas que a interface de chat espera, chips de sugestão ao final e o placeholder {TODAY_DATE}.

Regras Principais — Detalhado

A mesma base, acrescida de seções explícitas de formatação e proteções (guardrails). Cerca de 300 tokens. Use este modelo quando quiser que o agente aplique formatação de moeda e de data de forma consistente, além de proteções explícitas (nenhuma fabricação de informação, nenhuma modificação de registro sem confirmação, respeito à segurança em nível de campo (FLS) e ao compartilhamento). Ideal para agentes de produção que atendem usuários internos exigentes.

Regras Voltadas ao Cliente Final

Regras educadas e seguras para uso externo. Cerca de 200 tokens. O tom é amigável e profissional; o prompt proíbe explicitamente a exposição de IDs internos, nomes de objetos ou detalhes técnicos. Use-o como ponto de partida para qualquer agente de widget externo ou de portal de comunidade.

Modelos de Ação

Três modelos descrevem como o agente deve estruturar as propostas de gravação para que a plataforma possa renderizar os cartões de confirmação e executar as ações de forma limpa. A estrutura é consistente entre os modelos — uma linha de proposta estruturada que o agente emite, que a plataforma interpreta e exibe ao usuário. As diferenças entre os três modelos estão no escopo: um conjunto abrangente cobrindo tarefas/eventos/e-mails/atualizações de registros; um conjunto mais enxuto para agentes de leitura e atualização; e um conjunto focado em notificações para fluxos de trabalho do tipo lembrete.

Os modelos de ação combinam naturalmente com as ferramentas de Ação integradas listadas na Referência de ferramentas integradas. O modelo não substitui as definições das ferramentas — ele indica ao agente como propor o uso delas.

Modelos de Schema

O modelo inicial de Schema é propositalmente genérico. A plataforma disponibiliza um único modelo que orienta o agente sobre como descrever os campos, relacionamentos e listas de seleção de um objeto; você o adapta aos seus objetos personalizados específicos.

Por que não existe uma biblioteca de modelos por objeto? Porque o mesmo pacote é instalado em organizações com modelos de dados completamente diferentes. Um prompt de schema pronto para um objeto de domínio que você não possui seria apenas ruído. O modelo inicial ensina a estrutura; você preenche o conteúdo.

Os prompts de schema se destacam quando o mesmo objeto é consultado com frequência. Um prompt de schema bem escrito pode reduzir várias chamadas de ferramenta (describe_object, get_picklist_values, get_record_types) por conversa, fornecendo ao agente os fatos relevantes de antemão. Consulte Configuração de ferramentas para entender esse equilíbrio.

Modelo de Substituição de Persona

Uma estrutura de persona de uso geral cobrindo tom, escopo, regras de escalonamento e recusas. Use-a como uma lista de verificação ao escrever uma persona personalizada; ela garante que você não esqueça de especificar o que mais importa:

• Quem é o agente e com quem ele está falando
• O que ele pode e não pode fazer
• Que tom combina com o canal
• O que recusar e como recusar de forma educada
• Para onde escalar quando não conseguir ajudar

Trabalhando com um Modelo

Por Que Esses Modelos Pontuam Bem

Os modelos disponibilizados são construídos seguindo as mesmas heurísticas aplicadas pelo Analisador de qualidade:

• Cabeçalhos (## RULES, ## FORMATTING, ## GUARDRAILS) evitam que eles disparem as verificações UNSTRUCTURED e NO_SECTIONS.
• Listas com marcadores facilitam a extensão das regras sem reestruturação.
• Sem enchimento verboso — os modelos usam imperativos curtos, não “por favor, certifique-se de…”.
• Sem afirmações redundantes — nada que o modelo de IA já faz por padrão é repetido.
• Dimensionados para caber no orçamento de tokens típico do agente sem dominá-lo.

Os modelos são deliberadamente curtos. A maioria dos agentes não precisa de mais que isso.

O Que os Modelos Não Cobrem

• Não existe modelo de Guardrail. Guardrail é um dos cinco tipos de prompt e a galeria não traz nenhum — nem sequer uma aba de Guardrail. Isso é proposital: um guardrail declara o que a sua organização não permite, então um genérico seria pior que nenhum. O guia de boas práticas mostra como escrever um, e os modelos de Custom Instructions trazem cláusulas em forma de guardrail que você pode aproveitar.
• Não são específicos por setor. Sem vocabulário de imóveis, vendas, suporte ou finanças — a plataforma é horizontal. Traga o vocabulário do seu próprio domínio.
• Não são localizados. Todo o conteúdo dos modelos está em inglês. O mecanismo Multi-idioma cuida da tradução em tempo de execução; os modelos em si não precisam ser traduzidos.
• Não cobrem todos os tipos de prompt em profundidade. Um modelo por tipo de nicho (Schema, Substituição de persona) é o escopo da galeria. Para orientação mais aprofundada, escreva o prompt e o submeta ao analisador e ao otimizador.
• Não referenciam seus objetos ou campos personalizados. São genéricos de propósito — é nos prompts que você salva que entra o detalhe específico da organização.

Boas Práticas

Comece com um modelo e depois ajuste. Edite em direção ao seu agente específico em vez de construir do zero. A maior parte do trabalho de densidade de regras já está pronta.

Mantenha um único prompt de Instruções personalizadas por agente. Dois prompts de instrução concorrentes no mesmo agente são uma fonte comum de conflito. Escolha o modelo inicial certo, personalize-o uma vez e deixe os outros fora do agente.

Personalize o modelo voltado ao cliente final antes de entrar em produção. As regras voltadas ao cliente final disponibilizadas são padrões seguros, mas quase certamente você vai querer acrescentar uma ou duas frases sobre a voz da sua marca.

Trate o modelo inicial de schema como um exemplo didático. Leia-o uma vez e depois escreva seus próprios prompts de schema usando a mesma estrutura para os seus objetos personalizados reais. O modelo inicial não deve ser salvo ao pé da letra.

Execute o analisador depois de editar. Edições podem introduzir enchimento verboso ou reorganizar seções. A pontuação muda; verifique-a antes de considerar o prompt pronto.

Mudanças incluídas em 1.16000

Ao copiar um exemplo antigo, use a assinatura atual: send_email usa to e update_record usa field_updates. Ferramentas de tarefas e eventos aceitam field_values para outros campos permitidos. Confira o esquema de entrada ativo antes de reutilizar um modelo salvo.

Checklist de atualização do cliente

Perguntas frequentes

Próximos Passos

Escolha um modelo e acesse o guia Criar e editar prompts, ou execute o Analisador de qualidade nos prompts que você já escreveu para ver como eles se comparam.