Skip to main content
POST
/
v1
/
agents
Criar agente
curl --request POST \
  --url https://api.nuvia.ai/v1/agents \
  --header 'Authorization: Bearer <token>'
{
  "_id": {},
  "name": "<string>",
  "agent_flow": {
    "_id": {},
    "name": "<string>",
    "url": "<string>",
    "specialist_url": "<string>"
  },
  "prompts": {
    "service_prompt": "<string>",
    "name": "<string>",
    "role": "<string>",
    "mission": "<string>",
    "personality": [
      {}
    ],
    "communication_style": [
      {}
    ],
    "rules": [
      {}
    ]
  },
  "company": {
    "_id": {},
    "name": "<string>",
    "channels": [],
    "agent_flows": [
      {
        "_id": {},
        "name": "<string>",
        "url": "<string>",
        "specialist_url": "<string>"
      }
    ],
    "description": "<string>",
    "general_config": {}
  },
  "model_config": {},
  "general_config": {},
  "specialist_config": {},
  "knowledge_base": [
    {}
  ],
  "avatar_color": "<string>",
  "avatar_initials": "<string>",
  "personality_presets": [],
  "steps": [
    {
      "_id": {},
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "order": 123,
      "agent": "<unknown>",
      "company": {
        "_id": {},
        "name": "<string>",
        "channels": [],
        "agent_flows": [
          {
            "_id": {},
            "name": "<string>",
            "url": "<string>",
            "specialist_url": "<string>"
          }
        ],
        "description": "<string>",
        "general_config": {}
      },
      "mentions": [
        {}
      ],
      "general_config": {
        "disable_followups": true
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Token JWT de autenticação

Headers

x-company-id
string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Response

201 - application/json
_id
object
required
name
string
required
agent_flow
object
required
prompts
object
required
company
object
required
model_config
object
required
status
enum<string>
required
Available options:
ACTIVE,
DRAFT,
INACTIVE,
DELETED
general_config
object
specialist_config
object
knowledge_base
object[]
avatar_color
string
avatar_initials
string
personality_presets
enum<string>[]
Available options:
FRIENDLY,
DIDACTIC,
CURIOUS,
FORMAL,
PLAYFUL,
PERSUASIVE
steps
object[]