Sign in
ai-agents
agents

Criar agente de IA

Cria um agente de IA. No modo manual (padrão) informe name, description, default_provider e default_model; tools aceita apenas os nomes devolvidos pelo endpoint de ferramentas disponíveis. Com auto_generate: true basta enviar description: o sistema redige nome, prompt base, ferramentas e os contextos iniciais do agente, e nesse modo a criação respeita o limite de agentes contratado, respondendo 402 quando ele já foi atingido.

post/api/management/ai/agents

Request body

namestring

Nome do agente. Obrigatório quando auto_generate é falso ou ausente.

descriptionstring required

Descrição curta do agente. No modo de geração automática é a partir dela que o agente inteiro é redigido.

default_provider'openrouter' | 'google' | 'openai' | 'anthropic'

Provedor de IA padrão do agente. Obrigatório quando auto_generate é falso ou ausente.

default_modelstring

Identificador do modelo padrão, conforme o id devolvido pelo catálogo de modelos disponíveis. Obrigatório quando auto_generate é falso ou ausente.

base_promptstring nullable

Prompt base que define o comportamento do agente.

toolsstring[] nullable

Ferramentas que o agente pode usar; nomes fora do catálogo são rejeitados.

auto_generateboolean

Quando verdadeiro, nome, prompt base, ferramentas e contextos iniciais são gerados a partir de description e os demais campos enviados são ignorados.

Response

Sucesso

responseboolean

Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.

Changes

Changed in 2 of the 98 revisions of this API.103031

  • d71b18b1685d103028See the full diff
    • ▲

      request property was restricted to a list of enum values

      request-property-became-enum

    • ▲

      request property / was restricted to a list of enum values

      request-property-became-enum

    • ▲

      the request property became required

      request-property-became-required

    • ▲

      the / request property type changed from no type to string

      request-property-type-changed

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ●

      the request property's maxLength was set to 255

      request-property-max-length-set

    • ●

      the request property's maxLength was set to 255

      request-property-max-length-set

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      added the new anthropic enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new clone-project-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new create-project-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit-project-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-form-answers-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-form-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-funnel-step-transitions-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-model-dynamic-forms-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-project-details-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-project-funnel-metrics-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-project-media-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-project-step-metrics-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-projects-in-step-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new get-user-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new google enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new index-project-funnels-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new index-projects-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new move-project-to-funnel-step-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new openai enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new openrouter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new quick-create-project-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new save-media-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new set-form-answers-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new today-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new undefined enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new web-search-tool enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      added the new anthropic enum value to the request property

      request-property-enum-value-added

    • ○

      added the new clone-project-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new create-project-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new edit-project-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-form-answers-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-form-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-funnel-step-transitions-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-model-dynamic-forms-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-project-details-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-project-funnel-metrics-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-project-media-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-project-step-metrics-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-projects-in-step-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new get-user-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new google enum value to the request property

      request-property-enum-value-added

    • ○

      added the new index-project-funnels-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new index-projects-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new move-project-to-funnel-step-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new openai enum value to the request property

      request-property-enum-value-added

    • ○

      added the new openrouter enum value to the request property

      request-property-enum-value-added

    • ○

      added the new quick-create-project-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new save-media-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new set-form-answers-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new today-tool enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new web-search-tool enum value to the request property /

      request-property-enum-value-added

  • 3202abfa17f93See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added