agents

CRUD de workflows/agents, publicação, gerenciamento de versões e pontos de entrada para execução direta.

Caminho de origem: libraries/agent/src/controllers/agent.controller.ts

Arquivo do módulo: agent.module.ts

Introdução

O submódulo Agents é a principal superfície administrativa da biblioteca Agent. Ele gerencia os próprios registros de workflow, o ciclo de vida de rascunho/publicado, os snapshots de versão e os pontos de entrada para execução direta.

O mesmo controller trata tanto as alterações de configuração de longa duração quanto endpoints de ação como publish, run e create-version. Em outras palavras, "agent" aqui significa tanto a definição armazenada no banco de dados quanto a entidade de automação executável que pode, mais tarde, ser disparada por uma pessoa, um webhook ou outro evento de sistema.

Endpoints HTTP

15 endpoints

Lista agents/workflows.

Query: page, pageSize, search, status, type

Cria um agent/workflow.

Exclui agents em massa.

Body

Field	Type	Required	Notes
ids	number[]	yes	—

Obtém um agent.

Params: id (int)

Atualiza um agent.

Params: id (int)

Exclui um agent.

Params: id (int)

Publica o rascunho/versão atual.

Params: id (int)

Executa um agent imediatamente.

Params: id (int)

Cria uma execução por meio do endpoint de coleção de execuções.

Params: id (int)

Lista as execuções de um agent.

Params: id (int)

Lista as versões de um agent.

Params: id (int)

Cria uma nova versão.

Params: id (int)

Obtém uma versão.

Params: id (int), versionId (int)

Atualiza uma versão.

Params: id (int), versionId (int)

Publica uma versão específica.

Params: id (int), versionId (int)

Ferramentas MCP

Ferramentas nomeadas que podem ser chamadas por modelos de IA através do Model Context Protocol (MCP).

agent.workflow.list
Lista registros de workflow/agent
agent.workflow.get_graph
Lê o graph do rascunho mais recente de um agent
agent.workflow.set_graph
Substitui o graph da versão de rascunho mais recente
agent.workflow.node_catalog
Retorna o catálogo de nós de workflow disponíveis
agent.workflow.integration_profiles
Lista os perfis de integração utilizáveis pelos nós de workflow