Invoca um agente de espaço de trabalho e transmite sua resposta como eventos enviados pelo servidor. Para continuar uma sessão, envie o valor X-Session-ID retornado pela resposta anterior. Se você omitir o cabeçalho, o gateway iniciará uma nova sessão e retornará seu ID no cabeçalho de resposta. O campo session_id do corpo não continua uma sessão. O corpo pode incluir campos extras de nível superior. O gateway encaminha todos os campo , exceto estes campos reservados: message, session_id, user_id e resume_map. resume_map continua uma curva suspensa. Para uma sessão sem histórico, resume_map se torna a entrada inicial do agente . Exige um token de Portador válido.
Cabeçalhos
-
ID da sessão retornada por uma resposta anterior. Envie para continuar a sessão. As IDs válidas correspondem a [A-Za-z0-9_-]{1,128}$. Se omitido, o gateway inicia uma nova sessão. O corpo da sessão_id não continua uma sessão
-
Classificar uma sessão recém-criada como uma sessão de teste; a classificação existente não é alterada
corpo, corpo
Obrigatório
Solicitação de invocar
-
Opcional quando outros campos do agente são fornecidos: entrada de chat para agentes de chat. Nome do campo reservado.
-
ResumeMap contém respostas por interrupção resolvidas por OE. A OE a encaminha para o agente como entrada comum somente quando inicia a primeira execução de uma sessão, onde não existe nenhuma vez suspensa local para responder.
Propriedades adicionais são permitidas.
-
campo de compatibilidade opcional. O gateway o ignora para a continuação da sessão. Para continuar uma sessão, envie X-Session-ID . Nome do campo reservado.
-
Identidade opcional usada para personalização e isolamento de memória. As chamadas de chave de API e humanos usam esse valor ou padrão para o usuário autenticado. As chamadas de conta de serviço sempre usam a identidade da conta de serviço. As contas de serviço ainda não podem agir como outro usuário. Nome do campo reservado.
Respostas
-
Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.
-
fluxo SSE. Uma falha pré-cabeçalho (antes do primeiro quadro) é renderizada como um dos corpos de erro JSON abaixo; uma falha no meio do fluxo, em vez disso, é renderizada como um bloco SSE de terminal contendo o mesmo código/erro, além de fonte/componente/sandbox/boot_id em um objeto de metadados para um envelope de falha de inicialização
-
Solicitação inválida
-
Não autorizado
-
Conflito
-
PROJECT_SECRET_INVALID: o espaço de trabalho não pode ser iniciado porque um segredo de projeto é inválido ou inacessível (corrija o segredo e redistribua); No meio do fluxo, ele aparece como um bloco SSE terminal contendo o código=PROJECT_SECRET_INVALID
-
Muitas solicitações
-
ErrorResponse ou StartupFailureResponse para uma falha de inicializaçãoAGENT_STARTUP_FAILED/STARTUP_FAILED
-
StartupFailureResponse para uma falha de inicialização POOL_EXHAUSTED/EXECUTOR_BOOT_FAILED/PLATFORM_DEPENDENCY_FAILED/POOL_UNREACHABLE; ErrorResponse de outra forma. POOL_EXHAUSTED carrega um cabeçalho Retry-After
-
Tempo limite do gateway
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
}