Ejemplos por lenguaje

Bash, cURL y jq. Variables AGOS_* configuradas en el entorno.

set -euo pipefail
: "${AGOS_BASE_URL:?Define AGOS_BASE_URL}"
: "${AGOS_EMAIL:?Define AGOS_EMAIL}"
: "${AGOS_PASSWORD:?Define AGOS_PASSWORD}"
: "${AGOS_AGENT_KEY:?Define AGOS_AGENT_KEY}"
case "$AGOS_BASE_URL" in https://*) ;; *) exit 1 ;; esac

TOKEN=$(jq -n '{email: env.AGOS_EMAIL,
  password: env.AGOS_PASSWORD, useCookie: false}' |
  curl --silent --show-error --fail-with-body --max-time 30 \
    "${AGOS_BASE_URL%/}/api/auth/login" \
    -H 'Content-Type: application/json' --data-binary @- |
  jq -er '.token | select(type == "string" and length > 0)')

jq -n '{message: "¿Cómo registro una devolución?",
  agentKey: env.AGOS_AGENT_KEY, history: []}' |
  curl --silent --show-error --fail-with-body --max-time 120 \
    "${AGOS_BASE_URL%/}/api/chat" \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' --data-binary @- |
  jq '{text, personality, messageId, sources}'

unset TOKEN

Node.js 22 o superior. Guarda el ejemplo como un módulo .mjs y ejecútalo con node.

const required = name => {
  const value = process.env[name];
  if (!value) throw new Error('Falta la variable ' + name);
  return value;
};

const base = new URL(required('AGOS_BASE_URL'));
if (base.protocol !== 'https:') throw new Error('Usa HTTPS');

async function post(path, body, token, timeout = 30000) {
  const response = await fetch(new URL(path, base), {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      ...(token ? { Authorization: 'Bearer ' + token } : {})
    },
    body: JSON.stringify(body),
    signal: AbortSignal.timeout(timeout)
  });
  if (!response.ok) {
    throw new Error('AGOS respondió HTTP ' + response.status);
  }
  return response.json();
}

const login = await post('/api/auth/login', {
  email: required('AGOS_EMAIL'),
  password: required('AGOS_PASSWORD'),
  useCookie: false
});
if (!login.token) throw new Error('El login no devolvió un token');

const reply = await post('/api/chat', {
  message: '¿Cómo registro una devolución?',
  agentKey: required('AGOS_AGENT_KEY'),
  history: []
}, login.token, 120000);

console.log(reply.text);

Python 3.10 o superior. Instala requests con python -m pip install requests.

import os
from urllib.parse import urlsplit
import requests

def required(name):
    value = os.environ.get(name)
    if not value:
        raise ValueError(f"Falta la variable {name}")
    return value

base = required("AGOS_BASE_URL").rstrip("/")
if urlsplit(base).scheme != "https":
    raise ValueError("Usa HTTPS")

with requests.Session() as client:
    login = client.post(
        f"{base}/api/auth/login",
        json={
            "email": required("AGOS_EMAIL"),
            "password": required("AGOS_PASSWORD"),
            "useCookie": False,
        },
        timeout=(10, 30),
    )
    login.raise_for_status()
    token = login.json().get("token")
    if not token:
        raise RuntimeError("El login no devolvió un token")

    reply = client.post(
        f"{base}/api/chat",
        headers={"Authorization": f"Bearer {token}"},
        json={
            "message": "¿Cómo registro una devolución?",
            "agentKey": required("AGOS_AGENT_KEY"),
            "history": [],
        },
        timeout=(10, 120),
    )
    reply.raise_for_status()
    print(reply.json()["text"])

.NET 8 o superior. Usa una aplicación de consola: dotnet new console; reemplaza Program.cs y ejecuta dotnet run.

using System.Net.Http.Headers;
using System.Net.Http.Json;

static string Required(string name) =>
    Environment.GetEnvironmentVariable(name)
    ?? throw new InvalidOperationException($"Falta la variable {name}");

var baseUri = new Uri(Required("AGOS_BASE_URL"));
if (baseUri.Scheme != "https")
    throw new InvalidOperationException("Usa HTTPS");

using var http = new HttpClient
{
    BaseAddress = baseUri,
    Timeout = TimeSpan.FromSeconds(120)
};

using var loginResponse = await http.PostAsJsonAsync("/api/auth/login", new
{
    email = Required("AGOS_EMAIL"),
    password = Required("AGOS_PASSWORD"),
    useCookie = false
});
loginResponse.EnsureSuccessStatusCode();
var login = await loginResponse.Content.ReadFromJsonAsync<LoginResponse>();
if (string.IsNullOrWhiteSpace(login?.Token))
    throw new InvalidOperationException("El login no devolvió un token");

http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", login.Token);

using var response = await http.PostAsJsonAsync("/api/chat", new
{
    message = "¿Cómo registro una devolución?",
    agentKey = Required("AGOS_AGENT_KEY"),
    history = Array.Empty<object>()
});
response.EnsureSuccessStatusCode();
var reply = await response.Content.ReadFromJsonAsync<ChatResponse>();
Console.WriteLine(reply?.Text);

record LoginResponse(string Token, string Plan);
record ChatResponse(string Text, string Personality, long MessageId);