Pengambilan pengetahuan - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Model bahasa skala besar tidak memiliki akses ke data pribadi. Alat pengambilan pengetahuan melakukan kueri terhadap basis pengetahuan Anda dan menyediakan hasilnya kepada model untuk menghasilkan jawaban yang lebih akurat.

Penggunaan

Tambahkan alat file_search dalam parameter tools dan tentukan ID basis pengetahuan Anda di vector_store_ids.

Sebelum menggunakan fitur ini, buat basis pengetahuan dan peroleh ID-nya (saat ini hanya satu ID yang didukung).

# Impor dependensi dan buat client...
response = client.responses.create(
    model="qwen3.5-plus",
    input="Introduce Bailian X1 phone",
    tools=[
        {
            "type": "file_search",
            # Ganti dengan ID basis pengetahuan Anda. Saat ini hanya satu yang didukung.
            "vector_store_ids": ["your_knowledge_base_id"]
        }
    ]
)

print(response.output_text)

Model yang didukung

Qwen-Plus: qwen3.5-plus, qwen3.5-plus-2026-02-15
Qwen-Flash: qwen3.5-flash, qwen3.5-flash-2026-02-23
Qwen sumber terbuka: qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3b
Hanya tersedia melalui Responses API. Model di wilayah Hong Kong tidak didukung.

Prasyarat

Dapatkan Kunci API dan konfigurasikan sebagai variabel lingkungan (akan ditinggalkan).
Buat basis pengetahuan dan peroleh ID-nya menggunakan salah satu metode berikut:
- Pembuatan melalui konsol: Buat basis pengetahuan di halaman basis pengetahuan Konsol Model Studio. Lihat langkah-langkah mendetail.
- Pembuatan melalui API: Buat basis pengetahuan menggunakan SDK. Lihat panduan Knowledge Base API.
  Jenis pencarian dokumen dan kueri data didukung. Tanggapan berupa gambar tidak didukung.
Lihat ID basis pengetahuan di halaman detail basis pengetahuan pada Konsol.

Mulai cepat

Kode di bawah ini memanggil alat pengambilan pengetahuan menggunakan Responses API, yang melakukan kueri terhadap basis pengetahuan yang ditentukan dan menghasilkan jawaban.

Ganti vector_store_ids dengan ID basis pengetahuan Anda.

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika tidak ada variabel lingkungan, gunakan: api_key="sk-xxx" (tidak disarankan).
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
)

response = client.responses.create(
    model="qwen3.5-plus",
    input="Introduce Bailian X1 phone",
    tools=[
        {
            "type": "file_search",
            # Ganti dengan ID basis pengetahuan Anda. Saat ini hanya satu yang didukung.
            "vector_store_ids": ["your_knowledge_base_id"]
        }
    ]
)

print("[Model Response]")
print(response.output_text)
print(f"\n[Token Usage] Input: {response.usage.input_tokens}, Output: {response.usage.output_tokens}, Total: {response.usage.total_tokens}")

Node.js

import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // Jika tidak ada variabel lingkungan, gunakan: apiKey: "sk-xxx" (tidak disarankan).
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.create({
        model: "qwen3.5-plus",
        input: "Introduce Bailian X1 phone",
        tools: [
            {
                type: "file_search",
                // Ganti dengan ID basis pengetahuan Anda. Saat ini hanya satu yang didukung.
                vector_store_ids: ["your_knowledge_base_id"]
            }
        ]
    });

    console.log("[Model Response]");
    console.log(response.output_text);

    const usage = response.usage;
    console.log(`\n[Token Usage] Input: ${usage.input_tokens}, Output: ${usage.output_tokens}, Total: ${usage.total_tokens}`);
}

main();

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.5-plus",
    "input": "Introduce Bailian X1 phone",
    "tools": [
        {
            "type": "file_search",
            "vector_store_ids": ["your_knowledge_base_id"]
        }
    ]
}'

Menjalankan kode di atas menghasilkan respons berikut:

[Model Response]
Based on the content in the knowledge base, the key product features include the following:

1. **Core features**: The product provides...
2. **Scenarios**: Applicable to...
3. **Technical attributes**: Based on...

...

[Token Usage] Input: 1568, Output: 1724, Total: 3292

Output streaming

Pengambilan pengetahuan melakukan pencarian semantik dalam basis pengetahuan, yang mungkin memerlukan waktu. Aktifkan streaming untuk mendapatkan hasil antara secara real-time.

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika tidak ada variabel lingkungan, gunakan: api_key="sk-xxx" (tidak disarankan).
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
)

stream = client.responses.create(
    model="qwen3.5-plus",
    input="Introduce Bailian X1 phone",
    tools=[
        {
            "type": "file_search",
            # Ganti dengan ID basis pengetahuan Anda. Saat ini hanya satu yang didukung.
            "vector_store_ids": ["your_knowledge_base_id"]
        }
    ],
    stream=True
)

for event in stream:
    # Respons model dimulai
    if event.type == "response.content_part.added":
        print("[Model Response]")
    # Cetak respons model secara streaming
    elif event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    # Respons selesai, cetak penggunaan Token
    elif event.type == "response.completed":
        usage = event.response.usage
        print(f"\n\n[Token Usage] Input: {usage.input_tokens}, Output: {usage.output_tokens}, Total: {usage.total_tokens}")

Node.js

import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // Jika tidak ada variabel lingkungan, gunakan: apiKey: "sk-xxx" (tidak disarankan).
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
});

async function main() {
    const stream = await openai.responses.create({
        model: "qwen3.5-plus",
        input: "Introduce Bailian X1 phone",
        tools: [
            {
                type: "file_search",
                // Ganti dengan ID basis pengetahuan Anda. Saat ini hanya satu yang didukung.
                vector_store_ids: ["your_knowledge_base_id"]
            }
        ],
        stream: true
    });

    for await (const event of stream) {
        // Respons model dimulai
        if (event.type === "response.content_part.added") {
            console.log("[Model Response]");
        }
        // Cetak respons model secara streaming
        else if (event.type === "response.output_text.delta") {
            process.stdout.write(event.delta);
        }
        // Respons selesai, cetak penggunaan Token
        else if (event.type === "response.completed") {
            const usage = event.response.usage;
            console.log(`\n\n[Token Usage] Input: ${usage.input_tokens}, Output: ${usage.output_tokens}, Total: ${usage.total_tokens}`);
        }
    }
}

main();

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.5-plus",
    "input": "Introduce the Alibaba Cloud Bailian X1 phone.",
    "tools": [
        {
            "type": "file_search",
            "vector_store_ids": ["your_knowledge_base_id"]
        }
    ],
    "stream": true
}'

Parameter

Parameter alat file_search:

Parameter	Wajib	Deskripsi
`type`	Ya	Harus berupa `"file_search"`.
`vector_store_ids`	Ya	Daftar ID basis pengetahuan (saat ini hanya satu yang didukung). Lihat ID di halaman detail basis pengetahuan pada Konsol atau peroleh saat pembuatan melalui API.

Penagihan

Penagihan mencakup:

Biaya pemanggilan model: Konten yang diambil ditambahkan ke prompt, sehingga meningkatkan jumlah token input. Penagihan mengikuti harga standar model (lihat Daftar model).
Biaya pemanggilan alat: Fitur basis pengetahuan saat ini gratis.