Sign in
ai-agents
agents
contexts

Criar contexto do agente

Cria um contexto do agente. Sem order, ele entra no fim da lista. Para type: "text" envie o texto em content; para type: "file" envie a requisição como multipart/form-data com o arquivo no campo file (imagem ou PDF, até 10 MB) — nesse caso o content passa a apontar para o arquivo armazenado.

post/api/management/ai/agents/{agentId}/contexts

Request body

type'text' | 'file' required

Tipo do contexto.

contentstring nullable

Texto do contexto. Obrigatório quando nenhum arquivo é enviado.

filestring binary

Arquivo do contexto: imagem ou PDF de até 10 MB. Obrigatório quando type é file e só pode ser enviado em requisição multipart/form-data.

orderinteger

Posição do contexto na sequência. Omita o campo para acrescentar o contexto ao fim da lista.

is_activeboolean

Define se o contexto é aplicado ao prompt. Quando omitido, o contexto nasce ativo.

Response

Sucesso

type'text' | 'file'

Tipo do contexto.

contentstring nullable

Texto do contexto ou endereço do arquivo armazenado.

mime_typestring

Tipo do arquivo enviado; presente apenas em contextos do tipo file.

orderinteger

Posição do contexto na sequência aplicada ao prompt.

is_activeboolean

Indica se o contexto é aplicado ao prompt do agente.

ai_agent_idstring uuid

ID (UUID) do agente dono do contexto.

updated_atstring date-time

Data e hora da última alteração do contexto.

created_atstring date-time

Data e hora de criação do contexto.

idstring uuid

ID (UUID) do contexto.

Changes