Краткое руководство. Начало работы с помощниками Azure OpenAI (предварительная версия)

• Подписка Azure — создайте бесплатную учетную запись.
• Ресурс центра Azure AI с развернутой моделью. Дополнительные сведения о развертывании моделей см. в руководстве по развертыванию ресурсов.
• Проект Azure AI на портале Azure AI Foundry.

Azure AI Foundry позволяет использовать Помощники версии 2, которые предоставляют несколько обновлений, таких как средство поиска файлов, которое быстрее и поддерживает больше файлов.

1. Войдите в Azure AI Foundry.

2. Если экран не выглядит на следующем снимке экрана, выберите Azure AI Foundry в левом верхнем углу экрана.

3. Выберите " Давайте пойдем " на карточке службы Azure OpenAI.

   

4. В меню навигации слева выберите помощники, расположенные под игровыми площадками.

   

   На игровой площадке Помощников можно изучить, прототипировать и тестировать помощников по искусственному интеллекту без необходимости выполнять какой-либо код. На этой странице можно быстро итерировать и экспериментировать с новыми идеями.

   На детской площадке есть несколько вариантов настройки помощника. На следующих шагах вы будете использовать панель установки для создания нового помощника по искусственному интеллекту.

   Развернуть таблицу

   Имя	Description
   Имя помощника	Имя развертывания, связанное с определенной моделью.
   Инструкции	Инструкции напоминают системные сообщения, с их помощью вы даете модели руководство по поведению и контекст, на который она должна ссылаться при создании ответа. Вы можете описать личность помощника, указать ему, что он должен и не должен отвечать, и сообщить о том, как форматировать ответы. Вы также можете указать примеры действий, которые следует предпринять при ответе.
   Развертывание	Здесь вы выбираете, какое развертывание модели использовать с вашим помощником.
   Функции	Создайте пользовательские определения функций для моделей, чтобы сформулировать вызовы API и структурировать выходные данные на основе ваших спецификаций. Не используется в этом кратком руководстве.
   Интерпретатор кода	Интерпретатор кода предоставляет доступ к изолированной среде Python, которую можно использовать для проверки и выполнения кода модели.
   Файлы	Вы можете отправить до 10 000 файлов с максимальным размером 512 МБ для использования с инструментами. Не используется в этом кратком руководстве.

1. Выберите развертывание в раскрывающемся списке "Развертывания".

2. В раскрывающемся списке настроек "Ассистент" выберите "Новый ассистент".

3. Присвойте помощнику имя.

4. Введите следующие инструкции : "Вы являетесь помощником по искусственному интеллекту, который может писать код, чтобы помочь ответить на математические вопросы"

5. Выберите развертывание модели. Мы рекомендуем протестировать одну из последних моделей gpt-4.

6. Выберите переключатель включения интерпретатора кода.

7. Выберите Сохранить.

   

8. Введите вопрос, чтобы получить ответ от помощника: "Мне нужно решить уравнение 3x + 11 = 14. Ты можешь мне помочь?"

9. Нажмите кнопку "Добавить и запустить"

   The solution to the equation (3x + 11 = 14) is (x = 1).
   

   Хотя мы видим, что ответ правильный, чтобы убедиться, что модель использовала интерпретатор кода для получения этого ответа, и что написанный код является действительным, а не просто повторением ответа из обучающих данных модели, мы зададим другой вопрос.

10. Введите следующий вопрос: "Показать мне код, который вы запустили, чтобы получить это решение".

    Sure. The code is very straightforward
    

    # calculation
    x = (14 - 11) / 3
    x
    
    

    First, we subtract 11 from 14, then divide the result by 3. This gives us the value of x which is 1.0.
    

    

Вы также можете обратиться к журналам на правой панели, чтобы убедиться, что интерпретатор кода использовался и для проверки кода, выполняемого для создания ответа. Важно помнить, что в то время как интерпретатор кода дает модели возможность реагировать на более сложные математические вопросы, преобразовав вопросы в код и выполняясь в изолированной среде Python, вам по-прежнему необходимо проверить ответ, чтобы убедиться, что модель правильно преобразовала свой вопрос в допустимое представление в коде.

