NVIDIA Developer ★ 90 5 min

Build Applications on NVIDIA BlueField Faster with NVIDIA DOCA Agent Skills

Agentic AI / Generative AIData Center / CloudDeveloper Tools & TechniquesAgent SkillAI Agent

🔗 https://developer.nvidia.com/blog/build-applications-on-nvidia-bluefield-faster-with-nvidia-doca-agent-skills/

📌 NVIDIA DOCA Agent Skills:讓通用AI代理學會DPU開發

TL;DR:NVIDIA開源SKILL.md格式,用65個真實任務測試,無技能時正確率僅19%,有技能後達100%。

想像你讓AI agent幫你寫BlueField DPU程式碼,結果它自信滿滿地呼叫一個根本不存在的函式。這不是偶發bug,而是NVIDIA在65個真實任務測試中,有59個都出現的狀況。

🤔 背景:通用agent為何在DOCA開發上失準

通用AI agent是基於pattern-matching從訓練資料生成答案,而非DOCA真實的API contract、硬體能力manifest或build system規格。DOCA的library範圍大、更新快、且與特定硬體緊密綁定,這些細節並不在一般訓練資料裡。沒有machine-readable的contract可供agent推理,agent所知道的與硬體、軟體實際支援的之間,也沒有穩定的介面保證。

🧩 架構:SKILL.md開放格式

DOCA AI agent skills圍繞一份輕量、開放的SKILL.md檔案,內含真實的API函式簽章、正確的pkg-config模組名稱、build container限制,以及常見失敗模式與對應的解法。技能涵蓋整個DOCA library,包括Flow、GPUNetIO、PCC等元件。每個技能scope到特定DOCA元件或workflow,agent載入後取得的不只是文件摘要,而是可以直接推理的machine-readable規格。這些skill不會取代agent本身,而是賦予它如同資深DOCA開發者般的領域知識。

📊 數據:65個真實提示詞的測試結果

NVIDIA team執行了65個真實的DOCA開發者提示詞,比較有無skills的agent表現,並以required-answer checklist(每項任務的pass/fail標準清單)評分。無skills時,agent常見的錯誤包括:

  • API誤用(函式、旗標、image tag皆有誤):59/65
  • 未驗證硬體能力:46/65
  • 錯誤的工具路由:39/65
  • 跳過smoke test:34/65
  • 猜測版本號:30/65

整體而言,無skills時agent只滿足19%的checklist項目;有skills時則在全部65個提示詞上都達到100%。

💡 四種實務場景的具體效果

文章舉出四個案例。第一,用真實API加速開發:面對設定DOCA Comch(Comm Channel)通道的提示,有skills的agent只使用真實存在的API呼叫、正確的參數順序與驗證過的旗標,不發明任何東西,這類API準確度的測試涵蓋63個提示詞,有skills版本每次表現都較佳。第二,寫程式前先驗證硬體:面對「測量從CUDA kernel發起RDMA WRITE延遲」的提示,有skills的agent會先確認GPU與NIC之間的PCIe拓樸、確認GPUNetIO是否支援,再決定要不要寫程式,而非事後才在真實硬體上發現不相容。第三,確保程式碼能編譯連結:針對DOCA Flow範例編譯失敗(undefined reference to doca_flow_init)的情境,有skills的agent能正確判斷這是連結時期錯誤,並用pkg-config查出doca-flow對應的正確連結旗標。

⚠️ 限制

素材僅提供NVIDIA自行執行的65組提示詞評估,獨立第三方複現的結果未提及;skills目前涵蓋範圍以DOCA函式庫為主,是否能擴展到其他NVIDIA平臺的agent開發流程,素材並未說明。

🎯 實務啟示

若團隊已經在用AI agent輔助DPU/DOCA開發,導入這些開源skills等於是替agent加裝一份「資深工程師的checklist」,省下的是每一次debugging corrections的時間。這種「把文件轉成machine-readable規格」的做法,也值得其他垂直領域的infra團隊參考:與其等agent犯錯後再修正,不如把API contract、硬體能力、build constraint整理成agent能直接推理的格式。

🔗 來源

#NVIDIA #DOCA #BlueField #DPU #AIAgent #AgentSkills #InfrastructureAsCode #DeveloperTools #GPUNetIO #EdgeComputing

原始資料 NVIDIA Developer · 收集於 2026-10-01
來源原標題
Build Applications on NVIDIA BlueField Faster with NVIDIA DOCA Agent Skills
作者
Tanya Lenz
原始標籤
Agentic AI / Generative AI · Data Center / Cloud · Developer Tools & Techniques · Agent Skill · AI Agent
原始連結
https://developer.nvidia.com/blog/build-applications-on-nvidia-bluefield-faster-with-nvidia-doca-agent-skills/

摘要原文

