Hướng dẫn quản lý dự án

from aitracer import AITracer

# Chỉ định dự án trong constructor
tracer = AITracer(
    api_key="at-xxxx",
    project="my-chatbot-production"
)

# Tất cả log sau đó sẽ được ghi vào dự án này
client = tracer.wrap_openai(OpenAI())

<?php
use AITracer\AITracer;

// Chỉ định dự án trong constructor
$tracer = new AITracer([
    'api_key' => 'at-xxxx',
    'project' => 'my-chatbot-production'
]);

$client = $tracer->wrapOpenAI(OpenAI::client($apiKey));

import { AITracer } from '@haro/aitracer';

// Chỉ định dự án trong constructor
const tracer = new AITracer({
  apiKey: 'at-xxxx',
  projectId: 'my-chatbot-production'
});

# Môi trường sản xuất (.env.production)
AITRACER_API_KEY=at-xxxx
AITRACER_PROJECT=my-chatbot-production

# Môi trường staging (.env.staging)
AITRACER_API_KEY=at-xxxx
AITRACER_PROJECT=my-chatbot-staging

# Môi trường phát triển (.env.development)
AITRACER_API_KEY=at-xxxx
AITRACER_PROJECT=my-chatbot-development

from aitracer import AITracer

# Tự động đọc từ biến môi trường (có thể bỏ qua tham số)
tracer = AITracer()

# Hoặc lấy từ biến môi trường một cách rõ ràng
import os
tracer = AITracer(
    api_key=os.getenv("AITRACER_API_KEY"),
    project=os.getenv("AITRACER_PROJECT")
)

# Với log thủ công, có thể chỉ định dự án theo yêu cầu
tracer.log({
    "model": "gpt-4",
    "provider": "openai",
    "project": "special-feature",  # Chỉ log này vào dự án khác
    "input_data": {...},
    "output_data": {...}
})

from aitracer import AITracer
from openai import OpenAI

# Tạo Tracer cho từng dự án
tracer_chat = AITracer(project="chatbot")
tracer_search = AITracer(project="search-feature")
tracer_summary = AITracer(project="summarization")

# Sử dụng client khác nhau cho từng tính năng
chat_client = tracer_chat.wrap_openai(OpenAI())
search_client = tracer_search.wrap_openai(OpenAI())
summary_client = tracer_summary.wrap_openai(OpenAI())

# Dự án mặc định
tracer = AITracer(project="main-app")
client = tracer.wrap_openai(OpenAI())

# Yêu cầu bình thường (ghi vào main-app)
response = client.chat.completions.create(...)

# Thay đổi dự án tạm thời
with tracer.project("experimental-feature"):
    # Log trong khối này ghi vào experimental-feature
    response = client.chat.completions.create(...)

# Ngoài khối trở về dự án gốc
response = client.chat.completions.create(...)  # Ghi vào main-app

# Ví dụ tốt: Thống nhất với kebab-case
my-chatbot-production
my-chatbot-staging
search-api-production

# Ví dụ nên tránh: Quy tắc đặt tên không nhất quán
MyChatBot
my_chatbot_staging
searchAPI-prod

# Ví dụ xấu: Hardcode
tracer = AITracer(project="my-chatbot-production")

# Ví dụ tốt: Biến môi trường
tracer = AITracer(project=os.getenv("AITRACER_PROJECT"))

# Dự án: Phân loại lớn theo ứng dụng + môi trường
tracer = AITracer(project="chatbot-production")

# Metadata: Thêm thuộc tính chi tiết
response = client.chat.completions.create(
    model="gpt-4",
    messages=[...],
    extra_body={
        "aitracer_metadata": {
            "user_id": "user-123",
            "feature": "customer-support",
            "version": "2.1.0"
        }
    }
)