> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bienvenidos al SDK

> Construye tus agentes de IA con solo unas lineas de codigo

## Alcance del SDK

**Plazbot SDK** te permite crear, configurar y desplegar **Agentes de IA** desde tu codigo. 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 intencion del usuario.

<Tip>
  La version 2.0 del SDK introduce la clase unificada `Plazbot` que agrupa todos los modulos en una sola instancia. Tambien puedes seguir usando las clases individuales `Agent`, `Portal`, `Message`, `Template` y `Contact`.
</Tip>

### Inicio Rapido

```ts theme={null}
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);
```

Tambien puedes importar las clases de forma individual:

```ts theme={null}
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 publico con ejemplos funcionales de todas las features del SDK v2.0.
</Card>

***

### Modulos del SDK

<CardGroup cols={2}>
  <Card title="Agente de IA" icon="message-bot" href="agent">
    Crea, actualiza, chatea y gestiona agentes con Tool Calling, archivos y configuracion de IA personalizada.
  </Card>

  <Card title="Servicios API" icon="plug" href="service">
    Conecta tus agentes a APIs externas con deteccion 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 informacion de tu empresa.
  </Card>

  <Card title="Widget" icon="comment" href="widget">
    Activa un widget embebible para tu sitio web con una sola linea de codigo.
  </Card>

  <Card title="Portal de IA" icon="window-flip" href="portal">
    Crea portales de busqueda con experiencia tipo ChatGPT para tus clientes.
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="message">
    Envia 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 telefono o email, actualizar y eliminar.
  </Card>
</CardGroup>

***

### Recursos

<CardGroup cols={3}>
  <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 mas.
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/changelog/sdk">
    Historial de versiones del SDK.
  </Card>
</CardGroup>