При использовании игровой площадки Помощников помните о следующих понятиях.

Отдельный помощник может получить доступ к 128 инструментам, включая code interpreter, а также к любым пользовательским инструментам, которые вы создаете с помощью функций.

Сеанс чата, также называемый потоком в API помощника, это место, где происходит беседа между пользователем и помощником. В отличие от традиционных вызовов завершения чата, количество сообщений в потоке не ограничено. Помощник автоматически сжимает запросы, чтобы соответствовать пределу количества входных токенов модели.

Это также означает, что вы не контролируете, сколько токенов передается модели во время каждого шага беседы. Управление токенами абстрагируется и полностью осуществляется API для ассистентов.

Нажмите кнопку "Очистить чат", чтобы удалить текущий журнал бесед.

Под текстовым полем ввода есть две кнопки:

• Добавьте сообщение без запуска.
• Добавьте и запустите.

Журналы предоставляют подробный снимок действия API помощника.

По умолчанию существует три панели: настройка помощника, сеанс чата и журналы. Отображение панелей позволяет добавлять, удалять и изменять порядок панелей. Если вы когда-либо закрыли панель и хотите вернуть её, используйте Показать панели для её восстановления.

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

Также вы можете удалить помощника или поток через API Помощника.

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants

Справочная документация | Исходный код библиотеки | Пакет (PyPi) |

• подписка Azure — создайте бесплатную учетную запись.
• Python 3.8 или более поздней версии
• Следующие библиотеки Python: os, openai (требуется версия 1.x)
• Azure CLI , используемый для проверки подлинности без пароля в локальной среде разработки, создайте необходимый контекст, выполнив вход с помощью Azure CLI.
• Ресурс Azure OpenAI с совместимой моделью в поддерживаемом регионе.
• Мы рекомендуем ознакомиться с примечанием о прозрачности ответственного ИИ и другими ресурсами ответственного искусственного интеллекта, чтобы ознакомиться с возможностями и ограничениями службы Azure OpenAI.
• Ресурс Azure OpenAI с gpt-4 (1106-preview) развернутой моделью использовался для тестирования этого примера.

Для проверки подлинности без пароля необходимо выполнить следующие действия.

1. Используйте пакет azure-identity.
2. Назначьте Cognitive Services User роль вашей учетной записи пользователя. Это можно сделать в портале Azure в разделе Управление доступом (IAM)>Добавить назначение ролей.
3. Войдите с помощью Azure CLI, например az login.

1. Установите клиентную библиотеку OpenAI Python с помощью следующих компонентов:

pip install openai

2. Для рекомендуемой аутентификации без пароля:

pip install azure-identity

Для успешного выполнения вызова к службе Azure OpenAI вам потребуется следующее.

Перейдите к своему ресурсу на портале Azure. Ключи и конечная точка можно найти в разделе "Управление ресурсами". Скопируйте конечную точку и ключ доступа, так как они потребуются для проверки подлинности вызовов API. Вы можете использовать KEY1 или KEY2. Наличие двух ключей позволяет безопасно менять и повторно создавать ключи без прерывания работы службы.

Создайте и назначьте переменные постоянной среды для ключа и конечной точки.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

В нашем коде мы укажем следующие значения:

Отдельный помощник может получить доступ к 128 инструментам, включая code interpreter, а также к любым пользовательским инструментам, созданным с помощью функций.

Войдите в Azure с az login затем создайте и запустите помощника с помощью следующего рекомендуемого примера Python без необходимости пароля:

import os
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import AzureOpenAI

