You need to enable JavaScript to run this app.
DataAgent (OnPremise)

DataAgent (OnPremise)

Copy page
Download PDF
Use Intelligent Analysis Agent
Knowledge Document Configuration
Copy page
Download PDF
Knowledge Document Configuration

In deep research Agent usage scenarios, the product also provides features such as online search and knowledge document configuration. This article introduces the knowledge document configuration feature.

Feature overview

Knowledge documents serve as the dedicated knowledge hub for deep research Agent, supporting the upload of enterprise private documents. Through intelligent matching and structured extraction, internal knowledge is accurately injected into the analysis process. This complements online search, ensuring that research conclusions are both timely and business-relevant.
Knowledge documents are categorized into three types: business knowledge, analysis templates, and analysis reports. The following is a comparison of these three types of knowledge.

Detailed comparison items

Business knowledge

Analysis template

Analysis report

Knowledge content

Essential background knowledge and definitions required for daily business operations, which help the model interpret data more accurately.
For example: indicator definition descriptions, activity event configuration, and business process specifications.

Standard analytical approaches or steps for similar business issues, used to guide the model in breaking down problems.
For example: order volume fluctuations → analyze the causes step by step by channel, user type, and time distribution.

Completed business analysis results, including historical data, conclusions, and insights, for reuse and reference.
For example: analysis report on marketing campaign effectiveness for the previous quarter.

Recall mechanism

Recall at the chunk level, supporting efficient vector matching.

Full recall to ensure structural completeness; only one template is allowed.

Automatically extract the framework structure and align according to structural logic during recall.

Caution

It is recommended that business knowledge be written in a structured and segmented manner to improve recall granularity and quality.

None

In privatized scenarios, the analysis report knowledge type is disabled by default. To use this feature, contact Volcano Engine technical support personnel.

Knowledge examples

See the following section: Knowledge example: Business knowledge.

See the following section: Knowledge example: analysis template.

See the following section: Knowledge example: analysis report.

Usage restrictions
  • Supported local file types for upload: txt, md, doc, docx, ppt, pdf, xlsx, xls, csv.
  • The maximum size for local files is 100 MB.

Applicable scenarios

Scenario types

Typical use cases

Precise knowledge Q&A

Consult specific product standards, service processes, or business rules, and directly return knowledge fragments with sources.

Automatic report generation

Generate new reports by invoking historical analysis templates and reusing mature structures.

Scenario-based research

Focus on a specific type of issue (such as "customer complaint analysis"), only invoking related documents and blocking interference from irrelevant information.

Knowledge configuration

Upload knowledge

  1. In the agent list, select the agent that requires knowledge document configuration, and click "Agent configuration" to enter the agent configuration page.

Image

  1. Click "Knowledge configuration", select "Add knowledge", enter the knowledge name, upload the knowledge file, and then click "Save" to enable the knowledge document feature.

Image

Parameters

Configuration instructions

Knowledge name

Customize the knowledge name. The knowledge name should preferably cover core keywords to facilitate subsequent retrieval. The agent also supports automatic identification of the knowledge type based on the knowledge name. The naming format and the corresponding identified knowledge type are as follows.

  • BUSINESS_KNOWLEDGE_core keywords of knowledge: Business knowledge.
  • ANALYSIS_TEMPLATE_知识核心关键词: Analysis template.
  • ANALYSIS_REPORT_知识核心关键词: Analysis report.

Knowledge sources & files

Currently, knowledge sources only support uploading local files. You can click the "Upload file" button and follow the interface prompts to select and upload a local file that meets the format requirements.

Knowledge classification

Select the classification method for the currently uploaded knowledge. Supported options:

  • Automatic classification (default): The agent automatically parses the uploaded knowledge and applies classification tags.
  • Manual classification: You manually select the type of the current knowledge. This feature is supported starting from version 3.3.0.

tip

Currently, three types of knowledge can be selected: business knowledge, analysis templates, and analysis reports (the analysis report type is disabled by default in privatized scenarios; to use this type, the feature switch must be enabled separately). For a comparative introduction to the support for these three types, please refer to the Feature overviewsection above.

Image content parsing

