# Xây AI agent với AnyRouter

> Một agent là một vòng lặp, không phải một prompt. Gửi tin nhắn, để model gọi tool, chạy tool, rồi đưa kết quả trở lại. Một key gateway cho mọi model trong vòng.

- Date: November 22, 2026
- Category: guides
- HTML: https://anyrouter.dev/blog/vi/build-agent-anyrouter

## Vòng lặp chính là ý tưởng

Một agent lặp bốn bước. Lấy hội thoại, hỏi model, nếu model yêu cầu tool thì chạy nó, rồi nối kết quả vào và hỏi lại. Khi model trả lời mà không gọi tool, bạn xong.

Phần còn lại là chi tiết. Model không cần endpoint agent đặc biệt, nó cần endpoint chat nhận tool, tức là hình Chat Completions của OpenAI.

## Data shape

Hội thoại là danh sách tin nhắn. Tool là tên, mô tả và JSON schema. Model trả về content hoặc danh sách tool call:

```ts
type Message = { role: "system" | "user" | "assistant" | "tool"; content: string; tool_call_id?: string }

type Tool = {
  type: "function"
  function: { name: string; description: string; parameters: object }
}

type ToolCall = { id: string; function: { name: string; arguments: string } }
```

_Một tin nhắn, một tool và một tool call._

Vòng lặp giữ một danh sách tin nhắn và nối vào đó, nên model luôn thấy toàn bộ lịch sử gồm cả kết quả tool của chính nó.

## Vòng lặp tối thiểu

Chạy tới khi model ngừng gọi tool, và đặt trần cứng để một bug không quay vô hạn:

```ts
const messages: Message[] = [
  { role: "system", content: "You are a helpful assistant with tools." },
  { role: "user", content: input },
]

for (let step = 0; step < 8; step++) {
  const reply = await call({ model: "anyrouter/auto", messages, tools })
  messages.push({ role: "assistant", content: reply.content ?? "" })

  if (reply.toolCalls.length === 0) {
    console.log(reply.content)
    break
  }

  for (const call_ of reply.toolCalls) {
    const result = await runTool(call_.function.name, JSON.parse(call_.function.arguments))
    messages.push({
      role: "tool",
      tool_call_id: call_.id,
      content: JSON.stringify(result),
    })
  }
}
```

_Vòng lặp agent trong vài dòng._

## Giới hạn tool

Chỉ cho model những tool nó cần, và kiểm tra mọi tham số trước khi chạy bất cứ gì. Tool ghi vào hệ thống của bạn nên bắt buộc một bước xác nhận rõ ràng, không để model quyết định.

Giữ danh sách tool nhỏ. Model chọn giữa ba tool đáng tin hơn nhiều so với chọn giữa ba mươi, và mỗi mô tả tool là một prompt mà model đọc ở mọi lượt.

## Gateway giúp agent thế nào

Một agent thực hiện nhiều call, nên rate limit hoặc sự cố lộ ra nhanh. AnyRouter tự thử lại upstream lỗi và có thể chuyển sang model khác trên cùng route, nên vòng lặp chạy tiếp.

Ghim model mạnh cho các lượt lập kế hoạch và model rẻ hơn cho các lượt chọn tool. Model miễn phí tính `$0` mỗi token trên gói Go trở lên, không giới hạn theo ngày, nên vòng thử nghiệm chạy rẻ.
