Saltar al contenido principal

Inicio rápido

Tenga su primer agente de IA funcionando en 5 minutos.

Requisitos previos​

  • Una clave API de cualquier proveedor de LLM compatible (OpenAI, Anthropic, Google, xAI o un modelo local).
  • macOS, Linux o Windows (WSL).

Instalación​

Script (recomendado):

curl -fsSL https://get.droid.plus | sh

Docker:

docker pull sinapticai/droid:latest

Descarga del binario:

Descargue el binario para su plataforma desde GitHub Releases.

PlataformaArquitecturaDescargar
Linuxamd64droid-linux-amd64
Linuxarm64droid-linux-arm64
macOSApple Silicondroid-darwin-arm64
macOSInteldroid-darwin-amd64
Windowsamd64droid-windows-amd64.exe

Cree su primer agente​

Opción A: Constructor de IA (sin código)​

Inicie Sinaptic® DROID+ y abra el constructor visual:

droid up
# Abra http://localhost:8081/builder/ en su navegador

El constructor visual de IA le permite configurar su agente gráficamente: elija un modelo, escriba un prompt del sistema, añada herramientas y pruébelo en vivo. Cuando haya terminado, generará la configuración YAML por usted.

Opción B: Configuración YAML​

Inicialice un nuevo proyecto:

droid init my-agent
cd my-agent

Esto crea un directorio de proyecto con:

my-agent/
├── droid.yaml          # Configuración de ejecución (puertos, claves de LLM, seguridad)
├── configs/agents/
│   └── my-agent.yaml   # Definición de su agente
├── .env.example        # Plantilla de clave API
└── data/               # Datos de ejecución (RAG, logs)

Edite .env.example → .env con su clave API:

cp .env.example .env
# Edite .env y añada su OPENAI_API_KEY (o cualquier otra clave de proveedor)

Inicie el motor de ejecución:

droid up

Verá lo siguiente:

 ____  ____   ___  ___ ____
|  _ \|  _ \ / _ \|_ _|  _ \  _
| | | | |_) | | | || || | | |(_)_
| |_| |  _ <| |_| || || |_| |  _|
|____/|_| \_\\___/|___|____/  (_)

Sinaptic.AI DROID+ v0.5.0
Agent runtime engine starting...
✓ Loaded 1 agent: my-agent
✓ SinapticAI security: enabled (community mode)
✓ OpenAI-compatible API: http://localhost:8080/v1
✓ Management API: http://localhost:8081
✓ Agent Builder UI: http://localhost:8081/builder/

Hable con su agente​

Sinaptic® DROID+ expone una API compatible con OpenAI, por lo que puede utilizar cualquier SDK de OpenAI o simplemente curl:

curl:

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "my-agent",
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

Python (SDK de OpenAI):

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8080/v1", api_key="any")

response = client.chat.completions.create(
    model="my-agent",
    messages=[{"role": "user", "content": "¡Hola!"}]
)

print(response.choices[0].message.content)

Node.js (SDK de OpenAI):

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://localhost:8080/v1',
  apiKey: 'any',
});

const response = await client.chat.completions.create({
  model: 'my-agent',
  messages: [{ role: 'user', content: '¡Hola!' }],
});

console.log(response.choices[0].message.content);

El campo model se asigna al nombre del agente en su configuración YAML. La api_key puede ser cualquier cadena para el desarrollo local (a menos que haya configurado la autenticación en droid.yaml).

Explicación de la configuración del agente​

Aquí hay una configuración de agente mínima (configs/agents/my-agent.yaml):

name: "my-agent"
description: "Asistente de atención al cliente"

model:
  name: "gpt-4o-mini"       # Cualquier modelo de su proveedor configurado
  max_tokens: 1024
  temperature: 0.7

personality: |
  Eres un asistente de atención al cliente servicial.
  Sé conciso y preciso. Siempre sé educado.

tools:
  - name: "current_time"
    type: "builtin"

sinaptic:
  enabled: true              # Activar comprobaciones de seguridad

Campos clave:

  • name: identificador único del agente, utilizado como model en las llamadas a la API.
  • model.name: el modelo de LLM a utilizar (p. ej., gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
  • personality: prompt del sistema que define el comportamiento del agente.
  • tools: herramientas integradas, endpoints de API REST o servidores MCP que el agente puede utilizar.
  • sinaptic.enabled: activa/desactiva la seguridad de SinapticAI (detección de inyección de prompts, enmascaramiento de PII).

Comandos de CLI​

droid up          # Inicia el motor de ejecución (carga todos los agentes)
droid down        # Detiene de forma segura una instancia en ejecución
droid init NAME   # Crea un nuevo proyecto de agente
droid agents      # Enumera los agentes cargados y su estado
droid health      # Comprueba el estado del servidor
droid version     # Muestra la versión, el commit y la fecha de compilación

Próximos pasos​