Report Agent

The Report Agent is an advanced intelligence assistant designed to transform large volumes of unstructured information into professional, coherent documents ready for distribution. This agent doesn’t just write text; it organizes information into a logical hierarchy of sections and tasks, ensuring the final output meets technical or executive standards.

Unlike a standard text generator, this agent separates the content creation process from data formatting, allowing for superior structural precision by using a dedicated formatter model.

Main Use Cases

Use the Report Agent to develop solutions requiring:

Technical Reports: Generation of detailed documentation based on system logs or audits.
Executive Summaries: Consolidation of meetings or transcripts into key action points.
Performance Reports: Analysis of metrics with structured visualization of results.
Multilingual Documentation: Automatic creation of reports in different languages (e.g., ‘es’, ‘en’) for global teams.

Fundamental Configuration (Common)

These parameters define the core of the report, its purpose, and the agent’s identity.

Parameter	Technical Description	Purpose in the Flow
`Request`	The input message or data that triggers the generation.	Provides the base context or information to be analyzed and reported.
`Report Title`	Main title that will head the generated document.	Establishes the report’s subject for quick identification.
`Instructions`	Specific guidelines on tone, key points, and style.	Defines the business rules and requirements the agent must strictly follow.
`Language`	Language code for writing (e.g., `es`, `en`, `fr`).	Ensures the report is generated in the language required by the recipient.
`Output Format`	Final file format (e.g., `PDF`, `Markdown`, `HTML`).	Determines how the report will be delivered for viewing or downloading.
`Report Type`	Report category (e.g., `technical_report`, `summary`).	Adjusts the agent’s behavior towards a technical structure or an executive synthesis.

Advanced Features (Advanced)

Granular controls to manage document complexity and model performance.

Structure and Content (Extra)

Max Report Sections: Limits the maximum number of main headings the report will have (e.g., 3 sections). Prevents the document from becoming excessively long.
Max Tasks Per Section: Defines how many sub-points or detailed tasks each section can contain (e.g., 2 tasks). Useful for maintaining conciseness.

Performance and Metrics (Performance)

Show Metrics Section: If enabled (Toggle ON), the agent will include a metrics section at the end of the report regarding the generation (tokens, time, accuracy).
Enable Binary Data: Allows the agent to handle and process binary data if the report requires attaching or analyzing non-textual files.
Max Iterations: Sets the limit of reasoning cycles (e.g., 35) the agent can use to refine the report before finalizing.

AI Connectors and Memory

Model: External connections to separate creative writing (Model) from structured data extraction (Model Formatter).
Use Memory: Enables saving the agent’s state so it can reference previous reports or context within the same session.

Component Outputs

Report: The final message containing the report formatted according to the selected parameters.
Agent: A compiled graph (CompiledGraph) to integrate this report agent into a multi-agent architecture.
Tool: Version of the agent as a tool (BaseTool), allowing other agents (such as a Supervisor) to request report creation automatically.

Tips and Best Practices

Specify the Format: If you need the report for a website, select HTML. If it’s for a technical repository, Markdown is the best choice.
Clear Instructions: In the Instructions field, use numbered lists to prioritize which sections are mandatory.
Cost Control: Adjust Max Iterations to a lower value (e.g., 15-20) if the report is simple, to save language model resources.

You can watch a video showing the power of the Report Agent here.