Assistant API 快速入門（下線中）

# 檢查 Python 解譯器版本
python --version

# 檢查 DashScope SDK
pip list | grep dashscope

# 安裝 DashScope SDK 版本 1.17.0
pip install dashscope==1.17.0

import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 使用 Qwen-Max 建立一個新的繪畫助手
painting_assistant = dashscope.Assistants.create(
    model='qwen-max',  # 使用 Qwen-Max 模型以增強理解能力。模型列表：https://www.alibabacloud.com/help/zh/model-studio/getting-started/models
    name='Art Maestro 藝術大師',  # 助手名稱為“Art Maestro（藝術大師）”
    description='一個專註於繪畫和藝術知識的AI助手。',
    instructions='''你是一個專家級的繪畫助手。請提供關於繪畫技巧、藝術史和創意指導的詳細資料。''',
    tools=[
        {
            'type': 'text_to_image',  # 用於根據描述產生映像的工具
            'description': '使用此工具建立繪畫風格、技巧或藝術概念的視覺樣本。'
        }
    ]
)

# 列印助手的ID以確認建立成功
print(f"繪畫助手 'Art Maestro' 建立成功，ID：{painting_assistant.id}")

from http import HTTPStatus
import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 建立一個新的空線程
thread = dashscope.Threads.create()

# 檢查線程建立是否成功
if thread.status_code == HTTPStatus.OK:
    print(f"線程建立成功。線程 ID：{thread.id}")
    print("現在你可以開始與AI助手進行繪畫對話了。")
else:
    print(f"線程建立失敗。狀態代碼：{thread.status_code}")
    print(f"錯誤碼：{thread.code}")
    print(f"錯誤資訊：{thread.message}")

# 注意：這個空線程現在可以用於保持你繪畫專案討論的上下文，
# 包括任何關於布偶貓或其他繪畫主題的未來訊息。

from http import HTTPStatus
import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 建立一條訊息，告訴助手需要做什嗎？
message = dashscope.Messages.create(thread.id, content='請幫我畫一幅布偶貓的畫。')

# 檢查訊息建立是否成功
if message.status_code == HTTPStatus.OK:
    print('訊息建立成功！訊息 ID：%s' % message.id)
else:
    print('訊息建立失敗。狀態代碼：%s，錯誤碼：%s，錯誤資訊：%s' % (message.status_code, message.code, message.message))

from http import HTTPStatus
import json
import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 建立一個新的運行以執行訊息
run = dashscope.Runs.create(thread.id, assistant_id=painting_assistant.id)
if run.status_code != HTTPStatus.OK:
    print('建立助手失敗，狀態代碼：%s，錯誤碼：%s，錯誤資訊：%s' % (run.status_code, run.code, run.message))
else:
    print('建立助手成功，ID：%s' % run.id)

# 等待運行完成或需要操作
run = dashscope.Runs.wait(run.id, thread_id=thread.id)
if run.status_code != HTTPStatus.OK:
    print('擷取運行狀態失敗，狀態代碼：%s，錯誤碼：%s，錯誤資訊：%s' % (run.status_code, run.code, run.message))
else:
    print(run)

# 擷取線程訊息，以擷取運行輸出
msgs = dashscope.Messages.list(thread.id)
if msgs.status_code != HTTPStatus.OK:
    print('擷取訊息失敗，狀態代碼：%s，錯誤碼：%s，錯誤資訊：%s' % (msgs.status_code, msgs.code, msgs.message))
else:
    print(json.dumps(msgs, default=lambda o: o.__dict__, sort_keys=True, indent=4))