> ## 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.

# Executar um assistente manualmente

> Dispara um assistente sob demanda para um projeto, sem depender da movimentação de etapa.

Só vale para assistentes com gatilho `manual` ou com a execução manual habilitada; os demais respondem como não encontrado. O projeto precisa estar na etapa do assistente e ser visível para quem faz a chamada.

A execução é assíncrona: a resposta apenas confirma o enfileiramento, e o resultado aparece no projeto e no histórico de execuções alguns instantes depois. Um assistente inativo não executa nada e ainda assim responde com sucesso.



## OpenAPI

````yaml /api-reference/openapi.json post /api/management/step-assistants/{step_assistant}/execute-manually
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/step-assistants/{step_assistant}/execute-manually:
    parameters:
      - name: step_assistant
        in: path
        required: true
        description: ID (UUID) do assistente de etapa.
        schema:
          type: string
        example: ''
    post:
      tags:
        - step-assistants
        - Execução
      summary: Executar um assistente manualmente
      description: >-
        Dispara um assistente sob demanda para um projeto, sem depender da
        movimentação de etapa.


        Só vale para assistentes com gatilho `manual` ou com a execução manual
        habilitada; os demais respondem como não encontrado. O projeto precisa
        estar na etapa do assistente e ser visível para quem faz a chamada.


        A execução é assíncrona: a resposta apenas confirma o enfileiramento, e
        o resultado aparece no projeto e no histórico de execuções alguns
        instantes depois. Um assistente inativo não executa nada e ainda assim
        responde com sucesso.
      operationId: executarAssistenteDeEtapaManualmente
      requestBody:
        content:
          application/json:
            schema:
              description: Projeto alvo da execução manual.
              type: object
              properties:
                project_id:
                  type: string
                  description: >-
                    ID (UUID) do projeto sobre o qual o assistente será
                    executado. Obrigatório. O projeto precisa estar na etapa do
                    assistente.
                  format: uuid
              required:
                - project_id
            example:
              project_id: null
      responses:
        '200':
          description: Enfileirado
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                description: Confirmação de que a operação foi concluída.
                required:
                  - response
              example:
                response: true
        '404':
          description: Assistente não aceita execução manual
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre false em respostas de erro.
                  message:
                    type: string
                    description: >-
                      Identificador do erro, usado pelo cliente para tratar o
                      caso.
                  error:
                    type: string
                    description: Descrição legível do erro.
                required:
                  - response
                  - message
                  - error
              example:
                response: false
                message: step_assistant_model_not_found
                error: >-
                  No query results for model [App\Models\StepAssistant]
                  c4e2a7d1-58b6-4f09-a3c7-1e9d24b7f065
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````