Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Hướng dẫn sử dụng AI Agent

Framework Agent

Sử dụng BazaarLink với framework agent phổ biến. Vì BazaarLink tương thích OpenAI, hầu hết framework hoạt động ngay — chỉ cần đặt base URL và khóa API.

Vercel AI SDK

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const bazaarlink = createOpenAI({
  baseURL: "https://bazaarlink.ai/api/v1",
  apiKey: "sk-bl-YOUR_API_KEY",
});

const { text } = await generateText({
  model: bazaarlink("openai/gpt-4.1"),
  prompt: "Write a haiku about programming",
});

console.log(text);

Phi hành đoànAI

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
from crewai import Agent, Task, Crew
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://bazaarlink.ai/api/v1",
    api_key="sk-bl-YOUR_API_KEY",
    model="anthropic/claude-sonnet-4.6",
)

researcher = Agent(
    role="Researcher",
    goal="Research and summarize topics",
    llm=llm,
)

task = Task(
    description="Research the latest trends in AI agents",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()
print(result)

AutoGen

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
from autogen import AssistantAgent, UserProxyAgent

config_list = [{
    "model": "openai/gpt-4.1",
    "base_url": "https://bazaarlink.ai/api/v1",
    "api_key": "sk-bl-YOUR_API_KEY",
}]

assistant = AssistantAgent(
    "assistant",
    llm_config={"config_list": config_list},
)

user_proxy = UserProxyAgent(
    "user_proxy",
    human_input_mode="NEVER",
    code_execution_config={"work_dir": "coding"},
)

user_proxy.initiate_chat(
    assistant,
    message="Write a Python function to calculate fibonacci numbers",
)

Biến môi trường

Hầu hết framework agent hỗ trợ cấu hình qua biến môi trường:

1
2
3
# .env
OPENAI_API_KEY=sk-bl-YOUR_API_KEY
OPENAI_BASE_URL=https://bazaarlink.ai/api/v1

Biến môi trường

Bất kỳ framework nào hỗ trợ API OpenAI hoặc base URL tùy chỉnh đều có thể hoạt động với BazaarLink. Chỉ cần đặt base URL và sử dụng khóa API BazaarLink.

Tự đăng ký AI Agent

Endpoint đăng ký tự động của BazaarLink cho phép các AI Agent tự đăng ký và lấy API key chỉ trong một lần gọi API. Agent cũng tạo ra "liên kết xác nhận" cho chủ sở hữu là người — chủ sở hữu đăng nhập, xác nhận key, và key được chuyển sang tài khoản của họ.

Luồng

BƯỚC 1

Bot tự đăng ký

Gọi POST /api/v1/agents/register để nhận api_key và upgrade_url

BƯỚC 2

Bot chia sẻ liên kết

Gửi upgrade_url cho chủ sở hữu (qua tin nhắn chat hoặc thông báo)

BƯỚC 3

Chủ sở hữu nhận

Đăng nhập, vào /keys, dán liên kết hoặc token, và nhấn "Nhận"

BƯỚC 4

Chuyển khóa

Khóa API được gắn vào tài khoản chủ sở hữu; có thể dùng sau khi nạp tín dụng

API tự đăng ký Bot

POST/api/v1/agents/register

1
2
3
curl -X POST https://bazaarlink.ai/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "MyBot"}'

1
2
3
4
5
6
7
8
9
10
11
{
  "api_key": "sk-bl-xxxxxxxxxxxxxxxx",
  "credits": 0,
  "claim_token": "xxxxxxxx",
  "claim_expires": "2026-03-09T00:00:00.000Z",
  "upgrade_url": "https://bazaarlink.ai/claim?token=xxxxxxxx",
  "referral_code": "abc12345",
  "base_url": "https://bazaarlink.ai/api/v1",
  "docs": "https://bazaarlink.ai/llms.txt",
  "message": "I registered an account on bazaarlink.ai..."
}

Tham số yêu cầu

namebắt buộc

string

Tên bot (tối đa 100 ký tự)

referral_code

string

Mã giới thiệu từ bot khác (tùy chọn)

Ghi chú sử dụng

Khóa API không có tín dụng dùng thử sau đăng ký; chủ sở hữu phải nhận và nạp thủ công
claim_token có hiệu lực 7 ngày; liên kết hết hạn sau đó
Mỗi IP giới hạn 1 đăng ký mỗi 24 giờ
Sau khi chủ sở hữu nhận, khóa tự động đổi tên thành "TênBot (claimed)"
Mã giới thiệu cho phép cả hai bên nhận tín dụng thưởng trong các đợt khuyến mãi tương lai

Hỗ trợ LLM gốc

BazaarLink cung cấp tài liệu ở định dạng llms.txt để AI agent có thể đọc trực tiếp tham chiếu API. Truy cập https://bazaarlink.ai/llms.txt để xem tài liệu API đầy đủ dạng machine-readable.