token_provider = get_bearer_token_provider(DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default")

client = AzureOpenAI(
    azure_ad_token_provider=token_provider,
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version="2024-05-01-preview",
)

# Create an assistant
assistant = client.beta.assistants.create(
    name="Math Assist",
    instructions="You are an AI assistant that can write code to help answer math questions.",
    tools=[{"type": "code_interpreter"}],
    model="gpt-4-1106-preview" # You must replace this value with the deployment name for your model.
)

# Create a thread
thread = client.beta.threads.create()

# Add a user question to the thread
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?"
)

# Run the thread and poll for the result
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.",
)

print("Run completed with status: " + run.status)

if run.status == "completed":
    messages = client.beta.threads.messages.list(thread_id=thread.id)
    print(messages.to_json(indent=2))

Чтобы использовать ключ API службы для проверки подлинности, можно создать и запустить помощник с помощью следующего примера Python:

import os
from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.environ["AZURE_OPENAI_API_KEY"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version="2024-05-01-preview",
)

# Create an assistant
assistant = client.beta.assistants.create(
    name="Math Assist",
    instructions="You are an AI assistant that can write code to help answer math questions.",
    tools=[{"type": "code_interpreter"}],
    model="gpt-4-1106-preview" # You must replace this value with the deployment name for your model.
)

# Create a thread
thread = client.beta.threads.create()

# Add a user question to the thread
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?"
)

# Run the thread and poll for the result
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.",
)

print("Run completed with status: " + run.status)

if run.status == "completed":
    messages = client.beta.threads.messages.list(thread_id=thread.id)
    print(messages.to_json(indent=2))

Выполнение завершено с состоянием: завершено

{
  "data": [
    {
      "id": "msg_4SuWxTubHsHpt5IlBTO5Hyw9",
      "assistant_id": "asst_cYqL1RuwLyFV3HU1gkaE2k0K",
      "attachments": [],
      "content": [
        {
          "text": {
            "annotations": [],
            "value": "The solution to the equation \\(3x + 11 = 14\\) is \\(x = 1\\)."
          },
          "type": "text"
        }
      ],
      "created_at": 1716397091,
      "metadata": {},
      "object": "thread.message",
      "role": "assistant",
      "run_id": "run_hFgBPbUtO8ZNTnNPC8PgpH1S",
      "thread_id": "thread_isb7spwRycI5ueT9E7357aOm"
    },
    {
      "id": "msg_Z32w2E7kY5wEWhZqQWxIbIUB",
      "assistant_id": null,
      "attachments": [],
      "content": [
        {
          "text": {
            "annotations": [],
            "value": "I need to solve the equation `3x + 11 = 14`. Can you help me?"
          },
          "type": "text"
        }
      ],
      "created_at": 1716397025,
      "metadata": {},
      "object": "thread.message",
      "role": "user",
      "run_id": null,
      "thread_id": "thread_isb7spwRycI5ueT9E7357aOm"
    }
  ],
  "object": "list",
  "first_id": "msg_4SuWxTubHsHpt5IlBTO5Hyw9",
  "last_id": "msg_Z32w2E7kY5wEWhZqQWxIbIUB",
  "has_more": false
}

В этом примере мы создадим помощника с включенным интерпретатором кода. Когда мы задаем помощнику математический вопрос, он преобразует вопрос в код Python и выполняет код в изолированной среде, чтобы определить ответ на этот вопрос. Код, который создает и тестирует модель, чтобы получить ответ:

from sympy import symbols, Eq, solve  
  
# Define the variable  
x = symbols('x')  
  
# Define the equation  
equation = Eq(3*x + 11, 14)  
  
# Solve the equation  
solution = solve(equation, x)  
solution  

Важно помнить, что в то время как интерпретатор кода дает модели возможность реагировать на более сложные запросы, преобразовав вопросы в код и выполняя этот код итеративно в песочнице Python, пока он не достигнет решения, необходимо проверить ответ, чтобы убедиться, что модель правильно преобразовала вопрос в допустимое представление в коде.

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants

Справочная документация | Исходный код | Пакет (NuGet)

