Pular para o conteúdo principal

Conectar um cliente

Seu endpoint é a URL do middleware mais /v1 (a página de configurações mostra), e a chave é uma que você cria lá. Qualquer coisa que fale a API de chat da OpenAI pode usá-lo.

rubry.ai​

  1. No rubry.ai/chat, abra o menu de agentes e escolha + Conectar seu agente…
  2. Dê um nome, cole o endpoint e a chave, e toque em Conectar.

Conectando um agente no rubry.ai

O rubry.ai confere o endpoint primeiro (GET /v1/models com a sua chave). Se a lista tiver auto, o rubry.ai usa esse; senão, fala com o primeiro modelo listado. Seu agente entra no menu e fica selecionado:

Seu agente no rubry.ai

  • Limites: mensagens para o seu agente não contam na cota diária nem no orçamento do Rubry; só vale uma verificação contra abuso. Veja Limites.
  • Só você vê: ele vive no seu navegador, não numa conta; o menu de mais ninguém o mostra.
  • Histórico: o rubry.ai guarda suas conversas com ele na barra lateral, como as dos seus próprios agentes, e envia as últimas mensagens junto com cada nova.
  • Até 3 agentes podem estar conectados ao mesmo tempo. Remova um no mesmo diálogo.
  • Onde fica a chave? Num cookie criptografado e HttpOnly no seu navegador. Veja Segurança.

Open WebUI​

Settings → Connections → OpenAI API: URL = seu endpoint, chave = sua chave de API. Seus agentes (e o auto) aparecem como modelos.

SDK da OpenAI​

import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://agents.example.com/v1', apiKey: 'rk_…' });

const stream = await client.chat.completions.create({
	model: 'auto',
	stream: true,
	messages: [{ role: 'user', content: 'Planeje uma semana de 3 posts no LinkedIn para uma padaria' }],
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? '');

curl​

curl -N https://agents.example.com/v1/chat/completions \
  -H "Authorization: Bearer rk_…" -H "Content-Type: application/json" \
  -d '{"model":"auto","stream":true,"messages":[{"role":"user","content":"Oi!"}]}'

Adicione -H "X-Session-Id: <qualquer id>" e envie só a mensagem nova a cada vez para os agentes guardarem a conversa na memória.