작업 공간 에이전트 호출하고 해당 응답을 서버 전송 이벤트로 스트리밍합니다. 세션을 계속하려면 이전 응답에서 반환된 X-Session ID 값을 보냅니다. 헤더를 생략하면 게이트웨이는 새 세션을 시작하고 응답 헤더에 해당 ID 반환합니다. body session_id 필드 세션을 계속하지 않습니다. 본문에는 예비 최상위 필드를 포함할 수 있습니다. 게이트웨이는 예약된 필드인 message, session_id, user_id 및 resume_map을 제외한 모든 필드 전달합니다. resume_map은 일시 중단된 회전을 계속합니다. 기록이 없는 세션의 경우 resume_map이 초기 에이전트 입력이 됩니다. 유효한 무기명 토큰이 필요합니다.
헤더
-
이전 응답에서 반환된 세션 ID . 해당 세션을 계속하려면 전송합니다. 유효한 ID는 [A-Za-z0-9_-]{1,128}$와 일치합니다. 생략하면 게이트웨이가 새 세션을 시작합니다. 본문 session_id가 세션을 계속하지 않습니다.
-
새로 생성된 세션을 테스트 세션으로 분류합니다. 기존 분류가 변경되지 않음
body
필수 사항
요청 호출
-
다른 에이전트 필드가 제공되는 경우 선택 사항: 채팅 상담원을 위한 채팅 입력. 예약된 필드 이름입니다.
-
ResumeMap에는 OE에서 해결한 인터럽트별 답변이 포함되어 있습니다. OE는 답변 할 로컬 일시 중단된 차례가 존재하지 않는 세션의 첫 실행을 시작할 때만 일반 입력으로 에이전트 에 전달합니다.
추가 속성이 허용됩니다.
-
선택적 호환성 필드. 게이트웨이는 세션 연속성을 위해 이를 무시합니다. 세션을 계속하려면 대신 X-Session- ID 전송합니다. 예약된 필드 이름입니다.
-
개인화 및 메모리 격리 에 사용되는 선택적 ID입니다. 인간 및 API 키 호출은 이 값을 사용하거나 인증된 사용자를 기본값 사용합니다. 서비스 계정 호출은 항상 서비스 계정 ID를 사용합니다. 서비스 계정은 아직 다른 사용자 역할을 할 수 없습니다. 예약된 필드 이름입니다.
응답
-
지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
-
SSE 스트림. 사전 헤더 오류(첫 번째 프레임 이전)는 아래 JSON 오류 본문 중 하나로 렌더링됩니다. 중간 스트림 실패는 대신 스타트업 실패 엔벨로프에 대한 메타데이터 객체 에서 동일한 코드/오류와 함께 소스/컴포넌트/샌드박스/부팅_id를 전달하는 터미널 SSE 청크 로 렌더링됩니다.
-
잘못된 요청
-
승인되지 않음
-
충돌
-
PROJECT_SECRET_INVALID: 프로젝트 시크릿이 유효하지 않거나 연결할 수 없기 때문에 작업 공간을 시작할 수 없습니다(시크릿 수정 및 재배포). 스트림 중간에 code=PROJECT_SECRET_INVALID를 전달하는 터미널 SSE 청크 로 표시됩니다.
-
요청이 너무 많음
-
ErrorResponse 또는 AGENT_STARTUP_FAILED/STARTUP_FAILED 스타트업 실패에 대한 StartupFailureResponse
-
POOL_EXHAUSTED/EXECUTOR_BOOT_FAILED/PLATFORM_DEPENDENCY_FAILED/POOL_UNREACHABLE 스타트업 실패에 대한 StartupFailureResponse입니다. 그렇지 않으면 ErrorResponse를 반환합니다. POOL_EXHAUSTED는 Retry-After 헤더를 전달합니다.
-
게이트웨이 시간 초과
curl \
--request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/invokeStream' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--header "X-Session-ID: string" \
--header "X-Agent-Engine-Test-Session: true" \
--data '{
"message": "string",
"resume_map": {},
"session_id": "string",
"user_id": "string"
}'# Headers
X-Session-ID: string
X-Agent-Engine-Test-Session: true
# Payload
{
"message": "string",
"resume_map": {},
"session_id": "string",
"user_id": "string"
}{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
"error": 406,
"errorCode": "UNACCEPTABLE_MEDIA_TYPE",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
"error": 406,
"errorCode": "UNSUPPORTED_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}: connected
data: {"message":"Example event payload"}
{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"blocking_execution_id": "string",
"blocking_status": "string",
"code": "string",
"error": "string",
"last_activity_at": "string"
}{
"blocking_execution_id": "string",
"blocking_status": "string",
"code": "string",
"error": "string",
"last_activity_at": "string"
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"code": "string",
"error": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"boot_id": "string",
"code": "string",
"component": "string",
"error": "string",
"execution_id": "string",
"sandbox": "string",
"source": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"boot_id": "string",
"code": "string",
"component": "string",
"error": "string",
"execution_id": "string",
"sandbox": "string",
"source": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"boot_id": "string",
"code": "string",
"component": "string",
"error": "string",
"execution_id": "string",
"sandbox": "string",
"source": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"code": "string",
"error": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"boot_id": "string",
"code": "string",
"component": "string",
"error": "string",
"execution_id": "string",
"sandbox": "string",
"source": "string",
"success": true
}# Headers
Retry-After: string
# Payload
{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}