• подписка Azure — создайте бесплатную учетную запись.
• Пакет SDK для .NET 8
• Ресурс Azure OpenAI с совместимой моделью в поддерживаемом регионе.
• Мы рекомендуем ознакомиться с примечанием о прозрачности ответственного ИИ и другими ресурсами ответственного искусственного интеллекта, чтобы ознакомиться с возможностями и ограничениями службы Azure OpenAI.
• Ресурс Azure OpenAI с развернутой моделью gpt-4o использовался для тестирования этого примера.

Для рекомендуемой проверки подлинности без ключа с помощью идентификатора Microsoft Entra необходимо:

• Установите Azure CLI, используемый для проверки подлинности без ключа с помощью идентификатора Microsoft Entra.
• Назначьте роль Cognitive Services User вашей учетной записи пользователя. Роли можно назначить на портале Azure в разделе Управление доступом (IAM)>Добавить назначение роли.

1. Создайте новую папку assistants-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir assistants-quickstart && cd assistants-quickstart
   

2. Создайте консольное приложение со следующей командой:

   dotnet new console
   

3. Установите клиентскую библиотеку OpenAI .NET с помощью команды dotnet add package:

   dotnet add package Azure.AI.OpenAI --prerelease
   

4. Для рекомендуемой проверки подлинности без ключа с помощью идентификатора Microsoft Entra установите пакет Azure.Identity с помощью:

   dotnet add package Azure.Identity
   

5. Для рекомендуемой проверки подлинности без ключа с помощью идентификатора Microsoft Entra войдите в Azure с помощью следующей команды:

   az login
   

Чтобы проверить подлинность приложения с помощью ресурса Azure OpenAI, необходимо получить следующие сведения:

Пример кода в этом кратком руководстве использует идентификатор Microsoft Entra для рекомендуемой проверки подлинности без ключей. Если вы предпочитаете использовать ключ API, можно заменить объект #D0 объектом #D1.

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

Чтобы запустить быстрый старт, выполните следующие действия.

