Forecast Agent-AI-Native Database Service(AIDBS)-阿里云帮助中心

Overview

Forecast Agent is a multi-agent AI deduction engine. You only need to provide a document, such as a news article, research report, or policy draft. The system then automatically performs the following steps:

Extracts people, organizations, events, and their relationships from the document to build a knowledge graph.
Generates digital agents with independent personas, memories, and behavioral logic based on the knowledge graph.
Places the agents into a simulation platform to run a simulation based on a specified topic.
After the simulation is complete, the system displays the potential outcomes of the event.

Use cases

Scenario	Description
Public opinion forecasting	Predict the potential public reaction and information spread after a new policy, product launch, or news report is released.
Key event deduction	Analyze potential turning points after a conflict escalates and identify key roles and influence paths.
In-depth interviews	After a simulation is complete, converse with the agents to understand how their stances and viewpoints have changed.

Access Forecast Agent

Log on to the Forecast Agent console.
If the tagline "Build your digital world deduction arena" appears at the top of the page, you are in the Forecast Agent workspace.

Note

Forecast Agent is a browser-based application and does not require a client installation.

Navigate the home page

The left side of the home page features a collapsible navigation pane with the following entries.

Navigation entry	Description
Sandbox	A list of all sandboxes you have created. Each sandbox can contain multiple deduction tasks.
Agent Groups	All available agent groups, including groups you create from your own documents and the sample groups provided by the system.
Deduction records	A history of all executed deductions.

The system provides sample groups that have already completed the entire process: document parsing, knowledge graph building, and agent generation. You can use these sample groups directly to start a deduction and experience the full workflow. If a sample group is deleted, it cannot be recovered, but the system will regenerate a new one on your next visit.

Deduction workflow

A complete deduction consists of five stages. The first two are preparation stages, and you complete the last three stages on the deduction details page.

Stage 1: Prepare an agent group

You can skip this step if you are using a sample group. To use your own documents, follow these steps to create an agent group:

In the left-side navigation pane on the home page, click Agent Groups. In the right pane, click Create Agent Group.
On the Create Agent Group page, enter a Name and an optional Description for the agent group, then click Next.
In the Add Files section, upload your documents. You can also paste text directly into the text box on the right.

Note
You can upload files in pdf, docx, txt, xlsx, csv, and markdown formats. The maximum file size is 50 MB.
After adding the documents, click Finish Creation. Wait for the system to parse the documents, then click Build Graph and Extract Agents at the bottom right of the page. The system will build a knowledge graph and generate agents with independent personas based on the documents.
When the group status changes to Ready, you can use the agent group to start a deduction.

Note

If you upload a scanned PDF or a poorly formatted document, the system may miss some segments during extraction. If failed segments exceed one-third of the total chunks, we recommend replacing the source file with a clearer version and re-uploading it to ensure the quality of the generated agents.

Stage 2: Create a sandbox and bind a group

In the left-side navigation pane on the home page, click Sandbox. In the right pane, click Create Sandbox.
On the Create Sandbox page, enter a Name and an optional Description for the sandbox, and then click Next.
In the Bind Agent Group section, select the agent group to bind, and then click Create Sandbox. You can also select Bind Later and bind a group later in the sandbox settings.

Stage 3: Start a deduction

In the left-side navigation pane on the home page, click Sandbox, and then click the sandbox you created.
In the Deduction Question area on the sandbox details page, enter your question, and then click Create Deduction in the upper-right corner of the page.
In the Configure Deduction Parameters dialog box, configure the simulation environment parameters, and then click Start Simulation.

Stage 4: Monitor the deduction

The Simulation Platform tab on the deduction details page is the main interface for monitoring the deduction.

It contains the following sections from top to bottom:

Scenario Discussion: Displays the running status of the simulation.
Control Bar: Displays the Pause Simulation and Stop Simulation buttons while the deduction is running.
Event Stream: Shows the real-time behavior of agents in the simulation.
Agents: Displays the personas of all agents participating in the deduction.
Agent Statistics: Shows the actions taken by agents in the simulation environment.
Log: Displays system output logs.

Stage 5: End the deduction

A deduction ends in one of two ways:

It ends automatically after reaching the target number of rounds.
You manually click Stop Simulation.

After the simulation ends, the system syncs the results to the knowledge graph in the background. A "Syncing graph" notification bar appears at the bottom of the page. After the notification disappears, you can click the Generate a report button.

Note

If a deduction's status changes to "Failed" during its run, the cause is usually that the deduction scale is too large (the number of agents multiplied by the number of rounds exceeds resource capacity). Reduce the agent group size or lower the target number of rounds and try again. If the issue persists, contact a system administrator.

Recommendations

Run multiple deductions with the same document: You can repeatedly start new deductions from the same agent group, each with different simulation settings and configurations.
Compare outcomes: Use the same agent group but change only the simulation settings. Run two separate simulations and compare the differences in agent responses.
Observe agent changes: After a simulation is complete, converse with an agent to understand how its stance and views have changed.

FAQ

Symptom	Possible cause	Solution
An agent group is stuck in the "Building graph" state for a long time.	The source document is large or the model response is slow.	Please wait. If there is no progress after 30 minutes, contact a system administrator.
The agent group is created, but many segments fail to process.	The source file quality is poor (for example, it is a scanned document or has a messy layout).	Upload a clearer source file and try again.
A deduction's status suddenly changes to "Failed" during the run.	The deduction scale is too large for the resource capacity.	Reduce the agent group size or lower the target number of rounds and restart the deduction. If the issue persists, contact a system administrator.
The deduction is finished, but the "Generate a report" button is unavailable.	The knowledge graph write-back process is not yet complete.	Wait for the "Syncing graph" notification at the bottom of the page to disappear, then try again.