Unique, URL-safe agent name within the project
Request body
Optionalcontext?: {Optionalconversation_id?: stringOptionalcustom?: { [key: string]: unknown }Optionaluser_id?: stringChat response successful
Invoke an agent
Execute a one-shot task with an agent. This endpoint is designed for task-oriented operations where you provide input and receive a complete output.
Use cases:*
Streaming:* Set stream: true in the request body to receive Server-Sent Events (SSE)
stream with incremental chunks. Useful for long-running tasks or real-time progress updates.
Unique, URL-safe agent name within the project
Request body
Optionalcontext?: {Optionalconversation_id?: stringOptionalcustom?: { [key: string]: unknown }Optionaluser_id?: stringAgent invocation successful
Chat with an agent
Have a conversational interaction with an agent. This endpoint maintains conversation context through the messages array, allowing for multi-turn conversations.
Use cases:*
Message format:* Follows OpenAI-compliant message structure with support for:
system,user,assistant, andtoolrolesStreaming:* Set
stream: truein the request body to receive Server-Sent Events (SSE) stream with incremental chunks. Perfect for ChatGPT-like real-time chat interfaces.