Os nós de recuperação de dados do LangStudio buscam contexto em bases de conhecimento, na web e em APIs externas para os nós LLM.
Consulta de índice
Recupera textos da base de conhecimento relevantes para a consulta do usuário e os fornece como contexto aos nós LLM subsequentes.
Entrada
Nome do índice da base de conhecimento: Selecione uma base de conhecimento registrada. Gerenciamento de Base de Conhecimento.
Palavras-chave de busca: Palavras-chave para consultar a base de conhecimento. Referencie uma saída de string de um nó anterior.
Top k: Quantidade de resultados mais relevantes a retornar.
Saída
A variável de saída result é um List[Dict] com as seguintes chaves:
|
Chave |
Descrição |
|
content |
Conteúdo do trecho de documento recuperado. |
|
score |
Pontuação de similaridade entre o trecho e a consulta. Valores mais altos indicam maior relevância. |
Exemplo de saída com os registros de maior pontuação conforme top_k:
[
{
"score": 0.8057173490524292,
"content": "Affected by the uncertainty of the COVID-19 pandemic, xx Bank proactively increased provisions for impairment losses on loans, advances, and non-credit assets based on economic trends and forecasts for China or mainland China. The bank also intensified the write-off and disposal of non-performing assets to improve its provision coverage ratio. In 2020, it achieved a net profit of 28.928 billion yuan, a year-on-year increase of 2.6%, and its profitability gradually improved. (RMB in millions) 2020 2019 Change (%) Operating Results & Profitability Operating Income 153,542 137,958 11.3 Operating Profit Before Impairment Losses 107,327 95,816 12.0 Net Profit 28,928 28,195 2.6 Cost-to-Income Ratio(1)(%) 29.11 29.61 decrease of 0.50 percentage points Return on Average Assets (%) 0.69 0.77 decrease of 0.08 percentage points Weighted Average Return on Equity (%) 9.58 11.30 decrease of 1.72 percentage points Net Interest Margin(2)(%) 2.53 2.62 decrease of 0.09 percentage points Note: (1) Cost-to-income ratio = Operating and administrative expenses / Operating income.",
"id": "49f04c4cb1d48cbad130647bd0d75f***1cf07c4aeb7a5d9a1f3bda950a6b86e",
"metadata": {
"page_label": "40",
"file_name": "2021-02-04_China_xx_Insurance_Group_Co_Ltd_xx_China_xx_2020_Annual_Report.pdf",
"file_path": "oss://my-bucket-name/datasets/chatglm-fintech/2021-02-04_China_xx_Insurance_Group_Co_Ltd__601318__China_xx__2020_Annual_Report.pdf",
"file_type": "application/pdf",
"file_size": 7982999,
"creation_date": "2024-10-10",
"last_modified_date": "2024-10-10"
}
},
{
"score": 0.7708036303520203,
"content": "7.2 billion yuan, a year-on-year increase of 5.2%. 2020 (RMB in millions) Life and Health Insurance Business, Property and Casualty Insurance Business, Banking Business, Trust Business, Securities Business, Other Asset Management Business, Technology Business, Other Business and Consolidation Eliminations, Group Consolidated Net Profit Attributable to Shareholders of the Parent Company 95,018 16,083 16,766 2,476 2,959 5,737 7,936 (3,876) 143,099 Minority Interest 1,054 76 12,162 3 143 974 1,567 281 16,260 Net Profit (A) 96,072 16,159 28,928 2,479 3,102 6,711 9,503 (3,595) 159,359 Items to be excluded: Short-term investment fluctuations(1)(B) 10,308 – – – – – – – 10,308 Impact of discount rate changes (C) (7,902) – – – – – – – (7,902) One-time significant items and others excluded by management as not part of daily operational income and expenses (D) – – – – – – 1,282 – 1,282 Operating Profit (E=A-B-C-D) 93,666 16,159 28,928 2,479 3,102 6,711 8,221 (3,595) 155,670 Operating profit attributable to shareholders of the parent company 92,672 16,",
"id": "8066c16048bd722d030a85ee8b1***36d5f31624b28f1c0c15943855c5ae5c9f",
"metadata": {
"page_label": "19",
"file_name": "2021-02-04_China_xx_Insurance_Group_Co_Ltd_xxx_China_xx__2020_Annual_Report.pdf",
"file_path": "oss://my-bucket-name/datasets/chatglm-fintech/2021-02-04__China_xx_Insurance_Group_Co_Ltd__601318__China_xx__2020_Annual_Report.pdf",
"file_type": "application/pdf",
"file_size": 7982999,
"creation_date": "2024-10-10",
"last_modified_date": "2024-10-10"
}
}
]
Casos de uso
IQS-GenericSearch
Executa uma busca na web em tempo real com o Alibaba Cloud Information Query Service (IQS) e filtragem por intervalo de tempo. Dados dinâmicos da web aumentam a precisão e a atualidade das respostas da IA.
A variável de saída é um Array<Object> com os seguintes campos: title(String), link(String), summary(String), content(String), markdown_text(String), score(Number), publish_time(Integer), host_logo(String), hostname(String), site_label(String) e scene_items(Array<Object>).
Entrada
Palavras-chave de busca: Termos para a pesquisa na web. Devem ter entre 2 e 100 caracteres. Strings maiores que 100 são truncadas; strings menores que 2 retornam erro.
Intervalo de tempo: Período da busca. Valores válidos: NoLimit, OneDay, OneWeek, OneMonth e OneYear.
-
Conexão IQS: A autenticação depende da função RAM da instância. Para maior segurança, use a autenticação baseada em função RAM.
-
Autenticar com uma função RAM (Recomendado)
Aplicável quando a função RAM da instância é uma função personalizada com a política de permissões AliyunIQSFullAccess anexada.
Não é necessária conexão IQS. O sistema autentica automaticamente via função RAM.
A autenticação por função RAM permanece dentro de uma VPC e não trafega pela rede pública.
-
Autenticar com uma chave de API (Não Recomendado)
Indicado quando a função RAM da instância é a função padrão do PAI ou uma função personalizada sem as permissões necessárias.
Configure uma conexão IQS. Configuração de Conexão de Serviço - Conexão Personalizada. Defina a chave como
api_keye obtenha o valor na página Information Query Service - Gerenciamento de Credenciais.A autenticação por chave de API acessa o serviço pela rede pública, o que reduz a segurança.
-
Saída
-
output: Resultados da busca como um List[Dict] com as seguintes chaves:
Chave
Descrição
title
Título do resultado.
link
URL do resultado.
summary
Resumo do resultado.
content
Conteúdo completo do resultado.
markdown_text
Conteúdo em formato Markdown. Pode estar vazio.
score
Pontuação de relevância. Valores mais altos indicam maior relevância.
publish_time
Data de publicação do conteúdo.
host_logo
URL do logotipo do site de origem.
hostname
Nome do host ou domínio do site de origem.
site_label
Rótulo ou categoria do site de origem.
scene_items: Dados complementares da busca. Geralmente vazio. Retornado apenas para consultas específicas, como hora, clima ou calendários .
Casos de uso
SerpAPI-GenericSearch
Realiza buscas na web com o SerpApi. Compatível com Bing, Google, Baidu, Yahoo e mecanismos personalizados. Permite configure o local da pesquisa e a quantidade de resultados.
Entrada
Conexão SerpApi: Selecione uma conexão SerpApi criada no LangStudio. Crie Conexão SerpApi.
Palavras-chave de busca: Termos para a pesquisa na web. Referencie uma saída de string de um nó anterior.
Mecanismo de busca: Suporta Bing, Google, Baidu, Yahoo e mecanismos personalizados.
Local: Local da pesquisa. Especifique uma cidade, como
Shanghai, China.Número de resultados: Quantidade de resultados de busca a retornar.
Saída
A variável de saída output é um List[Dict] com as seguintes chaves:
|
Chave |
Descrição |
|
title |
Título do resultado. |
|
link |
URL do resultado. |
|
summary |
Resumo do resultado. |
Casos de uso
Solução de chatbot com RAG e busca na web baseada em LangStudio e DeepSeek
Requisição http
Chama endpoints de api externos com métodos http, autenticação e formatos de corpo de requisição configuráveis.
Entrada
Método de requisição: Método http: GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS.
URL: URL de destino da requisição.
Cabeçalhos da requisição: Cabeçalhos http personalizados. Um par chave-valor por linha.
Parâmetros da requisição: Parâmetros de query string. Um par chave-valor por linha.
-
Autenticação: Desativada por padrão. Se ativada, escolha um método de autenticação padrão (Bearer ou Basic).
Bearer: Autenticação via Bearer Token. Omita o prefixo
Bearerao inserir o token.Basic: Autenticação básica. Insira nome de usuário e senha. O sistema codifica em Base64 automaticamente.
Para métodos de autenticação personalizados, configure os cabeçalhos da requisição manualmente.
-
Corpo da requisição: Formatos suportados:
none: Sem corpo de requisição.
JSON: Envia dados em formato JSON.
form-data: Envia multipart/form-data. Suporta upload de arquivos.
x-www-form-urlencoded: Envia dados de formulário codificados por URL.
raw-text: Envia dados como texto simples.
binary: Envia um arquivo binário. Suporta upload de arquivos.
Verificação SSL: Ativada por padrão. Verifica o certificado SSL do servidor. Mantenha ativada em produção.
Timeout: Tempo limite da requisição em segundos. Valores válidos: 1-600. Padrão: 10.
-
Configuração de nova tentativa: Desativada por padrão. Configura retentativas automáticas para requisições com falha.
Max Retries: Número máximo de tentativas. Valores válidos: 0-10.
Retry Interval: Intervalo entre tentativas em milissegundos. Valores válidos: 100-10.000.
Saída
body: Conteúdo textual da resposta. Se a resposta for um arquivo, este campo será uma string vazia.
status_code: Código de status http (por exemplo, 200, 404, 500).
headers: Cabeçalhos de resposta http como pares chave-valor.
file: Objeto de arquivo. Retornado apenas quando a resposta é um arquivo.