📚 Documentação da API - Build Agents

A API da Build Agents permite interagir com agentes de Inteligência Artificial personalizados de forma simples e escalável.

Nesta documentação você encontrará:

📌 Principais endpoints e suas validações
💻 Exemplos de uso em diferentes linguagens (cURL, PHP, Python, JavaScript)
📦 Detalhes sobre parâmetros e formatos de resposta

Essa API foi projetada para facilitar integrações, desde testes rápidos até implementações em produção, oferecendo controle sobre autenticação, sessões e uso de tokens.

🔐 Criar Token de Acesso

Retorna um token de acesso para autenticação nas demais rotas.

POST

Requisição

{
"email": "[email protected]",
"password": "senha123"
}

Resposta Esperada

{
"token": "seu-token-de-acesso"
}

Área de Teste

🤖 Interação com Agente

Envia um prompt (mensagem) para o agente especificado, com possibilidade de anexar arquivos.
Retorna a resposta do modelo e o uso de tokens.

POST

Headers

Authorization: Bearer {token}
Accept: application/json

Requisição

{
    "session_id": "sessao123",
    "prompt": "Explique a fotossíntese",
    "files": [ arquivo1, arquivo2 ]
}

Resposta Esperada

{
    "session_id": "sessao123",
    "content": "A fotossíntese é o processo...",
    "token_usage": {
        "prompt_token_count": 35,
        "candidates_token_count": 58,
        "total_token_count": 93
    }
}

Área de Teste

Observações:
* As respostas dos agentes podem incluir estrutura JSON conforme configuração.
* As chamadas com arquivos suportam múltiplos anexos.
* Utilize session_id para manter o contexto em conversas.

💻 Exemplos de Requisição

cURL

curl -X POST \
  https://buildagents.com.br/api/v1/agent/SEU_AGENT_ID/generate \
  -H "Authorization: Bearer SEU_TOKEN" \
  -F "prompt=Olá" \
  -F "files[]=@caminho/para/arquivo.jpg"

PHP (Laravel HTTP)

$response = Http::withToken('SEU_TOKEN')
    ->attach('files[]', fopen($path, 'r'), 'arquivo.jpg')
    ->post("https://buildagents.com.br/api/v1/agent/SEU_AGENT_ID/generate", [
        'prompt' => 'Olá',
        'session_id' => 'sessao123',
    ]);

$data = $response->json();

JavaScript (fetch)

const formData = new FormData();
formData.append("prompt", "Olá");
formData.append("files[]", fileInput.files[0]);

fetch("https://buildagents.com.br/api/v1/agent/SEU_AGENT_ID/generate", {
  method: "POST",
  headers: { "Authorization": `Bearer SEU_TOKEN` },
  body: formData
})
.then(res => res.json())
.then(data => console.log(data));

Python (requests)

import requests

url = "https://buildagents.com.br/api/v1/agent/SEU_AGENT_ID/generate"
headers = {"Authorization": "Bearer SEU_TOKEN"}
files = {"files[]": open("arquivo.jpg", "rb")}
data = {"prompt": "Olá"}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
Apresentação Documentação Ferramentas