Hoppa till navigering

Hämta konversationssammanfattning

Hämta en kortfattad sammanfattning av ett samtal: dess titel, den genererade sammanfattningen av transkriptet, om samtalet lyckades och – endast när samtalet är kort – vanliga chattmeddelanden. Verktygsanrop, verktygsresultat och kontextuella uppdateringar utelämnas för att hålla svaret litet. Använd detta i stället för endpointen för hela samtalet när du bara behöver huvuddragen (t.ex. när en agent läser många samtal); använd GET /v1/convai/conversations/{conversation_id} när du behöver hela transkriptet med verktygsanrop och kontextuella uppdateringar.

Sökvägsparametrar

conversation_idstringObligatorisk

ID:t för konversationen du utför åtgärden på.

Headers

xi-api-keystringValfri

Frågeparametrar

max_messagesintegerValfri1-200Standard är 40

Maximalt antal chattmeddelandeturer att inkludera inline. När konversationen har fler än detta utelämnas meddelandena och messages_omitted anges.

Svar

Lyckat svar
conversation_idstring
agent_idstring
statusenum
Tillåtna värden:
message_countinteger
Antal vanliga chattmeddelandeturer i konversationen.
notestring

Anvisningar som berättar för agenten hur den hämtar hela transkriptet.

call_summary_titlestring or nullValfri

Kort genererad titel för konversationen.

transcript_summarystring or nullValfri

Genererad sammanfattning av samtalet på naturligt språk.

call_successfulenum or nullValfri
Tillåtna värden:
messageslist of objects or nullValfri

De vanliga chattmeddelandena (endast roll och text). Inkluderas endast när message_count inte överstiger den begärda max_messages; annars är värdet null och messages_omitted är true.

messages_omittedbooleanValfriStandard är false

True när chattmeddelandena utelämnades eftersom samtalet var för långt. Hämta hela transkriptet för meddelandena.

Fel

422
Unprocessable Entity Error