اتصال AutoGen به پیکو هوش

AutoGen فریمورک چندایجنتی مایکروسافت است. در نسخه‌ی ۰٫۴ به بعد، کلاینت OpenAIChatCompletionClient در بسته‌ی autogen-ext آدرس پایه و کلید را می‌پذیرد. چون AutoGen قابلیت مدل‌های ناشناخته را نمی‌داند، باید ویژگی‌های مدل را در model_info بدهید.

توجه: API این کتابخانه بین نسخه‌ها تغییر کرده است. اگر نسخه‌ی قدیمی‌تر (۰٫۲) دارید، ساختار config_list دارد و با این مثال تفاوت می‌کند.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب

   بسته‌های agentchat و ext.

   کپی

   pip install -U "autogen-agentchat" "autogen-ext[openai]"

2. ۲ساخت کلاینت مدل

   model_info به AutoGen می‌گوید مدل چه توانایی‌هایی دارد.

   کپی

   import os
   from autogen_ext.models.openai import OpenAIChatCompletionClient
   
   model_client = OpenAIChatCompletionClient(
       model="gpt-6-sol",
       base_url="https://api.picoai.ir/v1",
       api_key=os.environ["PICOAI_API_KEY"],
       model_info={
           "vision": False,
           "function_calling": True,
           "json_output": True,
           "family": "unknown",
           "structured_output": False,
       },
   )

3. ۳ایجنت دستیار

   کلاینت را به AssistantAgent بدهید و اجرا کنید.

   کپی

   import asyncio
   from autogen_agentchat.agents import AssistantAgent
   
   async def main():
       agent = AssistantAgent("assistant", model_client=model_client)
       result = await agent.run(task="سه ایده برای نام یک فروشگاه آنلاین بده.")
       print(result.messages[-1].content)
       await model_client.close()
   
   asyncio.run(main())

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات AutoGen خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای AutoGen

• مقادیر model_info را فقط روی true بگذارید که واقعاً از مدل انتخابی مطمئن هستید؛ مثلاً function_calling را برای مدلی که ابزار را پشتیبانی نمی‌کند false بگذارید.
• client را پس از کار ببندید (close) تا اتصال‌ها آزاد شوند.
• برای گفتگوی چندنفره از RoundRobinGroupChat استفاده کنید و حد تعداد پیام تعیین کنید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.