Parâmetros de solicitação e resposta para chamar o modelo Qwen-Deep-Research pela API DashScope.
Documentação relacionada: Pesquisa profunda (Qwen-Deep-Research)
Atualmente, o modelo oferece suporte apenas ao SDK DashScope para Python. O SDK Java e a interface compatível com OpenAI não têm suporte.
DashScope
Antes de começar, obtenha uma chave de API e defina-a como variável de ambiente . Para usar o SDK DashScope, também instale o SDK .
Corpo da solicitação | Python |
modelstring(Obrigatório)Valor aceito: qwen-deep-research. | |
messagesarray(Obrigatório)Histórico da conversa em ordem cronológica.
Tipos de mensagem Mensagem do usuário object(Obrigatório)A mensagem do usuário envia perguntas, instruções ou contexto ao modelo. No fluxo de chamada em duas etapas do Qwen-Deep-Research, as mensagens do usuário têm finalidades distintas:
Campos content string(Obrigatório)Conteúdo da mensagem.rolestring(Obrigatório)Deve ser user.object(Opcional)Resposta do modelo a uma mensagem do usuário. Na Etapa 2 (Pesquisa profunda), transmita a pergunta de esclarecimento gerada na Etapa 1 para obter uma análise mais focada.contentstring(Opcional)Conteúdo da mensagem.rolestring(Obrigatório)Deve ser assistant. | |
output_formatstring(Opcional)Formato e nível de detalhe do relatório de pesquisa. Valores válidos:
|
Objeto de resposta | |
status_codestringCódigo de status HTTP da solicitação. 200 indica sucesso; outros valores indicam erro.Em caso de falha, a exceção lançada contém status_code e message. | |
request_idstringIdentificador exclusivo da solicitação. | |
codestringCódigo de erro. Este campo fica vazio em caso de sucesso.Este parâmetro é retornado apenas pelo SDK Python. | |
message stringMensagem de erro. Este campo fica vazio em caso de sucesso. | |
outputobjectResultado da chamada.
Campos text stringEste parâmetro é sempre null.finish_reasonstringMotivo pelo qual o modelo interrompeu a geração de conteúdo. Valores possíveis:
arrayLista de opções de saída do modelo.
Campos finish_reason stringValores possíveis:
objectObjeto de mensagem retornado pelo modelo.
Campos Propriedadesphase stringFase atual. Valores possíveis:
stringDeve ser assistant.contentstringConteúdo de saída gerado pelo modelo.extra arrayResultados de busca na web e referências coletadas pelo modelo.deep_researchobjectAs informações de busca na web e referências recuperadas aparecem apenas nas fases answer e WebResearch, sendo null nas demais fases.researchobjectDetalhes do processo de pesquisa.
Campos researchGoal stringObjetivo da pesquisa.querystringConsulta de busca usada durante a pesquisa.idintegerNúmero da rodada de busca, no intervalo de [1, 15].learningMapobjectConteúdo resumido das chamadas de ferramentas, associado ao uso da ferramenta.referencesobjectCitações da resposta gerada. Este campo aparece apenas na fase Answer.
Campos icon stringURL do favicon do conteúdo referenciado.index_number integerÍndice do conteúdo referenciado.descriptionstringBreve descrição do conteúdo referenciado.titlestringTítulo da página web referenciada.url stringURL do conteúdo referenciado.objectConteúdo referenciado durante a pesquisa. Incluído apenas na fase Web Research.
Campos icon stringURL do favicon do conteúdo referenciado.index_number integerÍndice do conteúdo referenciado.descriptionstringBreve descrição do conteúdo referenciado.titlestringTítulo da página web do conteúdo referenciado.url stringURL do conteúdo referenciado.stringStatus de uma fase específica durante o streaming:
booleanIndica se o stream foi concluído. Valores possíveis:
stringMotivo do término da saída em streaming. Valores possíveis:
| |
usageobjectQuantidade de tokens usados nesta solicitação.
Campos input_tokens integerNúmero de tokens de entrada.output_tokens integerNúmero de tokens de saída. |