fornax-knowledge

Integrate Fornax AI Agent Ops platform SDKs for Prompt Hub, RAG retrieval, and trace observability.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill fornax-knowledge-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fornax-knowledge
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/fornax-knowledge
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill fornax-knowledge-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building AI applications requires managing prompts, knowledge bases, model calls, and observability across environments. This Skill provides the integration knowledge for ByteDance's Fornax AI Agent Ops platform, covering SDK setup, authentication, and usage patterns in Golang, Python, and Node.js. ## Core Features & Use Cases - Prompt as a Service: Pull published Prompt templates from Prompt Hub, render variables, and execute synchronously or via streaming in remote or local execution modes. - RAG Knowledge Retrieval: Query Fornax-managed knowledge bases with configurable channels, TopK, and score thresholds. - Trace Observability: Auto-report OpenTelemetry-based traces, create custom spans, and force-flush data before process exit. - OpenAPI Authentication: Issue JWT tokens via AKSK signing for Prompt Hub, PTaaS, dataset, and annotation job APIs. - Use Case: A backend developer integrating a travel-assistant prompt into a Go microservice initializes the Fornax client once, executes the published prompt with variables, and monitors token usage and latency in the Fornax observability console. ## Quick Start Use the fornax-knowledge skill to show me how to initialize the Fornax Python SDK and execute a published prompt with variables.

Frequently Asked Questions about fornax-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate the Fornax SDK into a Golang service?

Install code.byted.org/flowdevops/fornax_sdk, then create one client with fornax_sdk.NewClient using your space AK and SK. Reuse that single client instance across requests to fetch prompts, execute models, and report traces.

How do I call a published Fornax prompt with variables?

Use ExecutePromptLocal with the PromptKey and a Variables map; the SDK renders the template and calls the model. Omit WithChatModelConfig for remote execution on the platform, or pass it for local execution with your own model account.

Which languages does the Fornax SDK support?

Fornax SDK supports Golang (code.byted.org/flowdevops/fornax_sdk), Python (bytedance.fornax, requires Python 3.8+), and Node.js (@next-ai/fornax-sdk). The Node SDK works only in Node environments, not in web browsers.

Why are my Fornax traces not showing up in local debugging?

Trace reporting is asynchronous, so spans are lost if the process exits before the flush timer fires. Set RUNTIME_IDC_NAME=boe and TCE_PSM, then call forceFlush or Close before exit, or sleep two seconds.

How does Fornax OpenAPI authentication work?

Fornax OpenAPI uses a JWT token issued from your space AKSK via the authenticate endpoint, passed as Authorization: Bearer. The token is valid for three hours and only accesses resources within the issuing space.

What does Fornax error 600503316 mean?

Error 600503316 means the prompt has not been published to the target environment. Publish the prompt to BOE or Online in the Fornax console, or specify an already-published version number when calling.