> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar execuções dos assistentes

> Histórico de execuções de todos os assistentes de uma etapa, do mais recente para o mais antigo.

Cada registro traz o assistente, o projeto, a execução do agente de IA (com o texto devolvido e o modelo usado) e o desfecho de cada destino separadamente: a gravação como conteúdo do projeto e a gravação em campo de formulário têm campos próprios de status e de erro, porque uma pode dar certo e a outra falhar.

Aceita filtros e paginação por query params, consulte:

- [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters)
- [Paginação](https://docs.olie.ai/api-reference/general/pagination)

Os campos de paginação (`current_page`, `per_page`, `total`, ...) vêm na raiz da resposta, ao lado de `data`, e não dentro de `meta` como no restante da API.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/steps/{step}/assistants/execution-logs
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/steps/{step}/assistants/execution-logs:
    parameters:
      - name: step
        in: path
        required: true
        description: ID da etapa do funil.
        schema:
          type: string
        example: ''
    get:
      tags:
        - step-assistants
        - Execução
      summary: Listar execuções dos assistentes
      description: >-
        Histórico de execuções de todos os assistentes de uma etapa, do mais
        recente para o mais antigo.


        Cada registro traz o assistente, o projeto, a execução do agente de IA
        (com o texto devolvido e o modelo usado) e o desfecho de cada destino
        separadamente: a gravação como conteúdo do projeto e a gravação em campo
        de formulário têm campos próprios de status e de erro, porque uma pode
        dar certo e a outra falhar.


        Aceita filtros e paginação por query params, consulte:


        - [Filtro
        básico](https://docs.olie.ai/api-reference/general/basic-filters)

        - [Paginação](https://docs.olie.ai/api-reference/general/pagination)


        Os campos de paginação (`current_page`, `per_page`, `total`, ...) vêm na
        raiz da resposta, ao lado de `data`, e não dentro de `meta` como no
        restante da API.
      operationId: obterRegistrosDeExecuODosAssistentes
      parameters:
        - name: page
          in: query
          description: Página desejada. Padrão `1`.
          schema:
            type: string
          example: ''
        - name: perPage
          in: query
          description: Itens por página. Padrão `30`, máximo `100`.
          schema:
            type: string
          example: ''
        - name: filter[status]
          in: query
          description: 'Situação da execução: `pending`, `success` ou `error`.'
          schema:
            type: string
          example: ''
        - name: filter[step_assistant_id]
          in: query
          description: ID (UUID) do assistente cujas execuções devem ser retornadas.
          schema:
            type: string
          example: ''
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: >-
                  Resposta paginada. Diferente do restante da API, os campos de
                  paginação vêm na raiz, e não dentro de `meta`.
                type: object
                properties:
                  current_page:
                    type: integer
                    description: Página retornada.
                  data:
                    type: array
                    description: >-
                      Execuções encontradas na página atual, da mais recente
                      para a mais antiga.
                    items:
                      description: Registro de uma execução de assistente.
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID (UUID) do registro de execução.
                          format: uuid
                        step_assistant_id:
                          type: string
                          description: ID (UUID) do assistente executado.
                          format: uuid
                        project_id:
                          type: string
                          description: >-
                            ID (UUID) do projeto sobre o qual o assistente
                            rodou.
                          format: uuid
                        agent_execution_id:
                          type: string
                          description: >-
                            ID (UUID) da execução do agente de IA
                            correspondente.
                          format: uuid
                        status:
                          type: string
                          enum:
                            - pending
                            - success
                            - error
                          description: >-
                            Situação da execução: `pending` em andamento,
                            `success` concluída e `error` falhou.
                        result:
                          type: string
                          description: Texto devolvido pelo agente de IA.
                        media_result_status:
                          type: boolean
                          description: >-
                            Resultado da gravação como conteúdo do projeto:
                            `true` gravou, `false` falhou, `null` não se aplica.
                        media_result_error:
                          type: string
                          description: Motivo da falha ao gravar como conteúdo do projeto.
                        dynamic_form_result_status:
                          type: boolean
                          description: >-
                            Resultado da gravação no campo de formulário: `true`
                            gravou, `false` falhou, `null` não se aplica.
                        dynamic_form_result_error:
                          type: string
                          description: Motivo da falha ao gravar no campo de formulário.
                        execution_time:
                          type: string
                          description: Momento em que a execução foi encerrada.
                          format: date-time
                        created_at:
                          type: string
                          description: Momento em que a execução foi enfileirada.
                          format: date-time
                        updated_at:
                          type: string
                          description: Data da última alteração do registro.
                          format: date-time
                        step_assistant:
                          type: object
                          description: Assistente que gerou o registro.
                          properties:
                            id:
                              type: string
                              description: ID (UUID) do assistente.
                              format: uuid
                            name:
                              type: string
                              description: Nome do assistente.
                            ai_agent_id:
                              type: string
                              description: ID (UUID) do agente de IA usado.
                              format: uuid
                        project:
                          type: object
                          description: Projeto sobre o qual o assistente rodou.
                          properties:
                            id:
                              type: string
                              description: ID (UUID) do projeto.
                              format: uuid
                            name:
                              type: string
                              description: Nome do projeto.
                            code:
                              type: string
                              description: Código do projeto.
                        agent_execution:
                          type: object
                          description: Execução do agente de IA correspondente.
                          properties:
                            id:
                              type: string
                              description: ID (UUID) da execução.
                              format: uuid
                            status:
                              type: string
                              enum:
                                - pending
                                - completed
                                - failed
                              description: >-
                                Situação da chamada ao modelo: `pending`,
                                `completed` ou `failed`.
                            response:
                              type: string
                              description: Texto devolvido pelo modelo.
                            model:
                              type: string
                              description: Modelo de IA usado na execução.
                  first_page_url:
                    type: string
                    description: Endereço da primeira página.
                  from:
                    type: integer
                    description: Posição do primeiro item da página no total.
                  last_page:
                    type: integer
                    description: Número da última página.
                  last_page_url:
                    type: string
                    description: Endereço da última página.
                  links:
                    type: array
                    description: Links de navegação prontos para uma barra de paginação.
                    items:
                      description: Link de navegação.
                      type: object
                      properties:
                        url:
                          type: string
                          description: >-
                            Endereço da página, ou `null` quando não há para
                            onde ir.
                        label:
                          type: string
                          description: Rótulo do link, já traduzido.
                        page:
                          type: integer
                          description: Número da página do link.
                        active:
                          type: boolean
                          description: Indica se o link aponta para a página atual.
                  next_page_url:
                    type: string
                    description: Endereço da próxima página, ou `null` na última.
                  path:
                    type: string
                    description: Endereço base usado para montar os links.
                  per_page:
                    type: integer
                    description: Itens por página.
                  prev_page_url:
                    type: string
                    description: Endereço da página anterior, ou `null` na primeira.
                  to:
                    type: integer
                    description: Posição do último item da página no total.
                  total:
                    type: integer
                    description: Total de itens encontrados.
                required:
                  - current_page
                  - data
                  - per_page
                  - total
              example:
                current_page: 1
                data:
                  - id: e1a90c37-2d64-4f8b-93a5-0b7c46d182ef
                    step_assistant_id: 9f1c4b02-6f3a-4b8e-9d21-7c5e0a41b8d3
                    project_id: 5d8b3e21-4c07-49f6-a1d3-96b8e70c2f54
                    agent_execution_id: b62f80d4-13c9-4e57-a08d-3f5216c9e7ab
                    status: success
                    result: >-
                      O cliente pediu revisão do orçamento e aguarda retorno
                      sobre o prazo de entrega.
                    media_result_status: true
                    media_result_error: null
                    dynamic_form_result_status: null
                    dynamic_form_result_error: null
                    execution_time: '2026-08-18T16:44:09.000000Z'
                    created_at: '2026-08-18T16:44:02.000000Z'
                    updated_at: '2026-08-18T16:44:09.000000Z'
                    step_assistant:
                      id: 9f1c4b02-6f3a-4b8e-9d21-7c5e0a41b8d3
                      name: Resumo do atendimento
                      ai_agent_id: 2b7d94f6-0c31-4a85-b6e2-58f1c0d93a47
                    project:
                      id: 5d8b3e21-4c07-49f6-a1d3-96b8e70c2f54
                      name: Reforma da fachada
                      code: OBR-114
                    agent_execution:
                      id: b62f80d4-13c9-4e57-a08d-3f5216c9e7ab
                      status: completed
                      response: >-
                        O cliente pediu revisão do orçamento e aguarda retorno
                        sobre o prazo de entrega.
                      model: claude-sonnet-5
                  - id: 4c72b8f0-9a15-4e63-b0d8-72e5931ac48f
                    step_assistant_id: c4e2a7d1-58b6-4f09-a3c7-1e9d24b7f065
                    project_id: 5d8b3e21-4c07-49f6-a1d3-96b8e70c2f54
                    agent_execution_id: 0a54e9b3-7c28-4d16-95f7-e83b104c6d29
                    status: error
                    result: null
                    media_result_status: null
                    media_result_error: null
                    dynamic_form_result_status: false
                    dynamic_form_result_error: No query results for model [App\Models\FormEdge] 2231
                    execution_time: '2026-08-18T15:02:31.000000Z'
                    created_at: '2026-08-18T15:02:27.000000Z'
                    updated_at: '2026-08-18T15:02:31.000000Z'
                    step_assistant:
                      id: c4e2a7d1-58b6-4f09-a3c7-1e9d24b7f065
                      name: Classificar urgência
                      ai_agent_id: 7a3f16c8-9e42-4d70-8b15-c2064ef3d891
                    project:
                      id: 5d8b3e21-4c07-49f6-a1d3-96b8e70c2f54
                      name: Reforma da fachada
                      code: OBR-114
                    agent_execution:
                      id: 0a54e9b3-7c28-4d16-95f7-e83b104c6d29
                      status: failed
                      response: null
                      model: claude-sonnet-5
                first_page_url: >-
                  https://api.olie.ai/api/management/steps/312/assistants/execution-logs?page=1
                from: 1
                last_page: 1
                last_page_url: >-
                  https://api.olie.ai/api/management/steps/312/assistants/execution-logs?page=1
                links:
                  - url: null
                    label: '&laquo; Anterior'
                    page: null
                    active: false
                  - url: >-
                      https://api.olie.ai/api/management/steps/312/assistants/execution-logs?page=1
                    label: '1'
                    page: 1
                    active: true
                  - url: null
                    label: Próximo &raquo;
                    page: null
                    active: false
                next_page_url: null
                path: >-
                  https://api.olie.ai/api/management/steps/312/assistants/execution-logs
                per_page: 30
                prev_page_url: null
                to: 2
                total: 2
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````