Pular para o conteúdo

POST /v1/agents/{id}/intents/proposal

POST
/v1/agents/{id}/intents/proposal
curl --request POST \
--url https://seu-endereco-da-api/v1/agents/example/intents/proposal \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "description": "example" }'

Permissão que a Chave de acesso precisa: Gerenciar agentes de IA (agents:manage).

id
required
string
Media typeapplication/json
object
description
required

What the owner wants the agent to do, in plain words

string
>= 1 characters <= 2000 characters

Example generated

{
"description": "example"
}
Media typeapplication/json
object
intents
required

Proposed intents in the same shape the agent PATCH accepts; nothing is saved until the owner accepts them

Array<object>
object
name
required
string
>= 1 characters
description
required
string
samples
required
Array<string>
enabled
required
boolean
collect
required
Array<object>
object
key
required
string
>= 1 characters
label
required
string
question
required
string
type
required
string
Allowed values: text number email phone cpf date choice
required
required
boolean
options
Array<string>
validationHint
string
saveToContact
boolean
action
required
object
type
required
string
Allowed values: reply request transfer media charge resend_charge renegotiate acoes
replyText
string
replyVerbatim
boolean
request
object
method
required
string
Allowed values: GET POST PUT PATCH DELETE
url
required
string
headers
Array<object>
object
key
required
string
value
required
string
body
string
connectionId
string format: uuid
transferKind
string
Allowed values: department agent human ai
transferTargetId
string
transferLabel
string
transferFallbackDepartmentId
string format: uuid
media
Array<object>
object
name
required
string
kind
required
string
Allowed values: image video document audio
mediaKey
string
charge
object
key
additional properties
any
actions
Array<object>
object

Example

{
"intents": [
{
"collect": [
{
"type": "text"
}
],
"action": {
"type": "reply",
"request": {
"method": "GET"
},
"transferKind": "department",
"media": [
{
"kind": "image"
}
]
}
}
]
}

The agent already has the maximum number of intents

No AI credit left