NVIDIA NeMo Agent Toolkit

repository·develop·Indexed 25 days ago

https://github.com/nvidia/nemo-agent-toolkit

A framework-agnostic toolkit designed to add intelligence, observability, and optimization to AI agents. It provides enterprise-grade instrumentation and performance primitives that work alongside existing frameworks such as LangChain, LlamaIndex, and CrewAI. The toolkit supports Agent-to-Agent (A2A) workflows, including secure communication via OAuth 2.1 Authorization Code Flow and per-user workflow patterns for isolation and state management.

Tokens
419.3K
Snippets
992
Records
1.7K
Agent score
82%

What's inside NVIDIA NeMo Agent Toolkit

  1. Overview of the Dynamo Monitoring Stack

    develop

    The Dynamo Monitoring Stack provides a Prometheus and Grafana setup for monitoring the Dynamo LLM inference stack with a Thompson Sampling router. It collects metrics at a 2-second resolution directly from the ai-dynamo Prometheus API to provide per-request granularity.

    Note: This integration is EXPERIMENTAL. It requires Dynamo >= 1.1.0. In these versions, dynamo.sglang normalizes request priority (higher values = higher priority) and rejects the --schedule-low-priority-values-first flag.

  2. Overview of the NeMo Agent Toolkit Profiler

    develop

    The Profiler Module provides profiling and forecasting for workflows. It instruments workflow execution to:

    • Collect real-time usage statistics via callbacks.
    • Record per-invocation statistics (e.g., tokens used, time between calls, LLM calls).
    • Store data for offline analysis.
    • Forecast usage metrics (e.g., tokens, tool usage) using time-series models like Linear or Random Forest.
    • Compute performance metrics such as latency, throughput, bottlenecks, and concurrency spikes.

    This allows developers to stress test workflows in pre-production and receive sizing guidance based on observed performance.

  3. Overview of the Configuration Optimizer Subpackage

    develop

    The nvidia_nat_config_optimizer subpackage is designed for workflow configuration and prompt optimization within the NeMo Agent Toolkit. It provides specialized components located under the nat.plugins.config_optimizer namespace.

    Key capabilities include:

    • GA Prompt Optimization: Using Genetic Algorithms (GA) to optimize prompts.
    • Optuna-based Parameter Optimization: Utilizing the Optuna framework to optimize workflow parameters.
  4. Overview of Agno Personal Finance workflow

    develop

    The Agno Personal Finance workflow is a beginner-level implementation that integrates the Agno multimodal agent library with the NVIDIA NeMo Agent Toolkit.

    Key Capabilities:

    • Personalized Planning: Generates tailored budgets, investment strategies, and savings goals using NVIDIA NIM models.
    • Automated Research: Uses the SERP API to perform real-time market research and gather financial data.
    • Multi-Framework Architecture: Combines Agno's model-agnostic agent capabilities with NeMo Agent Toolkit's workflow management and tool integration system.
  5. Overview of the Alert Triage Agent use case

    develop

    The alert_triage_agent is an intermediate-complexity agentic system designed to automate the triage of server-monitoring alerts. It uses an event-driven design to autonomously investigate alerts without human prompting.

    Core Capabilities

    • Autonomous Investigation: Analyzes incoming alerts to identify types and affected hosts.
    • Dynamic Tool Selection: Selects from a multi-tool diagnostic framework including IPMI (hardware), host performance (CPU/memory), process monitoring, network connectivity, and telemetry analysis.
    • Iterative Reasoning: Correlates data from multiple sources to determine root causes.
    • Structured Reporting: Generates markdown reports containing alert summaries, collected metrics, analysis, recommended actions, and root cause categorization (e.g., hardware, software, network).
    • Maintenance Awareness: Integrates with maintenance databases to filter out alerts caused by scheduled events.
  6. Overview of Automated Description Generation Workflow

    develop

    The Automated Description Generation Workflow is a beginner-level workflow designed to enhance RAG (Retrieval-Augmented Generation) services. It builds upon the RAG service to automatically generate intelligent descriptions for collections within a Vector Database (currently focused on Milvus).

    These descriptions are used by the multi-query collection tool to improve retrieval accuracy across multiple collections by providing better context for document retrieval. The workflow uses a map-reduce summarization approach: it retrieves documents using dummy embeddings, generates local summaries via an LLM, and then uses map-reduce techniques to produce a final collection description.

  7. Overview of NeMo Agent Toolkit Finetuning Harness

    develop

    The NeMo Agent Toolkit provides a finetuning harness for in-situ reinforcement learning of agentic LLM workflows. This allows you to iteratively improve agents by training them on the same workflows used in production, enabling them to learn from interactions with environments, tools, and users.

    Core Principles

    • Decoupled Architecture: Training logic is separated from backends, supporting various RL frameworks (e.g., OpenPipe ART, NeMo Aligner).
    • In-Situ Training: Agents are trained within their production-like workflow environment.
    • Flexible Targeting: You can finetune specific functions or entire workflows.
    • Composable Components: The system uses three pluggable components: TrajectoryBuilder, TrainerAdapter, and Trainer.
  8. Overview of Dynamo Backend Integration

    develop

    Dynamo is NVIDIA's high-performance LLM serving platform featuring KV cache optimization. The NeMo Agent Toolkit integration provides two main capabilities:

    1. Dynamo LLM Support: Implementation of DynamoLLM (located in packages/nvidia_nat_core/src/nat/llm/dynamo_llm.py) to enable NeMo Agent Toolkit inference on Dynamo runtimes.
    2. Scalable Startup Scripts: A set of scripts designed for NVIDIA Hopper and Blackwell GPU servers to run NeMo Agent Toolkit runtimes at scale.
  9. Overview of the Simple LangSmith-Documentation Agent

    develop

    This beginner-level example demonstrates a Retrieval-Augmented Generation (RAG) agent designed to answer questions about LangSmith documentation.

    Core Components:

    • Webpage Query Tool: A tool that scrapes documentation from https://docs.smith.langchain.com and uses vector search to retrieve information.
    • ReAct Agent: A react_agent that uses reasoning to decide when to call the web query tool.
    • Document Retrieval & Embedding: Automatically generates embeddings from scraped web content for semantic search.
    • Configuration: The entire workflow (scraping, embeddings, and agent reasoning) is managed via a YAML-based configuration file.
  10. Overview of nvidia-nat-config-optimizer

    develop

    The nvidia-nat-config-optimizer is a tool for workflow configuration and prompt optimization within the NVIDIA NeMo Agent Toolkit. It uses genetic algorithms and numeric optimizers (via Optuna) to optimize configuration-level values, such as hyperparameters and prompts.

    Note: This tool is scoped strictly to configuration-level optimization; it does not handle runtime or inference optimizations.