Laten we de theorie overslaan en meteen aan de slag gaan. In deze post ga je van een lege terminal naar een werkende AI-aanroep in minder dan 5 minuten.
Vereisten
| Vereiste | Versie | Controle |
|---|---|---|
| .NET SDK | 9.0+ | dotnet --version |
| Git | Elke | git --version |
| API Key | OpenAI of Anthropic | Je dashboard |
Stap 1: Clone de Repository
git clone https://github.com/martiendejong/Hazina.git
cd hazina
Stap 2: Herstel Afhankelijkheden
dotnet restore Hazina.QuickStart.sln
Stap 3: Stel Je API Key In
# PowerShell
$env:OPENAI_API_KEY = "sk-your-key-here"
# Of voor Anthropic
$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"
Stap 4: Voer de Demo Uit
dotnet run --project apps/Demos/Hazina.Demo.ConfigurationShowcase
Je zou output moeten zien die laat zien hoe verschillende AI-providers reageren op prompts. Dat is het – Hazina draait.
Stap 5: Je Eerste Aangepaste AI-aanroep
Maak een nieuwe console-app of voeg dit toe aan een bestaand project:
using Hazina.AI.FluentAPI.Configuration;
using Hazina.AI.FluentAPI.Core;
// Eenmalige setup
QuickSetup.SetupOpenAI(Environment.GetEnvironmentVariable("OPENAI_API_KEY")!);
// Stel een vraag
var answer = await Hazina.AskAsync("What is the meaning of life?");
Console.WriteLine(answer);
Twee regels setup. Eén regel om AI aan te roepen. Dat is de Hazina-manier.
Verificatiechecklist
| Component | Commando | Verwacht |
|---|---|---|
| Build | dotnet build Hazina.QuickStart.sln |
0 fouten |
| Tests | dotnet test Hazina.QuickStart.sln |
Alles slaagt |
| Demo | dotnet run --project apps/Demos/... |
AI-output |
Veelvoorkomende Scenario’s
Gewoon aan het verkennen? Open Hazina.QuickStart.sln en bekijk de demo’s.
Een AI-app bouwen? Verwijs naar Hazina.AI.FluentAPI in je project en gebruik QuickSetup.
Documenten doorzoeken nodig? We behandelen RAG in een latere post – blijf op de hoogte.
In de volgende post duiken we in de FluentAPI – Hazina’s elegante manier om met elke LLM-provider te communiceren.
Veelgestelde Vragen
Om de Hazina-repository te clonen, open je je terminal en voer je het commando `git clone https://github.com/martiendejong/Hazina.git` uit. Na het clonen navigeer je naar de directory met `cd hazina` om te beginnen met werken aan je AI-aanroep.
Je hebt de .NET SDK versie 9.0 of hoger en Git op je systeem nodig. Daarnaast moet je een API-sleutel hebben van OpenAI of Anthropic om je AI-aanroepen te authenticeren.
Je kunt je OpenAI API-sleutel instellen in een PowerShell-terminal door het commando `$env:OPENAI_API_KEY = ‘sk-your-key-here’` te gebruiken. Vervang ‘sk-your-key-here’ door je daadwerkelijke API-sleutel om voor de juiste authenticatie te zorgen.
De `Hazina.Demo.ConfigurationShowcase` demonstreert hoe verschillende AI-providers reageren op prompts. Het commando `dotnet run –project apps/Demos/Hazina.Demo.ConfigurationShowcase` uitvoeren zal de output tonen en je helpen verifiëren dat Hazina correct is ingesteld.