1. Замените содержимое Program.cs следующим кодом и обновите значения заполнителей на ваши собственные.

   using Azure;
   using Azure.AI.OpenAI;
   using Azure.Identity;
   using OpenAI.Assistants;
   using OpenAI.Files;
   using System.ClientModel;
   
   // Assistants is a beta API and subject to change
   // Acknowledge its experimental status by suppressing the matching warning.
   #pragma warning disable OPENAI001
   
   string deploymentName = "gpt-4o";
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? "https://<your-resource-name>.openai.azure.com/";
   string key = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY") ?? "<your-key>";
   
   // Use the recommended keyless credential instead of the AzureKeyCredential credential.
   AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 
   //AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));
   
   OpenAIFileClient fileClient = openAIClient.GetOpenAIFileClient();
   AssistantClient assistantClient = openAIClient.GetAssistantClient();
   
   // First, let's contrive a document we'll use retrieval with and upload it.
   using Stream document = BinaryData.FromString("""
       {
           "description": "This document contains the sale history data for Contoso products.",
           "sales": [
               {
                   "month": "January",
                   "by_product": {
                       "113043": 15,
                       "113045": 12,
                       "113049": 2
                   }
               },
               {
                   "month": "February",
                   "by_product": {
                       "113045": 22
                   }
               },
               {
                   "month": "March",
                   "by_product": {
                       "113045": 16,
                       "113055": 5
                   }
               }
           ]
       }
       """).ToStream();
   
   OpenAI.Files.OpenAIFile salesFile = await fileClient.UploadFileAsync(
       document,
       "monthly_sales.json",
       FileUploadPurpose.Assistants);
   
   // Now, we'll create a client intended to help with that data
   OpenAI.Assistants.AssistantCreationOptions assistantOptions = new()
   {
       Name = "Example: Contoso sales RAG",
       Instructions =
           "You are an assistant that looks up sales data and helps visualize the information based"
           + " on user queries. When asked to generate a graph, chart, or other visualization, use"
           + " the code interpreter tool to do so.",
       Tools =
               {
                   new FileSearchToolDefinition(),
                   new OpenAI.Assistants.CodeInterpreterToolDefinition(),
               },
       ToolResources = new()
       {
           FileSearch = new()
           {
               NewVectorStores =
                   {
                       new VectorStoreCreationHelper([salesFile.Id]),
                   }
           }
       },
   };
   
   Assistant assistant = await assistantClient.CreateAssistantAsync(deploymentName, assistantOptions);
   
   // Create and run a thread with a user query about the data already associated with the assistant
   ThreadCreationOptions threadOptions = new()
   {
       InitialMessages = { "How well did product 113045 sell in February? Graph its trend over time." }
   };
   
   var initialMessage = new OpenAI.Assistants.ThreadInitializationMessage(OpenAI.Assistants.MessageRole.User, ["hi"]);
   
   ThreadRun threadRun = await assistantClient.CreateThreadAndRunAsync(assistant.Id, threadOptions);
   
   // Check back to see when the run is done
   do
   {
       Thread.Sleep(TimeSpan.FromSeconds(1));
       threadRun = assistantClient.GetRun(threadRun.ThreadId, threadRun.Id);
   } while (!threadRun.Status.IsTerminal);
   
   // Finally, we'll print out the full history for the thread that includes the augmented generation
   AsyncCollectionResult<OpenAI.Assistants.ThreadMessage> messages
       = assistantClient.GetMessagesAsync(
           threadRun.ThreadId,
           new MessageCollectionOptions() { Order = MessageCollectionOrder.Ascending });
   
   await foreach (OpenAI.Assistants.ThreadMessage message in messages)
   {
       Console.Write($"[{message.Role.ToString().ToUpper()}]: ");
       foreach (OpenAI.Assistants.MessageContent contentItem in message.Content)
       {
           if (!string.IsNullOrEmpty(contentItem.Text))
           {
               Console.WriteLine($"{contentItem.Text}");
   
               if (contentItem.TextAnnotations.Count > 0)
               {
                   Console.WriteLine();
               }
   
               // Include annotations, if any.
               foreach (TextAnnotation annotation in contentItem.TextAnnotations)
               {
                   if (!string.IsNullOrEmpty(annotation.InputFileId))
                   {
                       Console.WriteLine($"* File citation, file ID: {annotation.InputFileId}");
                   }
                   if (!string.IsNullOrEmpty(annotation.OutputFileId))
                   {
                       Console.WriteLine($"* File output, new file ID: {annotation.OutputFileId}");
                   }
               }
           }
           if (!string.IsNullOrEmpty(contentItem.ImageFileId))
           {
               OpenAI.Files.OpenAIFile imageFile = await fileClient.GetFileAsync(contentItem.ImageFileId);
               BinaryData imageBytes = await fileClient.DownloadFileAsync(contentItem.ImageFileId);
               using FileStream stream = File.OpenWrite($"{imageFile.Filename}.png");
               imageBytes.ToStream().CopyTo(stream);
   
               Console.WriteLine($"<image: {imageFile.Filename}.png>");
           }
       }
       Console.WriteLine();
   }
   

2. Запустите приложение, выполнив следующую команду:

   dotnet run
   

Выходные данные консоли должны выглядеть следующим образом:

[USER]: How well did product 113045 sell in February? Graph its trend over time.

[ASSISTANT]: Product 113045 sold 22 units in February. Let's visualize its sales trend over the given months (January through March).

I'll create a graph to depict this trend.

[ASSISTANT]: <image: 553380b7-fdb6-49cf-9df6-e8e6700d69f4.png>
The graph above visualizes the sales trend for product 113045 from January to March. As seen, the sales peaked in February with 22 units sold, and fluctuated over the period from January (12 units) to March (16 units).

If you need further analysis or more details, feel free to ask!

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants

Справочная документация | Исходный код библиотеки | Пакет (npm) |

