دستیارها
ساخت دستیارهای هوش مصنوعی با حافظه و ابزارها
دستیارها (بتا)
API دستیارها به شما امکان میدهد دستیارهای هوش مصنوعی را درون اپلیکیشنهای خودتان بسازید. یک دستیار دارای دستورالعمل است و میتواند از مدلها، ابزارها و دانش برای پاسخ به پرسشهای کاربر بهره ببرد.
API دستیارها از رشتههای گفتگوی پایدار پشتیبانی میکند، بنابراین نیازی نیست خودتان تاریخچه پیامها را مدیریت کنید.
نمای کلی
- ساخت یک دستیار: دستورالعمل سفارشی آن را تعریف کنید و یک مدل انتخاب کنید.
- ساخت یک رشته گفتگو: یک نشست گفتگو میان کاربر و دستیار.
- افزودن پیامها: پرسشهای کاربر که به رشته گفتگو اضافه میشوند.
- اجرای دستیار: دستیار را برای پردازش رشته گفتگو و تولید پاسخ فعال کنید.
1. ساخت یک دستیار
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. ساخت یک رشته گفتگو
thread = client.beta.threads.create()3. افزودن یک پیام
پرسش کاربر را به رشته گفتگو اضافه کنید.
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. اجرای دستیار
دستیار را روی رشته گفتگو اجرا کنید تا یک پاسخ تولید شود.
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 | ساخت یک اجرا |