Huggingface.js documentation
@huggingface/tiny-agents
@huggingface/tiny-agents
Một nhóm các ứng dụng AI nhẹ, có thể kết hợp, được xây dựng trên Inference Client và stack MCP của Hugging Face.
Cài đặt
npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agentsCách sử dụng 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 serverBạn có thể tải các agent trực tiếp từ Dataset tiny-agents trên Hugging Face Hub, hoặc chỉ định đường dẫn đến cấu hình agent cục bộ của riêng bạn.
Định nghĩa tác tử của riêng bạn
Cách đơn giản nhất để tạo tác tử của riêng bạn là tạo một thư mục chứa tệp 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"]
}
]
}Hoặc sử dụng URL điểm cuối cục bộ hoặc từ xa:
{
"model": "Qwen/Qwen3-32B",
"endpointUrl": "http://localhost:1234/v1",
"servers": [
{
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
]
}
Trong đó servers là danh sách các máy chủ MCP (chúng tôi hỗ trợ các máy chủ Stdio, SSE và HTTP).
Tùy chọn, bạn có thể thêm tệp AGENTS.md (hoặc PROMPT.md) để ghi đè lên prompt Agent mặc định.
Sau đó, chỉ cần trỏ tiny-agents đến thư mục cục bộ của bạn:
npx @huggingface/tiny-agents run ./my-agent
Xong rồi! 🔥
Bộ sưu tập Tiny Agents
Duyệt qua bộ sưu tập Tiny Agents được tuyển chọn của chúng tôi tại https://huggingface.co/datasets/tiny-agents/tiny-agents. Mỗi agent được lưu trữ trong một thư mục con riêng, tuân theo cấu trúc được mô tả ở trên. Việc chạy một agent từ Hub đơn giản như việc sử dụng agent_id của nó. Ví dụ, để chạy agent julien-c/flux-schnell-generator:
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"Bạn muốn chia sẻ agent của mình với cộng đồng? Hãy gửi một PR đến kho Tiny Agents trên Hub. Bản gửi của bạn phải bao gồm tệp
agent.json, và bạn có thể tùy chọn thêm tệpPROMPT.mdhoặcAGENTS.md. Để giúp người khác hiểu rõ hơn về khả năng của agent, hãy cân nhắc bao gồm tệpEXAMPLES.mdvới các prompt mẫu và trường hợp sử dụng.
Nâng cao: Sử dụng theo chương trình
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);
}
}
}Giấy phép
MIT
Update on GitHub