AI Personal Learning
and practical guidance
讯飞绘镜

AgentIQ: An open source tool for flexible connection and management of AI intelligences

General Introduction

AgentIQ is an open source tool from NVIDIA designed to help developers efficiently connect and manage AI intelligences. It enables intelligences from different frameworks to seamlessly collaborate, connect enterprise data and tools, and build workflows like calling functions. The tool's best features are flexibility and reusability, allowing developers to quickly develop, optimize, and reuse AI tasks. agentIQ provides performance analytics and a visualization interface for enterprises to build reliable AI systems. As of March 2025, the official documentation and GitHub page are the latest sources of information.

NVIDIA 发布 AI-Q 蓝图,连接 AI Agent 塑造未来工作模式-2


 

Function List

  • Support any framework: compatible with LangChain, LlamaIndex, etc., no need to change the technology stack.
  • Reusable design: Intelligentsia, tools and workflows can be reused, saving development time.
  • Rapid Development: Provides pre-built modules that developers can modify and use directly.
  • Performance analytics: tracking the runtime of each smartbody and token consumption and optimize efficiency.
  • Observability: Supports the OpenTelemetry tool for easy monitoring and debugging.
  • Evaluation system: built-in tools to validate workflow accuracy.
  • Chat Interface: Interact with intelligences through the UI to view results.
  • MCP Support: Compatible with Model Context Protocol, can call external tools.

 

Using Help

AgentIQ is a Python based open source tool , easy to install , suitable for developers to use . The following is a detailed description of the installation and operation.

Installation process

Before installing, make sure your computer has Git, Git LFS, and uv tools. Here are the steps:

  1. Cloning Codebase
    Enter it in the terminal:
git clone git@github.com:NVIDIA/AgentIQ.git agentiq
cd agentiq

This will download AgentIQ locally.

  1. Updating submodules
    Input:
git submodule update --init --recursive

Get dependent external modules.

  1. Download Dataset
    If example data is needed, run:
git lfs install
git lfs fetch
git lfs pull
  1. Creating a Python Environment
    Use uv to create a virtual environment:
uv venv --seed .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows
  1. Installation of core libraries
    Install AgentIQ and all optional dependencies:
uv sync --all-groups --all-extras

If only the core functions are loaded:

uv sync

Want to load specific plugins (e.g. LangChain):

uv pip install -e '.[langchain]'

Performance Analysis Dependencies:

uv pip install -e '.[profiling]'
  1. Verify Installation
    Check the version:
aiq --version

Displaying the version number is successful.

How to use the main features

After installation, you can start using AgentIQ. the following is a step-by-step guide to the core functionality:

Creating Workflows

AgentIQ calls intelligences and tools as functions. Define tasks with a YAML file. For example:

functions:
wikipedia_search:
_type: wiki_search
max_results: 2
llms:
nim_llm:
_type: nim
model_name: meta/llama-3.1-70b-instruct
temperature: 0.0
workflow:
_type: react_agent
tool_names: [wikipedia_search]
llm_name: nim_llm
verbose: true
retry_parsing_errors: true
max_retries: 3
  • Running:
aiq run --config_file workflow.yaml --input "列出五种土豚亚种"

The output will list the answers.

performance analysis

Monitor workflow performance:

aiq run --config_file workflow.yaml --profile

The results show the elapsed time and token usage for each smart body to help with optimization.

visualization interface

Launch the UI:

aiq ui

Open http://localhost:8000 in your browser, type in your question, and the intelligent body will answer it in real time.

data integration

Connect to the data source in the workflow.yaml Add in:

data_sources:
- type: "csv"
path: "data/sales.csv"

After running, the smart body can process the file data.

Assessment workflow

Verify accuracy:

aiq evaluate --config_file workflow.yaml

The system checks that the output is as expected.

Featured Function Operation

The highlights of AgentIQ are flexibility and observability. For example:

  • Multi-Intelligence Collaboration: Configure one intelligence to generate code, another to test it, and automatically adjust it until it passes.
  • adjust components during testing: Use the OpenTelemetry tool to see how each step is performing and identify problems.

To experience the full functionality, it is recommended to refer to the official example:

cd examples/simple
uv pip install -e '.[langchain]'
aiq run --config_file workflow.yaml

 

application scenario

  1. Automation Development
    Generate and test code with AgentIQ for rapid prototyping.
    One intelligence writes the code, the other runs the tests, and the results are output directly.
  2. Enterprise data processing
    Connect sales data and automatically generate analytical reports.
    Intelligentsia reads CSV files and outputs charts.
  3. Customer Support
    Configure intelligences to answer common questions and improve efficiency.
    Users enter questions through the UI and the smart body responds in real time.

 

QA

  1. Need an API key?
    Yes, an NVIDIA API key is required to run the examples, register for it at https://build.nvidia.com.
  2. What language models are supported?
    Support for multiple NIM models can be specified through a configuration file, e.g. Llama-3.1-70b.
  3. How do I give feedback on a problem?
    Submit issues at https://github.com/NVIDIA/AgentIQ/issues.
May not be reproduced without permission:Chief AI Sharing Circle " AgentIQ: An open source tool for flexible connection and management of AI intelligences
en_USEnglish