# openderisk | derisk-ai | Knowledge Base | Instagit

AI-Native Risk Intelligence Systems, OpenDeRisk——Your application system risk intelligent manager provides 7* 24-hour comprehensive and in-depth protection.

GitHub Stars: 864

Repository: https://github.com/derisk-ai/openderisk

---

## Articles

### [How to Use the Flame Graph Assistant for Performance Bottleneck Analysis in OpenDerisk](/derisk-ai/openderisk/how-to-use-the-flame-graph-assistant-for-performance-bottleneck-analysis)

Learn how to use the OpenDerisk flame graph assistant to analyze performance bottlenecks. Discover flamegraph_overview and flamegraph_drill_down tools for programmatic CPU profiling.

- Tags: performance
- Published: 2026-02-28

### [How to Construct DAG-Based Chat Flows Using the AWEL Flow Builder](/derisk-ai/openderisk/how-to-construct-dag-based-chat-flows-using-the-awel-flow-builder)

Learn to build DAG-based chat flows with the AWEL flow builder in OpenDeRisk. Visually design workflows by connecting nodes and serialize to JSON.

- Tags: how-to-guide
- Published: 2026-02-28

### [How Chat History Persistence Works in Derisk Agent Conversations](/derisk-ai/openderisk/how-does-chat-history-persistence-work-in-agent-conversations)

Learn how DeriskAgent chat history persistence works. Explore the three-layer architecture and database storage for complete conversation retrieval.

- Tags: internals
- Published: 2026-02-28

### [How to Build and Register Custom Tools for Agent Execution in OpenRisk](/derisk-ai/openderisk/how-to-build-and-register-custom-tools-for-agent-execution)

Learn to build and register custom tools for agent execution in OpenRisk. Define Python functions, decorate them with @system_tool, and expose them to LLMs for enhanced automation.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the OpenDerisk SQL Agent Generates and Executes Database Queries from Natural Language](/derisk-ai/openderisk/how-does-the-sql-agent-generate-and-execute-database-queries-from-natural-language)

Discover how the OpenDerisk SQL agent transforms natural language into executable SQL queries. Learn about its schema-aware LLM prompting, JSON parsing, and asynchronous database execution.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Apply Metadata Filtering in RAG Queries for Precise Results in OpenDeRisk](/derisk-ai/openderisk/how-to-apply-metadata-filtering-in-rag-queries-for-precise-results)

Unlock precise results with metadata filtering in OpenRAG queries. Learn how OpenDeRisk applies filters to RAG queries for accurate, targeted information retrieval.

- Tags: how-to-guide
- Published: 2026-02-28

### [BM25 vs Embedding-Based Semantic Retrieval in OpenRisk AI: A Technical Comparison](/derisk-ai/openderisk/how-does-the-bm25-retriever-compare-with-embedding-based-semantic-retrieval)

Compare BM25 keyword matching with embedding semantic retrieval in OpenRisk AI. Discover how our configurable retriever chain optimizes RAG performance for accurate and conceptual search.

- Tags: technical-comparison
- Published: 2026-02-28

### [How to Implement Cross-Encoder Reranking for Improved Retrieval Precision in OpenRisk](/derisk-ai/openderisk/how-to-implement-cross-encoder-reranking-for-improved-retrieval-precision)

Implement cross-encoder reranking in OpenRisk to reorder retrieved text chunks by predicted relevance. Improve retrieval precision before LLM generation with Sentence-Transformers.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the Document Tree Retriever Handles Hierarchical Document Structures in OpenDerisk](/derisk-ai/openderisk/how-does-the-document-tree-retriever-handle-hierarchical-document-structures)

Discover how the document tree retriever in OpenRisk maps H1-H6 levels to TreeNode objects for section-aware RAG retrieval by building a navigable tree from document hierarchies.

- Tags: internals
- Published: 2026-02-28

### [How the OpenDerisk Sandbox Code Agent Safely Executes Dynamically Generated Code](/derisk-ai/openderisk/how-does-the-sandbox-code-agent-safely-execute-dynamically-generated-code)

Learn how the OpenDerisk sandbox code agent safely executes dynamic code by isolating it in a resource-constrained subprocess using macOS sandbox profiles and strict filesystem controls.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Manage Flow Configurations Using the Flow CRUD Operations in OpenDeRisk](/derisk-ai/openderisk/how-to-manage-flow-configurations-using-the-flow-crud-operations)

