[SYNDERESIS / API](/pl/dokumentacja/) TWORZENIE


Hostowane API dla klientów · Kontrakt przejrzany 7 listopada 2026



# Streaming i wywoływanie funkcji


Na tej stronie- [Streaming i wywoływanie funkcji](#streaming-and-function-calling)- [Obsługa streamingu](#streaming-support)

- [Żądanie strumienia](#request-a-stream)

- [Wywoływanie funkcji](#function-calling)

- [Pełna pętla narzędzi](#the-complete-tool-loop)

- [Anulowanie i limity czasu](#cancellation-and-timeouts)


Do jawnej historii rozmowy oraz wywołań funkcji użyj interfejsu Chat Completions dla transkryptu i narzędzi. Te możliwości nie dotyczą automatycznie adaptera odpowiedzi świadomego źródeł.



## Obsługa streamingu


| Endpoint/żądanie | Zachowanie |



| POST /v1/answers | Odpowiedź JSON; brak publicznego trybu streamingu. `POST /v1/answers` ignoruje `stream` i `tools`. |

| Czat z model=synderesis-spark i stream=true, z narzędziami lub bez | Zdarzenia wysyłane przez serwer po zakończeniu generowania. |

| Czat z model=spark, pro lub synderesis-pro, narzędzia obecne, stream=true | Ten sam kontrakt SSE dla transkryptu i narzędzi. |

| Czat, który obiera ścieżkę odpowiedzi (w tym automatyczny wybór), ze stream=true | 400 unsupported_parameter. |

| Czat z automatycznym wyborem i narzędziami lub wynikami narzędzi | 400 unsupported_parameter; automatyczny wybór nigdy nie obiera ścieżki narzędzi. |

| Strumień obszaru roboczego przeglądarki | Osobny kontrakt sesji/aplikacji, poza tym przewodnikiem po SDK dla klientów. |


**Odpowiedź SSE czatu klienta jest buforowana.** Serwer uzyskuje kompletną odpowiedź modelu i rejestruje jej użycie, zanim wyemituje jej ramki. Jest to dostarczanie buforowane, a nie strumieniowanie tokenów na żywo. Ustawienie stream=true nie obiecuje wcześniejszego dostarczenia pierwszego tokenu ani nie ujawnia strumienia na żywo obszaru roboczego przeglądarki.



## Zażądaj strumienia



```
curl --fail-with-body --no-buffer https://www.synderesis.eu/v1/chat/completions \
  -H "Authorization: Bearer $SYNDERESIS_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"synderesis-spark","messages":[{"role":"user","content":"Describe human dignity briefly."}],"max_completion_tokens":1024,"stream":true,"stream_options":{"include_usage":true}}'
```


Typ treści odpowiedzi to text/event-stream. Każde zdarzenie JSON jest wierszem danych, po którym następuje pusty wiersz. Schematyczna sekwencja jest następująca:



```
data: {"id":"chatcmpl-example","model":"synderesis-spark","created":1793966400,"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Illustrative answer."},"finish_reason":null}]}

data: {"id":"chatcmpl-example","model":"synderesis-spark","created":1793966400,"object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-example","model":"synderesis-spark","created":1793966400,"object":"chat.completion.chunk","choices":[],"usage":{"prompt_tokens":120,"completion_tokens":30,"total_tokens":150}}

data: [DONE]
```


Pierwsza delta może zawierać kompletną tablicę wywołań narzędzi zamiast tekstu. Strumieniowane wywołania narzędzi zawierają wartości indeksu. Osobny fragment usage jest dołączany tylko wtedy, gdy stream_options.include_usage ma dokładnie wartość true.


Parsuj ramkowanie SSE przed JSON. Odczyt sieciowy niekoniecznie jest jednym zdarzeniem. Uwzględnij pustą tablicę choices we fragmencie usage. Zachowaj finish_reason i rozpoznaj brakujący znacznik DONE jako niekompletny transfer. Nie powtarzaj automatycznie przerwanej generacji; jej użycie mogło już zostać zarejestrowane.


Błędy uwierzytelniania, walidacji, limitu i generowania występują, zanim ten buforowany strumień zostanie otwarty, i używają zwykłej odpowiedzi błędu JSON.



## Wywoływanie funkcji


Synderesis zwraca proponowane wywołania funkcji; **Twoja aplikacja wykonuje te funkcje**. Punkt końcowy completion dla klienta nie uruchamia dowolnego kodu klienckiego.


Definicja funkcji ma następującą postać:



```
{
  "type": "function",
  "function": {
    "name": "lookup_opening_hours",
    "description": "Read the published opening hours for a location.",
    "parameters": {
      "type": "object",
      "properties": {"location": {"type": "string"}},
      "required": ["location"],
      "additionalProperties": false
    }
  }
}
```


Niepusta tablica tools może zawierać 1–128 definicji o niepowtarzalnych nazwach funkcji. Nazwa musi składać się z 1–64 liter ASCII, cyfr, znaków podkreślenia lub łączników. Zserializowane definicje narzędzi są ograniczone do 512 KiB; kompletne żądanie ma także własny limit 900 KiB.


Obiekt funkcji obsługuje name, description, parameters i strict. Jeśli strict jest podane, musi być typu boolean. Akceptacja strict nie stanowi gwarancji, że zwrócone argumenty spełniają cały Twój JSON Schema. Procedura obsługi sprawdza nazwy wywołań narzędzi oraz to, że argumenty dekodują się do obiektu; Twoja aplikacja musi zweryfikować rzeczywisty schemat i autoryzować żądaną akcję.


tool_choice przyjmuje auto, none, required lub:



```
{"type":"function","function":{"name":"lookup_opening_hours"}}
```


Wybór nazwany musi odwoływać się do podanej funkcji. parallel_tool_calls domyślnie ma wartość true. Jeśli zwróconych zostanie kilka wywołań, zbierz wynik dla każdego z nich, zanim kontynuujesz konwersację.



## Kompletna pętla narzędzi


- Wyślij wiadomości system/user, definicje funkcji i jawnie wskazany obsługiwany model: `synderesis-spark`, `spark`, `pro` lub `synderesis-pro`. Pominięcie `model` wybiera automatyczny wybór, który odrzuca narzędzia z 400 unsupported_parameter.

- Sprawdź choices[0].message.tool_calls.

- Parsuj każdy ciąg JSON function.arguments.

- Zweryfikuj jego nazwę i argumenty względem swojej lokalnej listy dozwolonych/swojego lokalnego schematu oraz uprawnień bieżącego użytkownika.

- Wykonaj dozwolony odczyt lub dozwoloną akcję we własnej aplikacji.

- Dołącz kompletną wiadomość roli assistant z wywołaniem narzędzia.

- Dołącz po jednej wiadomości o roli tool dla każdego wywołania, z odpowiadającym tool_call_id i treścią będącą łańcuchem znaków.

- Wyślij ponownie rozszerzony transkrypt i narzędzia.


Na przykład kontynuacja może zawierać:



```
[
  {"role":"user","content":"When does the parish office open?"},
  {
    "role":"assistant",
    "content":null,
    "tool_calls":[{
      "id":"call_example",
      "type":"function",
      "function":{"name":"lookup_opening_hours","arguments":"{\"location\":\"parish office\"}"}
    }]
  },
  {"role":"tool","tool_call_id":"call_example","content":"Published hours: Monday 09:00–12:00."}
]
```


Wyniki narzędzi to dane niezaufane. Nie umieszczaj w wynikach tajemnic ani zbędnych danych osobowych. Żądaj zgody użytkownika na działania o rzeczywistych skutkach zgodnie z własnymi wymaganiami Twojej aplikacji. Ogranicz liczbę tur, czas zegarowy, koszt i wywołania równoległe, aby pętla nie mogła działać w nieskończoność.


Każde completion w pętli jest osobnym żądaniem z własnym zużyciem. Pomyślne przekazanie funkcji do wykonania w Twojej aplikacji nie oznacza, że późniejsza odpowiedź modelu zakończy się powodzeniem. Dla skutków zewnętrznych stosuj własną idempotentność i własny rejestr działań swojej aplikacji.



## Anulowanie i przekroczenia czasu


Zamknięcie strumienia klienta lub przekroczenie czasu nie gwarantuje, że anulowano obliczenia nadrzędne, rejestrację użycia albo działanie zewnętrzne. Buforowane SSE jest generowane po zakończeniu pracy modelu. Traktuj niepewne wyniki jako niepewne, uzgodnij je i unikaj automatycznego powtarzania działań narzędzi o rzeczywistych skutkach.


Zobacz [Wskazówki dla środowiska produkcyjnego](/pl/dokumentacja/wdrozenie-produkcyjne/#retries-and-uncertain-outcomes) dotyczące strategii ograniczonych ponowień.


[Przegląd](/pl/dokumentacja/)[Referencja API →](/pl/dokumentacja/specyfikacja/)


[Przeczytaj ten przewodnik jako Markdown](/pl/docs/streaming-and-tools.md)
