Configurar modelo de prompt

Configura um modelo de prompt para usar pelo nome em outras etapas do script de IA conforme um provedor de modelo e os prompts predefinidos que você pode personalizar.

Opções

Opções disponíveis somente quando Tipo de modelo é Consulta SQL:

  • Prompt SQL é uma expressão de texto para definir como o modelo deve construir consultas SQL.

  • Prompt em linguagem natural é uma expressão de texto para explicar como o modelo deve fornecer sua resposta.

Opção disponível somente quando Tipo de Modelo é Solicitação de busca:

  • Prompt de solicitação de busca é uma expressão de texto para definir como o modelo deve construir solicitações de busca. O prompt predefinido inclui o formato JSON para uma solicitação de busca (o mesmo usado pela FileMaker Data API), formatos de data e hora, bem como outras regras.

Opção disponível somente quando Tipo de modelo é Prompt de RAG:

  • Prompt de RAG é uma expressão de texto para explicar como o modelo deve responder a um prompt enviado a um espaço RAG no Servidor do modelo de IA.

Compatibilidade

Produto Compatível
FileMaker Pro Sim
FileMaker Go Sim
FileMaker WebDirect Sim
FileMaker Server Sim
FileMaker Cloud Sim
FileMaker Data API Sim
Publicação na Web personalizada Sim

Originada na versão

22.0

Descrição

Esta etapa de script configura um modelo de prompt que você referencia pelo nome nas etapas de script de IA que podem usar um modelo de prompt. Os prompts predefinidos nesta etapa de script são os mesmos que são usados nas outras etapas de script de IA quando estas não especificam um modelo de prompt. Os modelos de prompt permitem que você execute engenharia de prompts, personalizando como os prompts são estruturados e formatados para diferentes provedores de modelos e casos de uso, e fornecendo um comportamento mais consistente em seus scripts de IA.

Os modelos de prompt funcionam definindo estruturas de prompt reutilizáveis que incorporam constantes de modelo — espaços reservados que são substituídos dinamicamente no tempo de execução por valores reais quando o modelo é usado em uma das etapas de script de IA. As constantes disponíveis para usar em um modelo específico dependem do Tipo de modelo:

Constante Substituído por Em prompts

:esquema:

O esquema do banco de dados no formato linguagem de definição de dados (DDL) para as tabelas especificadas.

Prompt SQL
Prompt em linguagem natural
Prompt de solicitação de busca

:pergunta:

A pergunta ou prompt do usuário em linguagem natural.

Prompt SQL
Prompt em linguagem natural
Prompt de solicitação de busca
Prompt de RAG

:contexto:

As informações de contexto especificadas pela chave context_prompt na opção Parâmetros da etapa de script. Por exemplo, a opção Parâmetros pode ser uma expressão que informa ao modelo como tratar referências a "hoje" usando a data de hoje no formato de data do sistema:

"{ \"context_prompt\": \"Trate 'hoje' como " & Get(CurrentDate) & "\"}"

Prompt de solicitação de busca
Prompt de RAG

:sql_query:

A consulta SQL gerada pelo modelo.

Prompt em linguagem natural

:sql_results:

Os resultados retornados pela execução da consulta SQL.

Prompt em linguagem natural

:date_format:

O formato de data do sistema. Útil em prompts onde você especifica qual formato de data o modelo deve usar.

Prompt de solicitação de busca

Quando uma etapa de script de IA usa um modelo, ela substitui as constantes pelos valores apropriados com base no contexto atual e na operação que está sendo executada.

Quando esta etapa de script é executada, o modelo de prompt fica disponível apenas para os scripts no arquivo atual durante a sessão do cliente FileMaker atual.

Notas

  • Se já existir um modelo de prompt com o nome especificado, esta etapa de script o substituirá pela nova configuração.

  • Os nomes dos modelos de prompt diferenciam maiúsculas de minúsculas. "MyTemplate" e "mytemplate" são tratados como modelos diferentes.

  • Se uma etapa de script de IA fizer referência a um nome de modelo de prompt que não existe, a mensagem de erro "O modelo solicitado não foi encontrado" será retornada.

  • Se uma etapa de script de IA usar um modelo de prompt configurado para um provedor de modelo diferente do especificado na conta de IA, um erro será retornado indicando a incompatibilidade do provedor de modelo.

  • As constantes do modelo de prompt que não são aplicáveis à operação atual permanecem inalteradas no texto do prompt.

Exemplo 1

Configura uma conta de IA e, em seguida, configura um modelo de prompt incluindo como o modelo deve apresentar sua resposta em linguagem natural quando referenciado por uma etapa de script Executar Consulta SQL por Linguagem Natural. A consulta faz uma pergunta sobre dados na tabela Contatos, que tem dados nos campos Nome e Empresa.

Copiar
Configurar a conta de IA [ Nome da conta: "minha-conta" ; Provedor do modelo: OpenAI ; Chave de API: Global::API_Key ]

Configurar modelo de prompt [ Nome do modelo: "leve e divertido" ; Provedor do modelo: OpenAI ; Tipo de modelo: Consulta SQL ; Prompt em linguagem natural: "A resposta deve ser retornada em texto simples, não em JSON.¶ Responda de forma leve e divertida." ]

Ir para layout [ "Contatos" (Contatos) ; Animação: Nenhuma ]

Executar Consulta SQL por Linguagem Natural [ Nome da conta: "minha-conta" ; Modelo: "gpt-4o" ; Prompt: "Para qual empresa Alea trabalha?" ; Opções especificadas: Da lista ; Ação: Consulta ; Tabelas de dados: Da lista ; Tabelas... ; Fluxo ; Nome do modelo de solicitação: "leve e divertido" ; Destino da resposta: Contatos::Resposta ]

Possível resposta armazenada no campo Contacts::Response:

Alea, o ilustre indivíduo em questão, trabalha para ninguém menos que a Acme Anvils!

Exemplo 2

Configura uma conta de IA e, em seguida, configura um modelo de prompt com informações adicionais sobre como encontrar correspondências exatas em uma solicitação de busca quando referenciada por uma etapa de script Realizar busca por Linguagem natural. Adiciona ao valor predefinido do Prompt de solicitação de busca uma regra de como especificar uma correspondência exata para um campo inteiro usando == (a primeira parte do prompt predefinido é omitida para resumir). O prompt na etapa de script Realizar busca por Linguagem natural exige uma correspondência exata e retorna a solicitação de busca como JSON no campo Resposta.

Copiar
Configurar conta de IA [ Nome da conta: "minha-conta" ; Provedor do modelo: OpenAI ; Chave de API: Global::API_Key ]

Configurar modelo de prompt [ Nome do modelo: "find-exact" ; Provedor do modelo: OpenAI ; Tipo de modelo: Solicitação de busca ; Prompt da solicitação de busca: "...10. Para encontrar itens que correspondam exatamente ao valor fieldX, use este formato: { \"fieldX\": \"==\" }" ]

Ir para layout [ "Contatos" (Contatos) ; Animação: Nenhuma ]

Realizar busca por Linguagem natural [ Nome da Conta: "minha-conta" ; Modelo: "gpt-4o" ; Prompt: "Encontre contatos cujo nome seja exatamente Alea" ; Get: Solicitação de busca como JSON ; Destino da resposta: Contatos::Resposta ; Nome do modelo de prompt: "find-exact" ]

Possível solicitação de busca retornada no campo Resposta:

Copiar
{"layouts":"Contatos","consulta":[{"Contatos::Nome":"==Alea"}],"classificação":[]}