# @huggingface/tiny-agents

![meme](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/tiny-agents/legos.png)

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

```bash
npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agents
```

## Cách sử dụng CLI

```bash
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 server
```

Bạn có thể tải các agent trực tiếp từ Dataset [tiny-agents](https://huggingface.co/datasets/tiny-agents/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`:

```bash
mkdir my-agent
touch my-agent/agent.json
```

```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:

```json
{
	"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`](https://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:

```bash
npx @huggingface/tiny-agents run ./my-agent
```

Xong rồi! 🔥

## Bộ sưu tập Tiny Agents

Duyệt 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`](https://huggingface.co/datasets/tiny-agents/tiny-agents/tree/main/julien-c/flux-schnell-generator):

```bash
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"
```

> [!NOTE]
> 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](https://huggingface.co/datasets/tiny-agents/tiny-agents/discussions) 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ệp `PROMPT.md` hoặc [`AGENTS.md`](https://agents.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ệp `EXAMPLES.md` vớ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

```typescript
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