Configurar tarefas de ‘LLM Responses ChatGPT’

força o agente de IA a usar a pesquisa na web
campo opcional
para habilitar este parâmetro, web_search também precisa estar habilitado;
quando habilitado, o modelo de IA é forçado a acessar e citar informações atuais da web;
valor padrão: false;
Observação: mesmo que o parâmetro seja definido como true, não há garantia de que fontes da web sejam citadas na resposta
Observação nº 2: não suportado em modelos de raciocínio

número máximo de tokens na resposta da IA
campo opcional
valor mínimo para modelos de raciocínio (por exemplo, reasoning é true no endpoint Models): 1024;
valor mínimo para modelos sem raciocínio: 16;
valor máximo: 4096;
valor padrão: 2048

histórico da conversa campo opcional array de objetos de mensagem que representam turnos anteriores da conversa; cada objeto deve conter: role string com a função user ou ai; message string com o conteúdo da mensagem (máximo de 500 caracteres); você pode especificar no máximo 10 objetos de mensagem no array; Observação: para modelos Perplexity, as mensagens devem alternar estritamente entre as funções user e ai (user → ai); exemplo: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]

nome do modelo de IA
campo obrigatório
model_nameconsiste no nome real do modelo e no nome da versão;
se o nome do modelo básico for especificado, sua versão mais recente será definida por padrão;
por exemplo, se gpt-4.1 for especificado, gpt-4.1-2025-04-14 será definido automaticamente como model_name;
você pode obter a lista de modelos LLM disponíveis fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models

URL de notificação de uma tarefa concluída
campo opcional
quando uma tarefa é concluída, notificaremos você por meio de uma requisição GET enviada para a URL que você especificou
você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição
exemplo:
http://your-server.com/pingscript?id=$id
http://your-server.com/pingscript?id=$id&tag=$tag
Observação: caracteres especiais em pingback_url serão codificados para URL;
ou seja, o caractere # será codificado como %23

saiba mais na nossa Central de Ajuda

URL para envio dos resultados da tarefa
campo opcional
quando a tarefa for concluída, enviaremos uma requisição POST com os resultados compactados no formato gzip para o postback_url que você especificou
você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição.
exemplo:
http://your-server.com/postbackscript?id=$id
http://your-server.com/postbackscript?id=$id&tag=$tag
Observação: caracteres especiais em postback_url serão codificados para URL;
ou seja, o caractere # será codificado como %23

saiba mais na nossa Central de Ajuda

instruções para o comportamento da IA
campo opcional
define a função, o tom ou o comportamento específico da IA;
você pode especificar até 500 caracteres no campo system_message

identificador de tarefa definido pelo usuário
campo opcional
o limite de caracteres é 255
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor de tag especificado no array data da resposta

aleatoriedade da resposta da IA
campo opcional
valores mais altos tornam a saída mais diversa;
valores mais baixos tornam a saída mais focada;
valor mínimo: 0
valor máximo: 2
valor padrão: 0.94
Observação: não suportado em modelos de raciocínio

diversidade da resposta da IA
campo opcional
controla a diversidade da resposta limitando a seleção de tokens;
valor mínimo: 0
valor máximo: 1
valor padrão: 0.92

Observação: top_p não pode ser usado junto com temperature na mesma requisição

prompt para o modelo de IA
campo obrigatório
a pergunta ou tarefa que você deseja enviar ao modelo de IA;
você pode especificar até 500 caracteres no campo user_prompt

habilitar pesquisa na web
campo opcional
quando habilitado, o modelo de IA pode acessar e citar informações atuais da web;
valor padrão: false;
Observação: consulte o endpoint Models para ver a lista de modelos que suportam web_search;

nome da cidade do local
campo opcional
Observação: não suportado nos modelos o3-mini, o1-pro, o1

código ISO do país do local
campo opcional
para habilitar este parâmetro, web_search também precisa estar habilitado;
quando habilitado, o modelo de IA pesquisará na web a partir do país que você especificar;
Observação: não suportado nos modelos o3-mini, o1-pro, o1