# Quick Start

Get up and running with the Skillful Web SDK in minutes.

### `Basic Setup`

```javascript
const { SkillfulClient } = require('@skillfulai/agents');

// Initialize the client
const client = new SkillfulClient({
    apiKey: 'your-api-key'
});
```

### `Your First Conversation`

```javascript
async function startConversation() {
    try {
        // Get available agents created on the Skillful Dashboard
        const agents = await client.getAgents();
        
        // Select an agent by name
        await client.setAgent('Wojak');
        
        // Send a message and get a response from the agent
        const response = await client.sendMessage('Hello!');
        console.log(response.text);
        
    } catch (error) {
        console.error('Error:', error.message);
    }
}
```

### `Response Handling`

```javascript
// Response includes parsed text and metadata
const response = await client.sendMessage('Tell me about Web3');
console.log(response.text);       // The agent's response
console.log(response.events);     // Event metadata
console.log(response.tools);      // Tools used
console.log(response.sources);    // Source references
```

### `Next Steps`

* Explore agent capabilities using `agent.getSkills()`
* Manage conversation history with `client.getConversationHistory()`
* Implement error handling for robust applications


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaming.skillfulai.io/web-sdk/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
