لوگوی پلتفرم Aizeمستندات پلتفرم Aize

دستیارها

ساخت دستیارهای هوش مصنوعی با حافظه و ابزارها

دستیارها (بتا)

API دستیارها به شما امکان می‌دهد دستیارهای هوش مصنوعی را درون اپلیکیشن‌های خودتان بسازید. یک دستیار دارای دستورالعمل است و می‌تواند از مدل‌ها، ابزارها و دانش برای پاسخ به پرسش‌های کاربر بهره ببرد.

API دستیارها از رشته‌های گفتگوی پایدار پشتیبانی می‌کند، بنابراین نیازی نیست خودتان تاریخچه پیام‌ها را مدیریت کنید.

نمای کلی

  1. ساخت یک دستیار: دستورالعمل سفارشی آن را تعریف کنید و یک مدل انتخاب کنید.
  2. ساخت یک رشته گفتگو: یک نشست گفتگو میان کاربر و دستیار.
  3. افزودن پیام‌ها: پرسش‌های کاربر که به رشته گفتگو اضافه می‌شوند.
  4. اجرای دستیار: دستیار را برای پردازش رشته گفتگو و تولید پاسخ فعال کنید.

1. ساخت یک دستیار

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.aize.dev/v1"
)

assistant = client.beta.assistants.create(
    name="Math Tutor",
    instructions="You are a personal math tutor. Write and run code to answer math questions.",
    tools=[{"type": "code_interpreter"}],
    model="gpt-4-turbo"
)

2. ساخت یک رشته گفتگو

python
thread = client.beta.threads.create()

3. افزودن یک پیام

پرسش کاربر را به رشته گفتگو اضافه کنید.

python
message = client.beta.threads.messages.create(
    thread_id=thread.id,
    role="user",
    content="I need to solve the equation `3x + 11 = 14`. Can you help me?"
)

4. اجرای دستیار

دستیار را روی رشته گفتگو اجرا کنید تا یک پاسخ تولید شود.

python
run = client.beta.threads.runs.create_and_poll(
    thread_id=thread.id,
    assistant_id=assistant.id,
    instructions="Please address the user as Jane Doe. The user has a premium account."
)

if run.status == 'completed':
    messages = client.beta.threads.messages.list(
        thread_id=thread.id
    )
    print(messages)
else:
    print(run.status)

ابزارهای پشتیبانی‌شده

  • مفسر کد (Code Interpreter): نوشتن و اجرای کد Python.
  • جست‌وجوی فایل (File Search): جست‌وجوی اطلاعات در فایل‌های آپلودشده.
  • فراخوانی تابع (Function Calling): فراخوانی توابع سفارشی خودتان.

نقاط پایانی

متدنقطه پایانیتوضیحات
GET/v1/assistantsفهرست دستیارها
POST/v1/assistantsساخت یک دستیار
GET/v1/threads/{thread_id}دریافت یک رشته گفتگو
POST/v1/threads/{thread_id}/messagesافزودن یک پیام
POST/v1/threads/{thread_id}/runsساخت یک اجرا

در این صفحه