Премини към основното съдържание
Български— Изберете език
Меню

Responses API и function_call_output

Урок 10 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Responses API: новият крайна точка (endpoint)
  2. Разлики спрямо Chat Completions
  3. Използване на Responses API със SDK на OpenAI
  4. Обработка на отговора
  5. Полето previous_response_id
  6. Съхранение на съобщенията на сървъра
  7. Кога да използвате Responses API?
  8. Ключови изводи

Responses API: новият крайна точка (endpoint)

Responses API е новата основна крайна точка на xAI, различна от съвместимата с OpenAI крайна точка за Chat Completions. Тя въвежда различен формат за извикване на функции, използвайки типа function_call_output за връщане на резултати от инструменти.

Разлики спрямо Chat Completions

Крайната точка Chat Completions (съвместима с OpenAI) използва съобщения с роля tool за връщане на резултати. Responses API използва различен формат, структуриран около типове събития.

Chat Completions (стар формат)

# Връщане на резултата чрез съобщение с роля "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (нов формат)

# Връщане на резултата чрез обект function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Основни разлики:

  • type: "function_call_output" замества role: "tool"
  • call_id замества tool_call_id
  • output замества content

Използване на Responses API със SDK на OpenAI

Можете да използвате SDK на OpenAI, за да извикате Responses API на xAI:

from openai import OpenAI

client = OpenAI(
    api_key="votre-cle-api",
    base_url="https://api.x.ai/v1"
)

# Създаване на отговор с инструменти
response = client.responses.create(
    model="grok-4.5",
    input="What's the weather like in Paris?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get the weather for a city",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }
    }]
)

Имайте предвид, че Responses API използва input вместо messages, а структурата на инструментите е леко различна (липсва вложен обект function).

Обработка на отговора

Отговорът от Responses API съдържа масив output със събития:

for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}")
        print(f"Arguments: {item.arguments}")
        print(f"Call ID: {item.call_id}")

        # Изпълнение на функцията
        result = get_weather(city="Paris")

        # Продължаване на разговора с резултата
        follow_up = client.responses.create(
            model="grok-4.5",
            input=[
                {"type": "function_call_output",
                 "call_id": item.call_id,
                 "output": json.dumps(result)}
            ],
            tools=tools,
            previous_response_id=response.id
        )

Полето previous_response_id

Responses API въвежда механизъм за верижно свързване на разговори чрез previous_response_id. Вместо да изпращате отново цялата история на съобщенията, просто правите препратка към предишния отговор:

# Първа заявка
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Втора заявка (свързана)
response2 = client.responses.create(
    model="grok-4.5",
    input=[{
        "type": "function_call_output",
        "call_id": response1.output[0].call_id,
        "output": {temp: 22}
    }],
    previous_response_id=response1.id
)

Това опростява управлението на контекста и намалява размера на заявките.

Съхранение на съобщенията на сървъра

При store_messages=True, xAI съхранява съобщенията на своите сървъри:

response = client.responses.create(
    model="grok-4.5",
    input="User question",
    tools=tools,
    store_messages=True
)

В комбинация с previous_response_id, това Ви позволява да поддържате дълги разговори, без да изпращате отново пълната история при всяка заявка.

Кога да използвате Responses API?

За нов проект, изграден специално върху xAI, Responses API е изборът по подразбиране поради няколко натрупващи се причини. Иновациите пристигат тук първи – новите функции се добавят към Responses API преди всякъде другаде, понякога ексклузивно. Някои вградени сървърни инструменти са достъпни само чрез този канал. А за дълги разговори, верижното свързване чрез previous_response_id е структурно по-ефективно от повторното изпращане на пълната история при всеки ход: по-малко прехвърлени токени, по-малко код за управление на състоянието от Ваша страна.

Chat Completions запазва две силни приложения: съществуващ код, написан за API на OpenAI, който работи както си е, чрез промяна на базовия URL, и проекти с множество доставчици, където преносимостта има приоритет – в тези ситуации съвместимостта надделява над ексклузивните функции.

Ключови изводи

  • Responses API използва function_call_output вместо ролята tool
  • Полетата се променят: call_id вместо tool_call_id, output вместо content
  • previous_response_id Ви позволява да свързвате разговори, без да изпращате отново историята
  • store_messages=True активира съхранение на сървъра
  • Responses API е препоръчителната крайна точка за нови проекти на xAI
  • Chat Completions остава наличен за обратна съвместимост с OpenAI