Select whether to parse image content in the uploaded document and extract it as knowledge. If image parsing is required, the time needed to extract knowledge content will be extended.

  1. Users can click the dialog box to select a built-in question, or directly enter a question related to the knowledge document.

    Natural language inquiry

    Quickly view recommended questions

    Image

    • The agent's main use is to allow users to directly describe their in-depth research needs in text.

    Image

    • Recommended questions are provided below the dialog box. Users can click any recommended question to ask directly.
    • Recommended questions are automatically generated based on users' historical queries and can also be customized. For specific configuration methods, see Overview of the Creation and Configuration Process.

Knowledge reclassification/editing/deletion

After uploading and configuring knowledge, you can click the edit or delete button next to the knowledge to edit or delete it. When editing knowledge, you can reclassify and tag the knowledge, or modify the knowledge name and other configuration parameters.
Image
Image

Reference: Knowledge examples

Knowledge example: Business knowledge

Upload a sample knowledge document, "Consumer Behavior Analysis 5W2H Model.docx", for the agent. If a user asks "Analyze this year's consumer behavior using the Consumer Behavior Analysis 5W2H Model", the agent will automatically identify and use this business knowledge to generate a new report.

Consumer Behavior Analysis Framework.docx
Unknown size

Business knowledge entered

Report content generated by the agent

  • 5W2H model:
    • Who (audience profile): age, gender, region, income level, consumption preferences (for example, parent and infant groups focus on safety certification);
    • What (product category): frequently purchased necessities (grain and oil) vs. infrequently purchased durable goods (home appliances);
    • Why (consumption motivation): functional needs (such as phone battery life) vs. emotional needs (brand loyalty);
    • When (consumption time): seasonality (summer cold drinks), scenario-based (late-night delivery);
    • Where (consumption channel): online platforms (Taobao / Douyin) vs. offline channels (convenience stores / shopping centers);
    • How (consumption method): impulsive consumption (flash sales during live streams) vs. rational decision-making (using price comparison apps);
    • How much (consumption amount): average transaction value, repurchase rate, customer lifetime value (LTV).

Image

  • Store miscellaneous content such as rule manuals and scenario guides used in daily operations.
  • Adopt a pre-screening→sorting→focusing recall strategy: first match 30 relevant text fragments, then use AI sorting to retain only the content from the top 3 documents with the highest relevance, avoiding information fragmentation.

Knowledge example: analysis template

Template usage

Upload sample knowledge of "All activity review and analysis report template for the first quarter of this year.pdf" to the intelligent agent. When a user asks for "All activity review and analysis report for the first quarter of this year," the intelligent agent will automatically generate a new report based on the overall report framework and analysis template requirements from the sample knowledge.

Template for the Review and Analysis Report of All Activities in the First Quarter of This Year.pdf
Unknown size

Input analysis template requirements

Report content output by the agent

Overall contribution and trends of Q1 activities

  • Analysis objective: Provide an overview of the total value and performance rhythm generated collectively by all activities in the first quarter
  • Specified charts/presentation methods:
    • Use indicator cards to display the cumulative contributions of all activities during Q1 in terms of sales revenue, order volume, number of users who placed orders, proportion of new customers, and average order value.
    • Use a line chart to show the daily changes in sales revenue and order volume during Q1, reflecting the impact of activities on quarterly performance.
  • Module summary: Summarize the overall business scale achieved through activities in Q1 and describe the overall trend of activity effectiveness within the quarter (for example, whether there are significant peaks corresponding to key activity milestones).

Image

  • Store standardized analysis templates (such as industry report structures, and research models).
  • When a user initiates a report writing task, the system will apply all matched framework content to enforce systematic output.

Template writing

Template structure requirements

Template structure

Detailed requirements

Analysis objective

First, clearly identify the core problem to be solved or the goal to be achieved. It is necessary to clearly state the analysis scenario, analysis role, and analysis objective in one or two sentences. This is usually described in the first section of the template.

Analysis subjects

