Xây dựng agent Python với API Sellfern

Documentation Index

Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Điều kiện tiên quyết

• Python 3.11 hoặc mới hơn
• Một token API Sellfern với ít nhất các phạm vi orders:read và analytics:read
• Một khóa API Anthropic (có sẵn tại console.anthropic.com)

​

Thiết lập

cd examples/python-agent

python -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

export ANTHROPIC_API_KEY="sk-ant-..."
export SELLFERN_API_TOKEN="sk_live_..."
export SELLFERN_API_URL="https://api.sellfern.com"

python agent.py "List all Shipped orders from the last 30 days"

​

Cách sử dụng mẫu

python agent.py "List all Shipped orders from the last 30 days"
python agent.py "What was our gross profit margin last month?"
python agent.py "Show me the 10 most recent orders from store 3"

​

Cách hoạt động

1. Prompt của bạn được gửi tới Claude cùng với cả hai định nghĩa công cụ đính kèm.
2. Claude trả về một khối tool_use chỉ định công cụ nào để gọi và các đối số nào để truyền.
3. Script thực thi công cụ — một cuộc gọi HTTP thực tới SELLFERN_API_URL bằng token của bạn.
4. Kết quả công cụ được gửi lại Claude dưới dạng tin nhắn tool_result.
5. Các bước 2–4 lặp lại cho đến khi Claude tạo ra phản hồi văn bản cuối cùng mà không có cuộc gọi công cụ nào nữa.

​

Mở rộng agent

1. Viết một hàm Python gọi điểm cuối bằng _sellfern_get (cho các yêu cầu GET) hoặc một helper _sellfern_post bạn thêm cho các mutation.
2. Thêm một định nghĩa công cụ vào danh sách TOOLS bằng cùng định dạng JSON schema như các công cụ hiện có.
3. Thêm một nhánh dispatch trong run_tool() ánh xạ tên công cụ tới hàm mới của bạn.

# 1. Định nghĩa hàm
def update_order_status(order_id: int, status: str, tracking_number: str | None = None):
    return _sellfern_patch(f"/orders/{order_id}/status", {
        "status": status,
        "tracking_number": tracking_number,
    })

# 2. Thêm vào danh sách TOOLS
{
    "name": "update_order_status",
    "description": "Update the status of a Sellfern order",
    "input_schema": {
        "type": "object",
        "properties": {
            "order_id": {"type": "integer"},
            "status": {"type": "string"},
            "tracking_number": {"type": "string"},
        },
        "required": ["order_id", "status"],
    },
}

# 3. Dispatch trong run_tool()
elif tool_name == "update_order_status":
    return update_order_status(**tool_input)

• PATCH /api/v2/orders/:id/status → update_order_status
• POST /api/v2/orders/bulk-status → bulk_update_order_status
• GET /api/v2/analytics/by-store → get_analytics_by_store
• GET /api/v2/fulfillment/queue → list_fulfillment_queue