# Bienvenidos al SDK

> Construye tus agentes de IA con solo unas líneas de código

Fuente: https://developers.plazbot.com/sdk/introduccion/

## Alcance del SDK

**Plazbot SDK** te permite crear, configurar y desplegar **Agentes de IA** desde tu código. Con una sola instancia puedes gestionar agentes, portales, mensajes de WhatsApp, plantillas y contactos.

Con la tecnologia **RAG** de Plazbot, tus agentes pueden leer archivos (PDF, DOCX, CSV, Excel), consumir servicios API REST y ejecutar acciones automaticas basadas en la intención del usuario.

> **Tip:** La versión 2.0 del SDK introduce la clase unificada `Plazbot` que agrupa todos los módulos en una sola instancia. También puedes seguir usando las clases individuales `Agent`, `Portal`, `Message`, `Template` y `Contact`.

### Inicio Rápido

```ts
import { Plazbot } from 'plazbot';

const plazbot = new Plazbot({
workspaceId: "YOUR_WORKSPACE_ID",
apiKey: "YOUR_API_KEY",
zone: "LA" // "EU" para Europa
});

// Crear un agente
const agent = await plazbot.agent.addAgent({
name: "Mi Agente",
prompt: "Eres un asistente de ventas.",
zone: "LA",
buffer: 5
});

// Chatear con el agente
const response = await plazbot.agent.onMessage({
agentId: agent.agentId,
question: "Que servicios ofrecen?",
sessionId: crypto.randomUUID()
});

console.log(response.answer);
```

También puedes importar las clases de forma individual:

```ts
import { Agent, Portal, Message, Template, Contact } from 'plazbot';
```

---

### Repositorio de Ejemplos

<Card
  title="GitHub - plazbot-sdk-examples"
  icon="github"
  href="https://github.com/plazbot/plazbot-sdk-examples"
>
  Repositorio público con ejemplos funcionales de todas las features del SDK v2.0.
</Card>

---

### Módulos del SDK

  <Card
    title="Agente de IA"
    icon="message-bot"
    href="agent"
  >
    Crea, actualiza, chatea y gestiona agentes con Tool Calling, archivos y configuración de IA personalizada.
  </Card>
  <Card
    title="Servicios API"
    icon="plug"
    href="service"
  >
    Conecta tus agentes a APIs externas con detección de intenciones y respuestas condicionales.
  </Card>
  <Card
    title="Archivos (RAG)"
    icon="file"
    href="file"
  >
    Sube documentos PDF, DOCX, CSV y Excel para que tu agente responda con información de tu empresa.
  </Card>
  <Card
    title="Widget"
    icon="comment"
    href="widget"
  >
    Activa un widget embebible para tu sitio web con una sola línea de código.
  </Card>
  <Card
    title="Portal de IA"
    icon="window-flip"
    href="portal"
  >
    Crea portales de búsqueda con experiencia tipo ChatGPT para tus clientes.
  </Card>
  <Card
    title="WhatsApp"
    icon="whatsapp"
    href="message"
  >
    Envía mensajes, plantillas con variables y archivos. Registra webhooks para recibir mensajes.
  </Card>
  <Card
    title="Plantillas"
    icon="layer-group"
    href="template"
  >
    Gestiona tus plantillas de WhatsApp aprobadas por Meta.
  </Card>
  <Card
    title="Contactos"
    icon="address-book"
    href="contact"
  >
    CRUD completo de contactos: crear, buscar por teléfono o email, actualizar y eliminar.
  </Card>

---

### Recursos

  <Card
    title="Credenciales"
    icon="lock"
    href="/api-reference/api-key"
  >
    Obtener tu API Key y Workspace ID.
  </Card>
  <Card
    title="Acciones"
    icon="bolt"
    href="action"
  >
    Asignar, etiquetar, segmentar y más.
  </Card>