Os modelos de prompt permitem separar a estrutura fixa de um prompt de suas variáveis dinâmicas. Isso possibilita criar modelos reutilizáveis para gerenciamento unificado, otimização e geração eficiente de prompts.
ImportanteEste tópico se aplica apenas à região de Singapura.
Fluxo de trabalho
- Crie um modelo: Crie e salve um modelo no console do Model Studio ou por meio de uma api para obter um id de modelo exclusivo.
- Recupere o modelo: Use a api e o id do modelo para recuperar o conteúdo do modelo.
- Gere um prompt: Preencha as variáveis do modelo com seus dados de negócio para gerar o prompt final.
- Use o modelo: Envie o prompt gerado ao modelo de destino para obter os resultados.
Tipos de modelo
Os modelos de prompt dividem-se em duas categorias: modelos de prompt integrados e modelos de prompt personalizados.
Dimensão | Integrado | Personalizado |
|---|---|---|
Origem | O Model Studio fornece estes modelos para cobrir uma ampla variedade de cenários de negócios. | |
Eficácia | Pré-otimizado para garantir desempenho estável. | A eficácia depende da qualidade do seu design e dos testes realizados. |
Usabilidade | Pronto para uso sem desenvolvimento adicional. Chame-os diretamente do console ou por meio de uma api. | Pode exigir várias iterações de refinamento. É necessário conhecer os princípios de design de prompt e métodos de otimização, como fornecer instruções claras, exemplos few-shot e restrições de formato. Habilidades básicas de desenvolvimento e técnicas também são necessárias. |
Cenários comuns |
|
|
Editável | Não. | Sim. Modifique os modelos conforme suas necessidades. |
Modelos de prompt integrados
1. Visualize modelos
Na página PromptsPrompts, visualize e use os modelos de prompt integrados que o Model Studio fornece para diferentes cenários.
Cada modelo de prompt aparece em um cartão com uma prévia do conteúdo e seu id. O cartão inclui botões para View Details, Copy prompt e mais ações (...).
2. Visualize e gerencie modelos
Visualize: Clique em View Details em um cartão de modelo para ver nome, conteúdo, variáveis, id e outras informações.
Gerencie:-
Clique em Copy Prompt para copiar o conteúdo do modelo.
-
Clique em ... > Create Application. O sistema preenche automaticamente o conteúdo do modelo no editor de prompt do Agent Application. Use o conteúdo como está ou modifique-o conforme seu cenário de negócios.
O prompt preenchido contém as variáveis personalizadas
${number}e${content}para gerar conteúdo no estilo Xiaohongshu.
-
Clique em ... > Copy Template para criar um modelo de prompt personalizado na página ****Prompts. O novo modelo recebe o nome "Nome do Modelo de Prompt Integrado_Cópia_Timestamp".
O cartão do modelo copiado exibe uma prévia do conteúdo do modelo e o id do modelo (clique em no ícone à direita para copiá-lo). A parte inferior do cartão oferece botões para Edit, Copy prompt e mais ações.
Modelos de prompt personalizados
1. Crie um modelo
Crie modelos de prompt personalizados no console ou usando uma api.
Console
-
Modifique um modelo de prompt integrado
Em um cartão de modelo de prompt integrado, clique em ... > Copy Template para criar uma cópia chamada "Nome do Modelo de Prompt Integrado_Cópia_Timestamp".
-
Crie um modelo com base nas suas necessidades de negócios
Na página ****Prompts, clique em Create Prompt. Após concluir a configuração, clique em Save para criar o modelo. Na página de gerenciamento de modelos de prompt, encontre os modelos existentes usando os filtros de tipo (All, Text Generation e Image Generation) ou a barra de pesquisa. Clique em + Create Prompt no canto superior direito para criar um novo modelo de prompt. Os modelos criados aparecem como cartões que mostram o título, uma prévia do conteúdo e o id do modelo, com opções para Edit e Copy prompt.
api
- Obtenha seu id de workspace: Para mais informações, consulte Obter um id de aplicativo e um id de workspace.
- Crie um modelo de prompt personalizado: Use a operação da api CreatePromptTemplate.
2. Visualize e gerencie modelos
Visualize: Após criar um modelo de prompt personalizado, visualize-o na página Prompts.
Gerencie:- Clique em Modify em um cartão de modelo para alterar seu conteúdo.
- Clique em Copy Prompt para copiar o conteúdo do modelo.
- Clique em ... > Create Application. O sistema preenche automaticamente o conteúdo do modelo no editor de prompt do Agent Application. Use o conteúdo como está ou modifique-o conforme seu cenário de negócios.
- Clique em ... > Copy Template para criar uma cópia na página atual chamada "Nome do Modelo de Prompt Personalizado_Cópia_Timestamp".
- Clique em ... > Delete para exclua o modelo.
Usar modelos de prompt
Console
-
Clique em Use Prompt > Create Application em um cartão de modelo de prompt integrado ou personalizado. O sistema preenche automaticamente o conteúdo do modelo no campo de prompt do Agent Application.
As variáveis do modelo, como
${name}, ficam visíveis na caixa de entrada do prompt. Um contador de caracteres no canto inferior direito mostra a contagem atual, com limite de 6.144 caracteres.
-
Defina um modelo para o aplicativo e insira uma pergunta para testar o prompt.
No lado esquerdo da página de depuração do modelo, selecione um modelo, como Qwen-Plus-Latest 128K, e escreva instruções do sistema na área de prompt. No lado direito, insira uma pergunta de teste na área de entrada do usuário e clique em Run. A resposta do modelo e as estatísticas de tokens para entrada e saída aparecem abaixo.
api
-
Abra a referência da api GetPromptTemplate e clique em Debug.
-
No painel Configure Parameters, insira seu workspaceId e promptTemplateId.
- workspaceId: Seu id de workspace. Para mais informações, consulte Obter um id de aplicativo e um id de workspace.
- promptTemplateId: O id de um modelo de prompt integrado ou personalizado. Encontre o id no cartão do modelo.
-
Clique em Initiate Call para depurar a operação da api online.
{ // Schema of Response
"variables": [ // A list of template variables
"platform", // A template variable
"topic", // A template variable
"num1", // A template variable
"num2" // A template variable
],
"promptTemplateId": "cfec40c311f14f3e976403059d8f0116", // The template ID
"requestId": "8C616xxx", // The request ID
"name": "Marketing Copy Generation", // The template name
"content": "You are a professional marketing copywriter with extensive experience on the ${platform} platform. Now, please write a highly engaging piece of ${platform} marketing content with \"${topic}\" as the core theme. The content must include a captivating and SEO-friendly title, and a detailed and emotionally compelling body. In the body, please insert at least ${num1} different emoji to increase interactivity and visual appeal. Additionally, based on this theme, design and provide up to ${num2} popular recommended tags that highly summarize the theme and attract the target audience.", // The template content
}
sdk
-
Abra a referência da api GetPromptTemplate e clique em Debug.
-
No painel Configure Parameters, insira o workspaceId e o promptTemplateId. Após inserir os parâmetros, o sistema preenche automaticamente o workspaceId e o promptTemplateId no exemplo do sdk.
- workspaceId: Seu id de workspace. Para mais informações, consulte Obter um id de aplicativo e um id de workspace.
- promptTemplateId: O id de um modelo de prompt integrado ou personalizado. Encontre o id no cartão do modelo.
-
Na página de depuração, clique em SDK Example.
-
Execute o exemplo online ou baixe o projeto completo, defina seu accessKeyId e accessKeySecret e execute-o.
Para mais informações sobre como obter um AccessKey, consulte Obter um AccessKey e AgentKey .
No lado direito da página OpenAPI Explorer, clique em na aba SDK Example. Selecione a versão do sdk V2.0 (Recommended) e sua linguagem de destino, como Java, para visualizar o código de exemplo do sdk correspondente.
Códigos de erro
Se uma chamada falhar e retornar uma mensagem de erro, consulte os códigos de erro para resolver o problema.
FAQ
P: Qual é a diferença entre chamar a apiGetPromptTemplatee concatenar strings diretamente no seu código?R: Usar a api GetPromptTemplate para gerenciar prompts oferece as seguintes vantagens:
- Separe a lógica do conteúdo: Atualize e otimize o conteúdo do prompt no console do Model Studio sem modificar ou reimplantar o código da sua aplicação.
- Gestão centralizada e colaboração: Armazenar todos os prompts em um local central facilita a colaboração entre equipes, como engenheiros de prompt e desenvolvedores, além de simplificar o gerenciamento de versões e a reutilização de modelos.
- Consistência: Garanta que a mesma versão e estrutura de prompt sejam usadas em diferentes partes da sua aplicação ou entre serviços distintos, evitando inconsistências causadas pela manutenção manual.