As etapas de execução descrevem as ações que um agente realiza durante uma execução, incluindo chamadas de modelo e de ferramentas.
Listar etapas de execução
Retorna uma lista de todas as etapas de uma tarefa de execução.
Exemplo de solicitação
- HTTP
- SDK
Corpo da solicitação
Nome do parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
run_id | string | Sim | O ID da execução cujas etapas você deseja listar. | |
thread_id | string | Sim | O ID da Thread. | |
limit | integer | Não | None | Quantidade de etapas de execução a serem recuperadas. O padrão é None. Um valor None utiliza o valor padrão do lado do servidor. |
order | string | Não | None | Ordem de classificação dos resultados com base no campo created_at. Defina este parâmetro como asc (ascendente) ou desc (descendente). O valor padrão é None, o que indica o uso do método de classificação padrão do servidor. |
after | string | Não | None | ID da etapa de execução usada como cursor para paginação. Quando fornecido, retorna a página de resultados imediatamente posterior a esta etapa. |
before | string | Não | None | ID da etapa de execução usada como cursor para paginação. Quando fornecido, retorna a página de resultados imediatamente anterior a esta etapa. |
workspace | string | Sim | None | O Workspace ID do Alibaba Cloud Model Studio é obrigatório apenas se a |
api_key | string | Sim | None | A API Key do Model Studio. Recomendamos que você configure a API Key como uma variável de ambiente. |
Exemplo de resposta
Corpo da resposta
Uma lista de objetos de etapa de execução
Recuperar uma etapa de execução
Exemplo de solicitação
- HTTP
- SDK
Corpo da solicitação
Nome do parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
step_id | string | Sim | O ID da RunStep a ser recuperada. | |
thread_id | string | Sim | O ID da Thread. | |
run_id | string | Sim | O ID da execução. | |
workspace | string | Sim | None | O Workspace ID do Alibaba Cloud Model Studio é obrigatório apenas se você estiver usando uma API Key de sub-workspace. |
api_key | string | Sim | None | A API Key do Model Studio. Recomendamos que você configure a API Key como uma variável de ambiente. |
Exemplo de resposta
Corpo da resposta
O objeto de etapa de execução correspondente ao ID especificado.
Objeto de etapa de execução
Representa uma etapa no processo de execução de uma run.
Exemplo de objeto
Atributos do objeto
Nome do parâmetro | Tipo | Descrição |
|---|---|---|
id | string | Identificador exclusivo da etapa de execução, referenciável em endpoints da API. |
assistant_id | string | ID do assistente associado a esta etapa de execução. |
cancelled_at | integer | Timestamp UNIX de 13 dígitos (em milissegundos) indicando quando a etapa foi cancelada. |
completed_at | integer | Timestamp UNIX de 13 dígitos (em milissegundos) indicando a conclusão da etapa. |
created_at | integer | Timestamp UNIX de 13 dígitos (em milissegundos) referente à criação da etapa. |
expired_at | integer | Timestamp UNIX de 13 dígitos (em milissegundos) marcando a expiração da etapa. Se a execução pai expirar, a etapa também será considerada expirada. |
failed_at | integer | Timestamp UNIX de 13 dígitos (em milissegundos) registrando a falha da etapa. |
last_error | object | Último erro associado a esta etapa. Este parâmetro é nulo caso não tenham ocorrido erros. |
metadata | map | Conjunto de até 16 pares chave-valor anexáveis ao objeto, utilizado para armazenar informações adicionais em formato estruturado. O comprimento máximo da chave é de 64 caracteres e o do valor é de 512 caracteres. |
object | string | Tipo do objeto, sempre definido como thread.run.step. |
run_id | string | ID da execução à qual esta etapa pertence. |
status | string | Status atual da etapa. Valores válidos: in_progress, cancelled, failed, completed ou expired. |
step_details | object | Detalhes específicos da etapa de execução. |
thread_id | string | ID da thread em execução. |
type | string | Tipo da etapa de execução. Valores válidos: message_creation ou tool_calls. |
usage | object | Estatísticas de uso de recursos. |
status_code | integer | Código de status HTTP. Observação: Este parâmetro destina-se ao processamento interno. Na maioria dos casos, não é necessário preocupar-se com ele. |