Skip to main content
POST
https://sac-waffle-v2.theo-110.workers.dev
/
openai
/
agents
curl -X POST https://sac-waffle-v2.theo-110.workers.dev/openai/agents \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "content-writer",
    "description": "Escritor de conteúdo para newsletters",
    "systemPrompt": "Você é um escritor especializado em newsletters digitais. Crie conteúdo envolvente, conciso e informativo. Use títulos chamativos, parágrafos curtos e linguagem acessível. Sempre em português brasileiro.",
    "model": "gpt-4o-mini",
    "temperature": 0.8,
    "maxTokens": 2000
  }'

{
  "success": true,
  "message": "Agente 'content-writer' registrado com sucesso",
  "data": {
    "name": "content-writer",
    "description": "Escritor de conteúdo para newsletters",
    "model": "gpt-4o-mini"
  }
}

​
Descrição

Registra um novo agente com system prompt, modelo e tools customizados para casos de uso específicos.

​
Headers

​
Authorization
string
required
Bearer token JWT para autenticação
​
Content-Type
string
required
application/json

​
Body Parameters

​
name
string
required
Nome único do agenteRegras:
  • Sem espaços (use hífens ou underscores)
  • Letras, números e hífens
  • Máximo 50 caracteres
  • Exemplo: content-writer, sales_assistant
​
systemPrompt
string
required
Instruções do sistema para o agenteDicas para um bom system prompt:
  • Defina claramente o papel do agente
  • Especifique tom e estilo de comunicação
  • Inclua conhecimento do domínio
  • Estabeleça limites e diretrizes
​
description
string
Descrição do propósito do agente
​
model
string
default:"gpt-4o-mini"
Modelo GPT a usarOpções:
  • gpt-4o-mini - Rápido e econômico
  • gpt-4o - Mais avançado
  • gpt-4-turbo - Versão anterior
  • gpt-3.5-turbo - Legacy
​
temperature
number
default:"0.7"
Temperatura para respostas (0.0 a 2.0)Valores recomendados:
  • 0.0-0.3 - Tarefas factuais
  • 0.4-0.7 - Uso geral
  • 0.8-1.5 - Conteúdo criativo
​
maxTokens
number
default:"4096"
Limite máximo de tokens
​
tools
array
Lista de tools disponíveis para o agenteExemplo:
["get_current_date", "format_json"]

​
Response

​
success
boolean
required
Status da operação
​
message
string
required
Mensagem de confirmação
​
data
object
curl -X POST https://sac-waffle-v2.theo-110.workers.dev/openai/agents \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "content-writer",
    "description": "Escritor de conteúdo para newsletters",
    "systemPrompt": "Você é um escritor especializado em newsletters digitais. Crie conteúdo envolvente, conciso e informativo. Use títulos chamativos, parágrafos curtos e linguagem acessível. Sempre em português brasileiro.",
    "model": "gpt-4o-mini",
    "temperature": 0.8,
    "maxTokens": 2000
  }'

{
  "success": true,
  "message": "Agente 'content-writer' registrado com sucesso",
  "data": {
    "name": "content-writer",
    "description": "Escritor de conteúdo para newsletters",
    "model": "gpt-4o-mini"
  }
}

​
Exemplo de System Prompt Eficaz

Você é um assistente de vendas da empresa XYZ.

Conhecimento:
- Produtos: Software de gestão empresarial
- Público: PMEs brasileiras
- Diferenciais: Integração fiscal, suporte 24/7

Diretrizes:
- Seja consultivo, não pushy
- Entenda a necessidade antes de propor
- Use casos de sucesso quando relevante
- Sempre colete contato para follow-up

Tom:
- Profissional mas acessível
- Evite jargões técnicos excessivos
- Use exemplos práticos