• подписка Azure — создайте бесплатную учетную запись.
• Node.js поддержка LTS или ESM.
• Azure CLI , используемый для проверки подлинности без пароля в локальной среде разработки, создайте необходимый контекст, выполнив вход с помощью Azure CLI.
• Ресурс Azure OpenAI с совместимой моделью в поддерживаемом регионе.
• Мы рекомендуем ознакомиться с примечанием о прозрачности ответственного ИИ и другими ресурсами ответственного искусственного интеллекта, чтобы ознакомиться с возможностями и ограничениями службы Azure OpenAI.
• Ресурс Azure OpenAI с уже развернутой моделью gpt-4 (1106-preview) был использован для тестирования этого примера.

Для рекомендуемой проверки подлинности без ключа с помощью идентификатора Microsoft Entra необходимо:

• Установите Azure CLI, используемый для проверки подлинности без ключа с помощью идентификатора Microsoft Entra.
• Назначьте роль Cognitive Services User своей учетной записи пользователя. Роли можно назначить в портале Azure в разделе Управление доступом (IAM)>Добавление роли.

1. Создайте новую папку assistants-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir assistants-quickstart && cd assistants-quickstart
   

2. Создайте package.json с помощью следующей команды:

   npm init -y
   

3. Установите клиентскую библиотеку OpenAI для JavaScript с помощью:

   npm install openai
   

4. Для рекомендуемой аутентификации без пароля:

   npm install @azure/identity
   

Чтобы проверить подлинность приложения с помощью ресурса Azure OpenAI, необходимо получить следующие сведения:

В нашем коде мы укажем следующие значения:

Отдельный помощник может получить доступ к 128 инструментам, включая code interpreter, а также любые пользовательские инструменты, создаваемые с помощью функций.

Assistant created: {"id":"asst_zXaZ5usTjdD0JGcNViJM2M6N","createdAt":"2024-04-08T19:26:38.000Z","name":"Math Tutor","description":null,"model":"daisy","instructions":"You are a personal math tutor. Write and run JavaScript code to answer math questions.","tools":[{"type":"code_interpreter"}],"fileIds":[],"metadata":{}}
Thread created: {"id":"thread_KJuyrB7hynun4rvxWdfKLIqy","createdAt":"2024-04-08T19:26:38.000Z","metadata":{}}
Message created:  {"id":"msg_o0VkXnQj3juOXXRCnlZ686ff","createdAt":"2024-04-08T19:26:38.000Z","threadId":"thread_KJuyrB7hynun4rvxWdfKLIqy","role":"user","content":[{"type":"text","text":{"value":"I need to solve the equation `3x + 11 = 14`. Can you help me?","annotations":[]},"imageFile":{}}],"assistantId":null,"runId":null,"fileIds":[],"metadata":{}}
Created run
Run created:  {"id":"run_P8CvlouB8V9ZWxYiiVdL0FND","object":"thread.run","status":"queued","model":"daisy","instructions":"You are a personal math tutor. Write and run JavaScript code to answer math questions.","tools":[{"type":"code_interpreter"}],"metadata":{},"usage":null,"assistantId":"asst_zXaZ5usTjdD0JGcNViJM2M6N","threadId":"thread_KJuyrB7hynun4rvxWdfKLIqy","fileIds":[],"createdAt":"2024-04-08T19:26:39.000Z","expiresAt":"2024-04-08T19:36:39.000Z","startedAt":null,"completedAt":null,"cancelledAt":null,"failedAt":null}
Message content: "The solution to the equation \\(3x + 11 = 14\\) is \\(x = 1\\)."
Message content: "Yes, of course! To solve the equation \\( 3x + 11 = 14 \\), we can follow these steps:\n\n1. Subtract 11 from both sides of the equation to isolate the term with x.\n2. Then, divide by 3 to find the value of x.\n\nLet me calculate that for you."
Message content: "I need to solve the equation `3x + 11 = 14`. Can you help me?"

