---
title: "Criar um assistente da etapa"
method: POST
path: "/api/management/steps/{step}/assistants"
tags: ["step-assistants", "Assistentes"]
---

# Criar um assistente da etapa

`POST /api/management/steps/{step}/assistants`

Cria um assistente na etapa. Se `active` for verdadeiro, ele já entra em operação e passa a disparar no gatilho escolhido em `execute_on`: ao entrar na etapa (`moved`), ao sair dela (`unlinked`) ou somente sob demanda (`manual`).

É obrigatório indicar pelo menos um destino para o resultado: `result_as_media` grava como conteúdo do projeto e `result_as_dynamic_form` grava em um campo de formulário dinâmico. Os dois podem ser usados juntos.

A etapa do assistente é a do corpo (`funnel_step_id`) — é ela que vale, e não a da URL.

Cada execução consome créditos de IA. Veja [Assistentes de etapa](https://docs.olie.ai/guides/funnels/step-assistants) e [Créditos de IA](https://docs.olie.ai/guides/billing/ai-credits).

## Request body

- object
  - `active` number
  - `ai_agent_id` string
  - `execute_on` string
  - `failure_funnel_step_id` string
  - `funnel_step_id` number
  - `manual_execution_enabled` number
  - `name` string
  - `prompt` string
  - `result_as_dynamic_form` object
    - `edge_id` number
    - `form_id` number
    - `funnel_step_id` string
    - `id` string
    - `loose_form_id` string
    - `pivot_class` string
    - `project_funnel_id` string
    - `project_id` string
  - `result_as_media` number

## Response `201`

Criado

- object
  - `response` boolean
  - `assistant` object
    - `id` string
    - `name` string
    - `active` boolean
    - `funnel_step_id` integer
    - `ai_agent_id` string
    - `prompt` string
    - `execute_on` string
    - `manual_execution_enabled` boolean
    - `result_as_media` boolean
    - `result_as_dynamic_form` unknown
    - `failure_funnel_step_id` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` unknown

## Other responses

- `422` — Validação falhou

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/063de6e2e93c/schema)