Promte Responses API kort fortalt

Promtes Responses API bruges til at sende input til en specifik Promte assistent og få et genereret svar retur. API’et er kompatibelt i struktur og tankegang med OpenAI Responses API og understøtter både stateless kald og samtaler med kontekst.

API’et kræver en API key, som oprettes i Promte under Settings > API og sendes som Bearer token.

Endpoint:

POST https://<kundes-promtedomæne>.dk/api/v1/responses

Simpelt request

curl --location '<https://kommune.applai.dk/api/v1/responses>' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Bearer TOKEN_HERE' \\
--data '{
  "input": "Hvor kan man parkere?",
  "stream": false
}'

Responsen indeholder bl.a. det genererede svar samt et conversation.id, som kan bruges til at fortsætte samme samtale.

Fortsæt en samtale

For at bevare kontekst sender du conversation.id med i næste kald.

curl --location '<https://kommune.applai.dk/api/v1/responses>' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Bearer TOKEN_HERE' \\
--data '{
  "input": "Hvad koster det i timen?",
  "stream": false,
  "conversation": {
    "id": "cd2a54fd-deaa-4284-9295-9b12e18f49c8"
  }
}'

Overskriv assistentens persona

Du kan sende instructions med i requestet for midlertidigt at overskrive assistentens instruktioner.

curl --location '<https://kommune.applai.dk/api/v1/responses>' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Bearer TOKEN_HERE' \\
--data '{
  "input": "Hvor kan man parkere?",
  "instructions": "Du er en meget venlig og kortfattet assistent",
  "stream": false
}'

Streaming

Hvis stream sættes til true, returnerer API’et svaret som Server Sent Events, hvilket er velegnet til realtime visning i UI eller testværktøjer.

Typiske use cases