Huggingface.js documentation
@huggingface/tiny-agents
@huggingface/tiny-agents
Sebuah skuad aplikasi AI ringan yang dapat dikomposisikan, dibangun di atas Inference Client dan tumpukan MCP dari Hugging Face.
Instalasi
npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agentsPenggunaan CLI
npx @huggingface/tiny-agents [command] "agent/id"Usage:
tiny-agents [flags]
tiny-agents run "agent/id"
tiny-agents serve "agent/id"
Available Commands:
run Run the Agent in command-line
serve Run the Agent as an OpenAI-compatible HTTP serverAnda dapat memuat agen langsung dari Dataset tiny-agents di Hugging Face Hub, atau menentukan path ke konfigurasi agen lokal Anda sendiri.
Definisikan agen Anda sendiri
Cara termudah untuk membuat agen Anda sendiri adalah dengan membuat folder yang berisi file agent.json:
mkdir my-agent
touch my-agent/agent.json{
"model": "Qwen/Qwen2.5-72B-Instruct",
"provider": "novita",
"servers": [
{
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
]
}Atau menggunakan URL endpoint lokal atau jarak jauh:
{
"model": "Qwen/Qwen3-32B",
"endpointUrl": "http://localhost:1234/v1",
"servers": [
{
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
]
}
Di mana servers adalah daftar server MCP (kami mendukung server Stdio, SSE, dan HTTP).
Secara opsional, Anda dapat menambahkan file AGENTS.md (atau PROMPT.md) untuk menimpa prompt Agent default.
Lalu, arahkan tiny-agents ke folder lokal Anda:
npx @huggingface/tiny-agents run ./my-agent
Voilà! 🔥
Koleksi Tiny Agents
Jelajahi koleksi Tiny Agents yang kami kurasi di https://huggingface.co/datasets/tiny-agents/tiny-agents. Setiap agen disimpan dalam subdirektori sendiri, mengikuti struktur yang diuraikan di atas. Menjalankan agen dari Hub sesederhana menggunakan agent_id-nya. Sebagai contoh, untuk menjalankan agen julien-c/flux-schnell-generator:
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"Ingin membagikan agen Anda sendiri kepada komunitas? Kirimkan PR ke repositori Tiny Agents di Hub. Pengajuan Anda harus menyertakan file
agent.json, dan Anda dapat menambahkan filePROMPT.mdatauAGENTS.mdsecara opsional. Untuk membantu orang lain memahami kemampuan agen Anda, pertimbangkan untuk menyertakan fileEXAMPLES.mddengan contoh prompt dan kasus penggunaan.
Lanjutan: Penggunaan Programatik
import { Agent } from '@huggingface/tiny-agents';
const HF_TOKEN = "hf_...";
// Create an Agent
const agent = new Agent({
provider: "auto",
model: "Qwen/Qwen2.5-72B-Instruct",
apiKey: HF_TOKEN,
servers: [
{
// Playwright MCP
command: "npx",
args: ["@playwright/mcp@latest"],
},
],
});
await agent.loadTools();
// Use the Agent
for await (const chunk of agent.run("What are the top 5 trending models on Hugging Face?")) {
if ("choices" in chunk) {
const delta = chunk.choices[0]?.delta;
if (delta.content) {
console.log(delta.content);
}
}
}Lisensi
MIT
Update on GitHub