AI agents are becoming a standard part of development workflows, but general-purpose agents weren’t built with specialized infrastructure software such as NVIDIA DOCA in mind. Without domain-specific knowledge, agents may fall back on guesswork. This is an issue in infrastructure development because every correction cycle takes time away from deployment. DOCA is the unified software platform that unlocks the full potential of NVIDIA BlueField data processing units (DPUs) for agentic AI infrastructure. It spans accelerated networking, AI-native storage, in-silicon security , telemetry, and lifecycle management. It’s the development platform for teams building on NVIDIA BlueField. DOCA AI agent skills are now available on GitHub. These skills provide a structured, verified foundation to address where general-purpose AI agents fall short on DOCA development. They provide agents with verified API signatures, hardware capability requirements, and build constraints. This post explains what DOCA AI agent skills are and how they perform across four impactful DOCA development scenarios. It includes a side-by-side demo and how to get started using DOCA agent skills to build faster and ship more stable code on BlueField infrastructure. What are DOCA AI agent skills? DOCA AI agent skills are a standardized way to give AI agents new capabilities and expertise. The lightweight, open format is built around a SKILL.md file containing real API signatures, hardware capability requirements, and build constraints. Together, the skills provide agents with a reasoning and operational framework for DOCA. Skills span the full DOCA library, including Flow, GPUNetIO, PCC, and more. They don’t replace the agent, but give it the domain knowledge to reason like an experienced DOCA developer. Each skill is scoped to a specific DOCA component or workflow. When an agent loads a skill for DOCA Flow, for example, it gets the real function signatures, the correct pkg-config module names, the build-container constraints, and the common failure modes and their mitigations. The skills are not just a summary of documentation, but a machine-readable specification the agent can reason against directly. Why do AI agents need a foundation for DOCA development? When you ask a general-purpose AI agent to set up a DOCA Comch (Comm Channel), configure an RDMA context, or debug a link failure in a DOCA Flow program, the agent is working from pattern-matching across general training data—not from verified DOCA API contracts, hardware capability manifests, or build system specifications. The DOCA library surface is large, rapidly evolving, and hardware-specific in ways that general training data does not capture. There is no machine-readable contract for agents to reason from, no guaranteed stable interface between what the agent knows and what the hardware and software actually support. To quantify the gap, the NVIDIA team ran 65 real DOCA developer prompts comparing agent performance with and without the skills. These prompts ranged from a one-line question to detailed multi-requirement prompts, graded against a required-answer checklist (a specific set of pass/fail criteria for each task). Without the skills, agents consistently made the same mistakes, including: Misuse of APIs and flags : 59/65 prompts Hardware capability not verified : 46/65 prompts Wrong tool routing : 39/65 prompts Skipped smoke tests : 34/65 prompts Guessed versions : 30/65 prompts These are consistent failures. Without skills, agents satisfied only 19% of graded checklist items on real DOCA tasks. With skills, they satisfied 100% across all 65 prompts. Without the skills, every agent mistake becomes a developer debugging session, and a longer path to working code. What are the benefits of DOCA agent skills for developers? DOCA agent skills allow you to equip agents with domain expertise. This means you can build faster, ship more stable code, and deploy with fewer unknowns. Build faster: Skills give the agent verified API calls from the start, so you can focus on writing code, not corrections. Ship more stable code: With skills, the agent checks what the device actually supports before writing a single line, not after running it on real hardware. Deploy with fewer unknowns: The agent applies preflight checks, rollback plans, and cold power-cycle awareness before touching hardware, not after something goes wrong. The combined effect is fewer correction cycles between task and working code. For teams using AI agents on DOCA applications at scale, that reduction compounds across every developer, task, and deployment. Use agent skills to accelerate DOCA development Each of four capabilities are detailed in the following sections. Each capability is illustrated with a real prompt from our 65-prompt evaluation and the benefits of using the skill. Build faster with real APIs What DOCA AI agent skills address: Misuse of APIs: agents inventing functions, flags, and image tags that don’t exist. This was the most frequent failure mode in our evaluation, affecting 59 of 65 prompts. Without skills, agents generate code referencing DOCA functions that don’t exist in the library, flags with incorrect names, and image tags that fail at runtime. As the developer, you end up debugging an error you didn’t introduce (the agent’s invention). Prompt: “I have a host with a BlueField-3 DPU and DOCA installed. I want to set up a DOCA Comch (Comm channel) between a host-side process and a DPU-side agent so they can exchange small control messages (under 4 KiB each, a few times per second).” The AI agent with skills uses only real DOCA Comch API calls: correct argument order, verified flags and lifecycle sequence, nothing invented. When the agent’s first response uses the correct API surface, you can move directly to integration rather than starting with a debugging session. Across 63 prompts that tested API accuracy, the with-skills result was better every time. Verify hardware before writing any code What DOCA AI agent skills address: Agents writing code for features the device doesn’t support. Hardware capability verification was missed in 46 of 65 prompts without skills. The failure pattern is consistent: the agent assumes a capability is present, generates code against it, and the developer discovers the mismatch only when running on real hardware. At that point, the fix requires understanding which capability check was skipped, reworking the code path, and retesting. Prompt: “I have two hosts wired together with a high-speed InfiniBand fabric. Each host has one NVIDIA GPU and one ConnectX NIC, and DOCA is installed on both. I want to measure the latency of an RDMA WRITE work request when the WR (work request) is posted from a CUDA kernel on the GPU (not from a host CPU thread) so I can decide whether to commit my application to the GPUNetIO Verbs interface.” The AI agent with skills checks what the device actually supports before writing any code. It verifies GPU-NIC PCIe topology, confirms GPUNetIO support before committing, and names alternative API surfaces and when each applies. The AI agent with skills validates the preconditions for the answer against the actual hardware in use, before any code is written. Ship code that compiles and links What DOCA AI agent skills address: Agents producing code that won’t compile or link in the DOCA container. Build correctness was tested on 10 of 65 prompts. This is a smaller subset, but when it applies, development cannot proceed. Prompt: “I’m trying to build a DOCA Flow program from one of the shipped samples. The compile step works but the link fails: undefined reference to doca_flow_init. How do I debug this?” The AI agent with skills identifies the undefined reference as a link-time failure, uses the build tool (pkg-config) to look up the correct linker flags for doca-flow. An agent that generates an incorrect linker flag sends the developer down a path that won’t resolve.

由 claude-code/sonnet 自動生成