ReplyAgentSession - DataWorks - Centro de documentación de Alibaba Cloud

Responde a una interacción de usuario pendiente en una sesión de DataAgent.

Descripción de la operación

Responde a una permission_request emitida por el daemon de DataAgent. Admite el envío de respuestas a ask_user_question o la cancelación de la interacción actual. El PermissionRequestId debe obtenerse de params.data.requestId en el evento _qwen/notify (params.kind=permission_request) del SSE de PromptAgentSession original. La respuesta solo devuelve si se acepta o no. Los eventos de ejecución posteriores se siguen devolviendo a través del SSE de PromptAgentSession original. No envíe repetidamente la misma ronda de prompt.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dataworks:ReplyAgentSession

none

*All Resource

*

Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Jsonrpc	string	No	La versión del protocolo JSON-RPC. Fija en 2.0. Valores válidos: 2.0 : JSON-RPC 2.0	2.0
Id	string	Sí	El ID de correlación de JSON-RPC para la solicitud de respuesta actual. Se devuelve tal cual en la respuesta y es diferente de PermissionRequestId.	reply-rpc-001
Params	object	Sí	Los parámetros de respuesta de la interacción del usuario.
Answers	object	No	Las respuestas a ask_user_question. La clave es una cadena de índice basada en 0 de la pregunta, y el valor es el texto de la respuesta. Complete cada pregunta una por una para varias preguntas. Omita este parámetro para la autorización o cancelación general de herramientas.	{"0":"lakehouse_uat"}
	string	No	La lista de respuestas.	{"0":"key","1":"value"}
Outcome	object	Sí	El resultado del procesamiento del usuario para la interacción actual.
OptionId	string	No	Obligatorio y no puede estar vacío cuando Outcome es selected. Toma el optionId de la opción real en las opciones del evento actual (al enviar una respuesta, por lo general se selecciona la opción con kind=allow_once). Omita este parámetro cuando Outcome es cancelled.	option-from-event
Outcome	string	Sí	El tipo de procesamiento. selected indica que se selecciona una opción, y cancelled indica que el usuario cancela explícitamente la interacción. Valores válidos: cancelled : Cancelado. selected : Seleccionado.	selected
PermissionRequestId	string	Sí	El identificador de la permission_request actual. Se obtiene de _qwen/notify.params.data.requestId del SSE original, y no es ToolCallId, HTTP RequestId ni el Id de JSON-RPC actual. No puede ser . ni ..	permission-001
SessionId	string	Sí	El ID de sesión LSP. Utilice el SessionId devuelto al crear la sesión, no el ID de sesión interno del daemon.	lsp-session-001

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
JsonRpcResponse	object	La respuesta de JSON-RPC. Devuelve Result en caso de éxito y Error en caso de errores de protocolo.
Error	object	El mensaje de falla de JSON-RPC. Por ejemplo, se devuelve DAEMON_PERMISSION_UNAVAILABLE cuando la función de respuesta del daemon no está habilitada.
Code	integer	El código de error de JSON-RPC.	-32601
Data	any	La información de error adicional opcional. El contenido depende del tipo de error.	{}
ErrorCode	string	El código de error de negocio.	DAEMON_PERMISSION_UNAVAILABLE
Message	string	El mensaje de error.	DataAgent daemon permission reply is not enabled
Id	string	El ID de correlación de JSON-RPC para la solicitud de respuesta actual.	reply-rpc-001
Jsonrpc	string	La versión del protocolo JSON-RPC.	2.0
Result	object	El resultado del procesamiento de la respuesta. Solo indica si se acepta la respuesta actual, y no indica que la ejecución de la tarea original haya finalizado.
Accepted	boolean	Indica si el daemon acepta la respuesta actual. El valor true indica que se acepta la respuesta. El valor false indica que no se acepta la respuesta, lo cual puede deberse a que la solicitud es desconocida, ya fue procesada, expiró o la sesión no existe. No se puede distinguir la causa específica basándose en este valor.	true
Timestamp	integer	La hora de la respuesta. Es una marca de tiempo UNIX en milisegundos.	1789549200000
RequestId	string	El ID de solicitud para la llamada actual, que se puede utilizar para la solución de problemas.	request-001

Ejemplos

Respuesta exitosa

JSON Formato

{
  "JsonRpcResponse": {
    "Error": {
      "Code": -32601,
      "Data": "{}",
      "ErrorCode": "DAEMON_PERMISSION_UNAVAILABLE",
      "Message": "DataAgent daemon permission reply is not enabled"
    },
    "Id": "reply-rpc-001",
    "Jsonrpc": "2.0",
    "Result": {
      "Accepted": true
    },
    "Timestamp": 1789549200000
  },
  "RequestId": "request-001"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.