Master OpenDeRisk flow configurations with CRUD operations. Learn to manage flow metadata and DAG structures using the derisk-client Python library for efficient data pipeline control.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Configure derisk-proxy-aliyun.toml for Secure API Access in OpenRisk](/derisk-ai/openderisk/how-to-configure-the-derisk-proxy-aliyun-toml-file-for-api-access)

Secure your API access by configuring derisk-proxy-aliyun.toml. Learn how to set environment variables and start the server for OpenRisk.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the OpenRisk Eval Framework Evaluates Agent Performance and Accuracy](/derisk-ai/openderisk/how-does-the-evaluation-framework-assess-agent-performance-and-accuracy)

Learn how the OpenRisk Eval framework assesses agent performance and accuracy. It uses a data-flow DAG to capture, score predictions, and return structured evaluation results.

- Tags: performance
- Published: 2026-02-28

### [How to Use the Derisk Embedding API for Vector Storage and Similarity Search](/derisk-ai/openderisk/how-to-use-the-embedding-api-for-vector-storage-and-similarity-search)

Learn how to use the Derisk embedding API for effortless vector storage and similarity search. Index documents and perform semantic retrieval with ease.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the OpenDerisk Knowledge CRUD API Manages Domain Knowledge](/derisk-ai/openderisk/how-does-the-knowledge-crud-api-work-for-managing-domain-knowledge)

Discover how the OpenDerisk Knowledge CRUD API effectively manages domain knowledge through create read update delete operations. Learn about its service layer, DAOs, and RAG integration.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Integrate Custom LLM Providers in OpenRisk: A Complete Guide](/derisk-ai/openderisk/how-to-integrate-custom-llm-providers-beyond-the-default-openai-configuration)

Integrate custom LLM providers in OpenRisk beyond OpenAI with this guide. Implement the LLMProvider class and register it for seamless discovery by LLMClient.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Use AWEL (Agentic Workflow Execution Language) for Building Complex Agent Workflows](/derisk-ai/openderisk/how-to-use-awel-agentic-workflow-execution-language-for-building-complex-agent-workflows)

Learn to build complex agent workflows using AWEL Agentic Workflow Execution Language. Derisk's powerful engine transforms graphs into asynchronous DAGs for type-safe, extensible agent pipelines.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the DeepResearch RCA Engine Analyzes Logs, Traces, and Code to Locate Root Causes](/derisk-ai/openderisk/how-does-the-deepresearch-rca-engine-analyze-logs-traces-and-code-to-locate-root-causes)

Discover how the DeepResearch RCA engine uses ReAct reasoning to analyze logs, traces, and code for pinpointing system failure causes. Get precise root cause analysis.

- Tags: deep-dive
- Published: 2026-02-28

### [How to Create Custom Agents Using the OpenDerisk Agent Development Framework](/derisk-ai/openderisk/how-to-create-custom-agents-using-the-agent-development-framework)

Learn to create custom agents in OpenDerisk by subclassing ConversableAgent or ManagerAgent. Define profiles, prompts, and register actions to build powerful AI tools with our framework.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Configure and Manage Different Data Sources in OpenDerisk](/derisk-ai/openderisk/how-to-configure-and-manage-different-data-sources-in-openderisk)

Master OpenDerisk data source configuration and management. Learn how to use polymorphic dataclasses and the ConfigurationManager to easily integrate diverse data sources.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the OpenRisk RAG System Implements Knowledge Retrieval and Supports Multiple Embedding Models](/derisk-ai/openderisk/how-does-the-rag-system-implement-knowledge-retrieval-and-what-embedding-models-are-supported)

Discover how the OpenRisk RAG system uses a two-stage retrieval process and see which embedding models it supports including HuggingFace and OpenAI.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Integrate Custom MCP Tools and Services with OpenDerisk](/derisk-ai/openderisk/how-to-integrate-custom-mcp-tools-and-services-with-openderisk)

Learn to integrate custom MCP tools and services with OpenDerisk using the addMCP API and startMCP. Expose your tools to AI agents via the Connectors Modal.

- Tags: how-to-guide
- Published: 2026-02-28

### [OpenDerisk Multi-Agent Architecture for Root Cause Analysis: How Five Specialized Agents Collaborate](/derisk-ai/openderisk/how-does-openderisks-multi-agent-architecture-sre-agent-code-agent-reportagent-vis-agent-data-agent-collaborate-for-root-cause-analysis)

Discover how OpenDerisk's multi-agent architecture uses 5 specialized agents for autonomous root cause analysis. Learn about SRE-Agent, Code-Agent, ReportAgent, Vis-Agent, and Data-Agent collaboration.

- Tags: architecture
- Published: 2026-02-28