Zum Hauptinhalt springen
POST
{baseUrl}
/
api
/
agents
/
{agent_uuid}
/
chat
/
Error
A valid request URL is required to generate request examples
{
  "message": "<string>",
  "conversation_id": "<string>",
  "run_id": "<string>"
}
Sendet eine Nachricht an einen Agent. Der Endpunkt streamt die Modellantwort. API-Keys mussen Streaming explizit erlauben, wenn der Client Streaming anfordert.
Erforderlicher API-Key-Scope: agents:run.

​
Path-Parameter

​
agent_uuid
string
erforderlich
UUID des Agents.

​
Body-Parameter

​
message
string
erforderlich
Nachricht an den Agent. Maximale Lange: 32000 Zeichen.
​
conversation_uuid
string
UUID einer bestehenden Unterhaltung. Ohne Wert startet Pharen eine neue Unterhaltung.
​
model
string
Optionales Modell. Ohne Wert nutzt Pharen das Standardmodell des Agents.
​
enable_thinking
boolean
Aktiviert Reasoning, wenn das Modell es unterstutzt.
​
page_context
object
Optionaler JSON-Kontext der aufrufenden Seite.

​
Beispiel-Body

{
  "message": "Fasse die offenen Aufgaben in diesem Workspace zusammen.",
  "enable_thinking": true
}

Autorisierungen

​
Authorization
string
header
Standard:phk_your_api_key
erforderlich

Paste your Pharen API key without the Bearer prefix.

Pfadparameter

​
agent_uuid
string<uuid>
erforderlich

Agent UUID.

Body

application/json
​
message
string
erforderlich
Beispiel:

"Summarize the latest onboarding blockers."

​
conversation_id
string

Optional conversation identifier for continuing a thread.

​
context
object

Optional structured context for the agent.

Antwort

Agent response returned.

​
message
string
​
conversation_id
string
​
run_id
string