Assistants API: создание и список ассистентов

POST /v2/assistants — создание ассистента

Создаёт нового ассистента с нужной моделью, параметрами и инструментами (tools).

Запрос

POST {{API_HOST}}/v2/assistants

Заголовки

X-Auth-Token: YOUR_API_KEY  
Content-Type: application/json

Пример тела запроса

{
  "vendor": "openai",
  "model": "gpt-4o",
  "name": "Support Assistant",
  "description": "Ассистент поддержки",
  "instructions": "Отвечай строго и кратко, используй корпоративный стиль.",
  "reasoning_effort": "low",
  "temperature": 1,
  "max_tokens": 2048,
  "is_common": true,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_order_status",
        "description": "Получить статус заказа",
        "parameters": {
          "type": "object",
          "properties": {
            "order_id": {
              "type": "string",
              "description": "ID заказа"
            }
          },
          "required": ["order_id"],
          "additionalProperties": false
        },
        "strict": true
      }
    }
  ],
  "tool_resources": {
    "file_search": {
      "vector_store_ids": ["abc123"]
    }
  },
  "metadata": {
    "account_id": 1,
    "client_id": 5
  },
  "users": []
}

Ключевые параметры

vendor

string

Да

Вендор модели (openai, gigachat, ...)
Список вендоров моделей

model

string

Да

Модель, например: gpt-4o
Список вендоров моделей

name

string

Да

Название ассистента

description

string

Нет

Описание

instructions

string

Нет

Поведение ассистента (system prompt)

reasoning_effort

string

Нет

low, medium, high — нагрузка на модель

temperature

float

Нет

Креативность ответа (0–2)

max_tokens

int

Нет

Ограничение на длину вывода

tools

array

Нет

Поддерживаемые инструменты

tool_resources

object

Нет

Привязанные file_search vector_store_ids

is_common

boolean

Нет

Общий ли ассистент для всех пользователей

GET /v2/assistants — список ассистентов

Возвращает список всех ассистентов текущего пользователя или аккаунта.

Запрос

GET {{API_HOST}}/v2/assistants

Ответ

[
  {
    "id": 404,
    "name": "Support Assistant",
    "vendor": "openai",
    "model": "gpt-4o",
    "description": "Ассистент поддержки",
    "temperature": 1,
    "is_common": true,
    "instructions": "...",
    "tools": [...],
    "tool_resources": {
      "file_search": {
        "vector_store_ids": ["abc123"]
      }
    },
    "created_at": "2025-06-24 12:00:00"
  },
  ...
]

Применение

Интеграция AI-ассистентов в корпоративные порталы и CRM

Персональные и командные ассистенты с доступом к данным

Ассистенты с функциями (function calling) и RAG (через vector store)