Важно помнить, что, хотя интерпретатор кода дает модели возможность реагировать на более сложные запросы, преобразовав вопросы в код и выполняя этот код итеративно в JavaScript, пока он не достигнет решения, необходимо проверить ответ, чтобы убедиться, что модель правильно преобразовала вопрос в допустимое представление в коде.

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

• Пример кода для быстрого старта

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants

Справочная документация | Исходный код библиотеки | Пакет (npm) |

• подписка Azure — создайте бесплатную учетную запись.
• Node.js поддержка LTS или ESM.
• TypeScript , установленный глобально
• Azure CLI , используемый для проверки подлинности без пароля в локальной среде разработки, создайте необходимый контекст, выполнив вход с помощью Azure CLI.
• Ресурс Azure OpenAI с совместимой моделью в поддерживаемом регионе.
• Мы рекомендуем ознакомиться с примечанием о прозрачности ответственного ИИ и другими ресурсами ответственного искусственного интеллекта, чтобы ознакомиться с возможностями и ограничениями службы Azure OpenAI.
• Ресурс Azure OpenAI с gpt-4 (1106-preview) развернутой моделью использовался для тестирования этого примера.

Для рекомендуемой проверки подлинности без ключа с помощью идентификатора Microsoft Entra необходимо:

• Установите Azure CLI, используемый для проверки подлинности без ключа с помощью идентификатора Microsoft Entra.
• Назначьте роль Cognitive Services User вашей учетной записи пользователя. Роли можно назначить на портале Azure в разделе Управление доступом (IAM)>Добавить назначение ролей.

1. Создайте новую папку assistants-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir assistants-quickstart && cd assistants-quickstart
   

2. Создайте package.json с помощью следующей команды:

   npm init -y
   

3. Обновите package.json на ECMAScript с помощью следующей команды:

   npm pkg set type=module
   

4. Установите клиентскую библиотеку OpenAI для JavaScript с помощью:

   npm install openai
   

5. Для рекомендуемой аутентификации без пароля:

   npm install @azure/identity
   

Чтобы проверить подлинность приложения с помощью ресурса Azure OpenAI, необходимо получить следующие сведения:

В нашем коде мы укажем следующие значения:

Отдельный помощник может получить доступ к 128 инструментам, включая code interpreter, а также к любым пользовательским инструментам, создаваемым с помощью функций.

Assistant created: {"id":"asst_zXaZ5usTjdD0JGcNViJM2M6N","createdAt":"2024-04-08T19:26:38.000Z","name":"Math Tutor","description":null,"model":"daisy","instructions":"You are a personal math tutor. Write and run JavaScript code to answer math questions.","tools":[{"type":"code_interpreter"}],"fileIds":[],"metadata":{}}
Thread created: {"id":"thread_KJuyrB7hynun4rvxWdfKLIqy","createdAt":"2024-04-08T19:26:38.000Z","metadata":{}}
Message created:  {"id":"msg_o0VkXnQj3juOXXRCnlZ686ff","createdAt":"2024-04-08T19:26:38.000Z","threadId":"thread_KJuyrB7hynun4rvxWdfKLIqy","role":"user","content":[{"type":"text","text":{"value":"I need to solve the equation `3x + 11 = 14`. Can you help me?","annotations":[]},"imageFile":{}}],"assistantId":null,"runId":null,"fileIds":[],"metadata":{}}
Created run
Run created:  {"id":"run_P8CvlouB8V9ZWxYiiVdL0FND","object":"thread.run","status":"queued","model":"daisy","instructions":"You are a personal math tutor. Write and run JavaScript code to answer math questions.","tools":[{"type":"code_interpreter"}],"metadata":{},"usage":null,"assistantId":"asst_zXaZ5usTjdD0JGcNViJM2M6N","threadId":"thread_KJuyrB7hynun4rvxWdfKLIqy","fileIds":[],"createdAt":"2024-04-08T19:26:39.000Z","expiresAt":"2024-04-08T19:36:39.000Z","startedAt":null,"completedAt":null,"cancelledAt":null,"failedAt":null}
Message content: "The solution to the equation \\(3x + 11 = 14\\) is \\(x = 1\\)."
Message content: "Yes, of course! To solve the equation \\( 3x + 11 = 14 \\), we can follow these steps:\n\n1. Subtract 11 from both sides of the equation to isolate the term with x.\n2. Then, divide by 3 to find the value of x.\n\nLet me calculate that for you."
Message content: "I need to solve the equation `3x + 11 = 14`. Can you help me?"

