Skip to main content
POST
Invoke an Expert (SSE stream)

授权

Authorization
string
header
必填

OAuth2 access token issued via POST /oauth/token

请求头

X-Profy-End-User-Id
string

Integrator terminal-user id for state isolation. Billing still charges the API key owner.

请求体

application/json
expert_identifier
string
必填

Expert identifier (e.g. 'my-expert')

message
string
必填

User message to send to the Expert

session_id
string

Existing session ID to continue a conversation (optional)

model
string

Override model selection (optional)

attachment_file_ids
string[]

File ids from POST /v1/files. Each file is materialized in the Expert's sandbox at /home/user/uploads/. Ids only — the platform never fetches a caller-supplied URL.

Maximum array length: 20
tool_confirmations
object[]

HITL resume answers. When non-empty, message may be empty.

enabled_plugins
string[]

Plugin ids for this turn (Composer chip equivalent). Empty array clears sticky selection.

skill_names
string[]

Qualified skill names: user/ or expert/.

enable_memory
boolean
默认值:false

Opt-in memory for Platform invokes. Default false until end-user isolation ships.

permission_mode
enum<string>

Only "plan" is accepted.

可用选项:
plan
working_directory
string
selected_image_model
string
selected_video_model
string
selected_speech_model
string
selected_music_model
string
image_parameters
object
video_parameters
object

响应

SSE stream with agent response events

The response is of type string.