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

# Quick start

> ¿Prefieres ir directo al grano? Aquí tienes todo lo que necesitas para empezar de inmediato.

## Pruébalo: el Playground

1. **Abre el [Playground](https://console.typesafe.ai/playground)** e inicia sesión.
2. **Pega cualquier texto** como estado.

```plaintext title="Estado de ejemplo" theme={null} theme={null}
Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.
```

3. **Añade una pregunta.** Prueba una pregunta Noul: `"Does this message express urgency?"`

```json theme={null} theme={null}
{
  "urgency": {
    "type": "noul",
    "instructions": "Does this message express urgency?"
  }
}
```

4. **Añade más preguntas.** Mezcla Noul, Choice y Score en una llamada y ve todos los resultados a la vez.

## Llámalo: la API

1. **Obtén tu API key** desde el [dashboard](https://console.typesafe.ai/keys)
2. **Haz un request POST** al endpoint de la API
3. **Revisa la [Referencia API](/es/api)** para todos los detalles.

```http theme={null} theme={null}
POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json
```

### Comando cURL de ejemplo

```bash theme={null} theme={null}
curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
  {
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.",
    "model": "jev-latest",
    "questions": {
      "urgency": {
        "type": "noul",
        "instructions": "Does this message express urgency?"
      }
    }
  }
EOF
```

### Cuerpo del request

```json theme={null} theme={null}
{
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.",
  "model": "jev-latest",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated the customer appears",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time-sensitivity"
    }
  }
}
```

### Cuerpo de la respuesta

```json theme={null} theme={null}
{
  "model": "jev-1.13.0",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 0.78,
      "probabilities": {
        "technical": 0.85,
        "sales": 0.0,
        "billing": 0.15
      }
    },
    "frustration": {
      "type": "score",
      "score": 1.0,
      "confidence": 1.0,
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "probabilities": {
        "0": 0.0,
        "1": 1.0,
        "2": 0.0
      }
    },
    "is_urgent": {
      "type": "noul",
      "noul": 1.0
    }
  },
  "usage": {
    "input_tokens": 392,
    "output_tokens": 65
  }
}
```

Consulta la [Referencia API](/es/api) para todos los detalles.

## Prográmalo: el SDK de Python

1. **Instala el SDK** (requiere Python >= 3.10).

```bash title="Con pip" theme={null} theme={null}
pip install typesafe-sdk
```

```bash title="Con uv" theme={null} theme={null}
uv add typesafe-sdk
```

2. **Usa el SDK.** El cliente lee `TYPESAFE_API_KEY` del entorno y llama a `jev-latest` por defecto.

```python theme={null} theme={null}
from typesafe_sdk import Choice, Noul, Score, TypeSafeClient

client = TypeSafeClient()

ticket = "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP."

response = client.system_one(
    state=ticket,
    questions={
        "department": Choice(
            instructions="Which team should handle this",
            criteria={
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions",
            },
        ),
        "frustration": Score(
            instructions="How frustrated the customer appears",
            criteria=[
                "Calm, just stating facts",
                "Frustrated but civil",
                "Very angry, strong language",
            ],
        ),
        "is_urgent": Noul(
            instructions="The message conveys urgency or time-sensitivity",
        ),
    },
)

print(response.answers["department"].choice)  # "technical"
print(response.answers["frustration"].score)  # 1.0
print(response.answers["is_urgent"].noul)     # 1.0
```

Consulta los [SDKs de cliente](/es/sdk) para opciones de instalación y uso detallado.

## Fluye: el agent skill

1. **[Instala el skill de CosVec](/es/agent-skill#installation)** con el plugin de Claude Code o `npx skills add typesafe-ai/skills --skill typesafe-ai`. También puedes [leer SKILL.md en GitHub](https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md).

<Tabs>
  <Tab title="Claude Code">
    Ejecuta estos dos comandos en tu terminal:

    ```bash theme={null} theme={null}
    claude plugin marketplace add typesafe-ai/skills
    claude plugin install typesafe@typesafe-ai
    ```
  </Tab>

  <Tab title="Otros agentes">
    ```bash theme={null} theme={null}
    npx skills add typesafe-ai/skills --skill typesafe-ai
    ```

    Elige tu agente cuando se te pregunte. La instalación es local al proyecto por defecto; añade `-g` para instalar globalmente.
  </Tab>

  <Tab title="Copia a tu agente">
    Pega este prompt en tu agente de código:

    ```text wrap theme={null} theme={null}
    Install the CosVec skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the CosVec skill when working on this project.
    ```
  </Tab>
</Tabs>

2. **Dile a tu agente de código** que use el skill de CosVec mientras construyes.

```plaintext title="Prompt para el agente de código" theme={null} theme={null}
Let's build a simple CLI that uses the CosVec API to evaluate a set of supplied documents on multiple dimensions. Use the CosVec skill to understand how to use the CosVec API and how to structure the system. Ask me questions about what kinds of documents I want to evaluate and on what dimensions.
```

Consulta la página del [Agent Skill](/es/agent-skill) para más detalles.