Важно помнить, что, хотя интерпретатор кода дает модели возможность реагировать на более сложные запросы, преобразовав вопросы в код и выполняя этот код итеративно в JavaScript, пока он не достигнет решения, необходимо проверить ответ, чтобы убедиться, что модель правильно преобразовала вопрос в допустимое представление в коде.

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

• Образец кода для быстрого старта

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants

• подписка Azure — создайте бесплатную учетную запись.
• Python 3.8 или более поздней версии
• Ресурс Azure OpenAI с совместимой моделью в поддерживаемом регионе.
• Мы рекомендуем ознакомиться с примечанием о прозрачности ответственного ИИ и другими ресурсами ответственного искусственного интеллекта, чтобы ознакомиться с возможностями и ограничениями службы Azure OpenAI.
• Ресурс Azure OpenAI с gpt-4 (1106-preview) развернутой моделью использовался для тестирования этого примера.

Чтобы успешно выполнить вызов к Azure OpenAI, вам потребуется следующее:

Перейдите к своему ресурсу на портале Azure. Конечную точку и ключи можно найти в разделе Управление ресурсами. Скопируйте конечную точку и ключ доступа, так как они потребуются для проверки подлинности вызовов API. Вы можете использовать KEY1 или KEY2. Наличие двух ключей позволяет безопасно менять и повторно создавать ключи без прерывания работы службы.

Создайте и назначьте переменные постоянной среды для ключа и конечной точки.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/assistants?api-version=2024-05-01-preview \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "You are an AI assistant that can write code to help answer math questions.",
    "name": "Math Assist",
    "tools": [{"type": "code_interpreter"}],
    "model": "gpt-4-1106-preview"
  }'

Отдельный помощник может получить доступ к 128 инструментам, включая code interpreter, а также любые пользовательские инструменты, создаваемые с помощью функций.

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d ''

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/thread_abc123/messages \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d '{
      "role": "user",
      "content": "I need to solve the equation `3x + 11 = 14`. Can you help me?"
    }'

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/thread_abc123/runs \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "asst_abc123",
  }'

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/thread_abc123/runs/run_abc123 \
  -H "api-key: $AZURE_OPENAI_API_KEY" \

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/thread_abc123/messages \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \

В этом примере мы создадим помощника с включенным интерпретатором кода. Когда мы задаем помощнику математический вопрос, он преобразует вопрос в код Python и выполняет код в изолированной среде, чтобы определить ответ на этот вопрос. Код, который создает и тестирует модель, чтобы получить ответ:

    from sympy import symbols, Eq, solve  
      
    # Define the variable  
    x = symbols('x')  
      
    # Define the equation  
    equation = Eq(3*x + 11, 14)  
      
    # Solve the equation  
    solution = solve(equation, x)  
    solution  

Важно помнить, что в то время как интерпретатор кода дает модели возможность реагировать на более сложные запросы, преобразовав вопросы в код и выполняя этот код итеративно в песочнице Python, пока он не достигнет решения, необходимо проверить ответ, чтобы убедиться, что модель правильно преобразовала вопрос в допустимое представление в коде.

Если вы хотите очистить и удалить ресурс Azure OpenAI, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы.

• Портал Azure
• Azure CLI

• Узнайте больше об использовании помощников с нашим руководством по помощникам.
• Примеры API Azure OpenAI Assistants