Refers to the key elements such as metrics and dimensions that need to be further analyzed to achieve the analysis objectives. To ensure the accuracy and validity of the analysis results, the following core information must be clearly defined when handling analysis tasks:

  • Metric definition: For DataAgent, metric definition refers to the combination of [dataset] + [metric field] + [filter criteria];
    • When there are multiple datasets or datasets containing multiple similarly named metric fields, it is recommended to specify the dataset and metric field used whenever possible;
    • Filter criteria often contain "domain-specific knowledge" (that is, specialized understanding or rules in a particular field), and this information needs to be clearly provided; otherwise, it may lead to analysis bias.
  • Data collection cycle: The time range of the data is critical for interpreting analysis results. Different analytical methods may have varying requirements for the cycle, which must be specified according to specific needs, such as:
    • Trend analysis: It may be necessary to clarify whether the cycle for trend analysis is the past 7 days, 30 days, or 3 months, and so on;
    • Attribution analysis: The cycle for comparing the baseline period and the comparison period must be specified, such as the past 7 days versus last week, or the past month versus last month, and so on.
  • Changes in objects of analysis: As the analysis progresses, the objects of analysis may shift from the overall to the local, or from the original analytical metrics to related metrics. It is important to pay attention to and clarify changes in the objects of analysis within the query.

Analysis methods

When there are clear analytical expectations, the chosen analysis method should be specified directly in the template. Common analysis methods: descriptive statistics (calculating and comparing proportions, medians, means, and other statistical measures), attribution, anomaly detection, prediction, clustering, and more.

Output requirements

The quality of the output should focus on both content and form. Properly organizing insights and using appropriate data visualization can make conclusions clearer and easier to understand. Therefore, requirements for both content and form must be specified and clarified in the template.

tip

  • Problem description must be specific: Use concise language to describe the desired analysis, and make sure to clearly state the requirements. For example: Analyze customer distribution by segmenting customers according to age, and display the results using a pie chart.
  • Refine the problem: When the analysis task is relatively complex, it is recommended to break it down into several smaller steps and proceed gradually. It is advisable to use one sentence for each step and avoid writing everything together in a single block. If the steps are related, this should be explained and emphasized.
  • Make good use of Markdown: Use # to indicate headings, **bold** to emphasize, and use more blank lines, indentation, and bullet points to distinguish hierarchy, which helps the model understand the intent.
  • Emphasize when necessary: If repeated descriptions fail to return the corresponding fields or results, you can write it again separately to emphasize.
  • Remind to use tools: Currently, tools such as online search, Python, and business knowledge base are supported. You can require the model to use these tools.

Template structure example

# Analysis objectives
 Describe what you want to know in one sentence
# Data scope
Clearly identify which dataset/table to use and whether there are any restrictions (such as time/customer/product)
# Specified methods (if needed)
Are specific algorithms or tools used? Do you need to draw, predict, etc?
# Expected output
The conclusions, charts, attribution structures, etc. that you would like to see
# Role definition (if needed)
Not mandatory, but can enhance style consistency

Knowledge example: analysis report

Upload sample knowledge of "2025 new product promotion themed activity review and analysis report.docx" to the intelligent agent. When a user asks for "a review and analysis of last year's new product promotion themed activity," the intelligent agent will automatically extract the analysis template from the sample report, apply its analysis requirements, and generate a new report.

2025 New Product Promotion Theme Activity Review and Analysis Report.docx
Unknown size

Sample input analysis report

Report content output by the AI agent

In-depth analysis of new product promotion effectiveness

  • Analysis purpose: Focused evaluation of the core performance of the "New Product Early Purchase" campaign in driving sales of promoted products and user acceptance.
  • Content and presentation:
    • Performance of promoted products: A bar chart was used to display the names and category 2 classifications of the top 10 promoted products by sales amount. According to the results, the running shoes category performed exceptionally well, accounting for 6 out of the top 10 products. Among them, the "Cushioning Series B" had the highest sales amount, reaching 608,295.20 yuan.
  • Module summary: The "New product early purchase" campaign has achieved certain results in driving sales of featured products. Running shoes are the core featured product and have performed exceptionally well.

Image

  • Store completed comprehensive business analysis cases (such as market research, activity reviews, and more).
  • When users need to reference historical experience or methodologies, the system will automatically extract the analysis template section from the report for structured recall, ensuring the output is logically coherent.

Special statement

(1) All content output by this service is generated by artificial intelligence models.
(2) This feature is intended only for customers' internal, proprietary business, and personal use. Customers must not provide generative artificial intelligence services to the public via the data intelligent agent.
(3) This product supports both SaaS and on-premises deployment versions. For purchase or trial inquiries, please contact the sales staff for consultation.

Last updated: 2026.06.02 14:59:26