简介
Assistants API 允许您在自己的应用程序中构建 AI 助手。助手通过指令,利用模型、工具和知识来响应用户查询。Assistants 主要分为几大模块:
类型 | 支持的功能 |
---|---|
Name | 助理的名称。 |
Instructions | 指示,预制的一些提示词,比如角色设定。 |
Model | 可以指定任何 GPT-3.5 或 GPT-4 型号。检索工具至少需要 gpt-3.5-turbo-1106(支持较新版本)或 gpt-4-turbo-preview 型号。 |
Tools | 包含 Code Interpreter、 |
Retrieval | 检索工具至少需要 gpt-3.5-turbo-1106(支持较新版本)或 gpt-4-turbo-preview 型号。 |
Functions | API 允许您定义自定义函数签名,其行为与我们的函数调用功能类似。 |
前提条件
注意:
- 体验官方的 assistant 工具尽量使用付费账号,如果是非付费账号,能使用的 token 和 gpt 模型均有限制。体验会比较差。
- 付费账号必须要绑定国外的信用卡。
操作步骤
首先是界面操作步骤:
- 创建一个智能助理,或者复用已经创建好的助理。
- 创建一个线程。
- 给线程添加对应的信息。
- 执行该信息。
- 查看执行状态。
- 查看助理的返回信息。
代码调用
注意:使用代码调用前需要了解ChatGPT的API使用。
而代码调用步骤与界面操作步骤基本一致,代码如下:
代码语言:python代码运行次数:0复制import time
from openai import OpenAI
import os
# code interpreter的使用
client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
# 1. 创建一个助理,或者复用已经创建好的助理。
assistant = "助理id"
# 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(
thread_id=thread.id,
assistant_id=assistant,
instructions="You are a personal math tutor. When asked a math question, write and run code to answer the question.")
# 5. 循环查询问题是否已经解决完成
def wait_on_run(run, thread):
while run.status == "queued" or run.status == "in_progress":
run = client.beta.threads.runs.retrieve(
thread_id=thread.id,
run_id=run.id,
)
time.sleep(0.5)
return run
wait_on_run(run, thread)
# 6. 获取历史消息
messages = client.beta.threads.messages.list(thread_id=thread.id).model_dump_json(indent=2)
print(messages)
工具介绍
- Code Interpreter:ChatGPT 会自动使用一些内置的函数,比如数学运算等。
- Knowledge Retrieval:上传文件,进行一次知识检索。
- Function calling:调用外部的函数。
相关资料
- 官方文档说明
- 官方体验地址