Files

328 lines
20 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>csharp</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant โ€”
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/csharp">
<link rel="alternate" type="text/markdown" href="/csharp.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/csharp.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>csharp</h1><p class="lede">Build .NET 8+, ASP.NET Core, Unity, and Godot 4 .NET applications on Hanzo Cloud (https://api.hanzo.ai) with the official Hanzo C# SDK (Hanzo 8.5.1027 from hanzo-csharp/sdk). Load when installing or calling the Hanzo NuGet package for Zen 6 chat completions (/v1/chat/completions), Kai zero-output-token decisions (/v1/decisions), Zen Voice binary MP3 synthesis (PostAudioSpeechBytes on /v1/audio/speech), revisioned Cloud KV state and game saves (KvApi on /v1/kv), Cloud Agents (PostAgentByRefRun on /v1/agent), IAM/KMS/Commerce APIs, or Cloud MCP tools (/v1/mcp).</p><h1>C# / .NET SDK</h1>
<p><code>Hanzo</code> (<code>8.5.1027</code>, namespace <code>Hanzo.AI</code>) is the official C# client for <code>https://api.hanzo.ai</code>. It is generated from the live Hanzo Cloud OpenAPI specification (<code>38</code> service APIs across AI, Decisions, Cloud KV, Agents, Base, IAM, KMS, Commerce, Console, Platform, Tasks, O11y, and MCP) and extended with handwritten helpers for <code>Gateway.Configuration()</code>, agent run execution (<code>PostAgentByRefRunAsync</code>), and binary MP3 speech synthesis (<code>PostAudioSpeechBytesAsync</code>).</p>
<h2>Docs &amp; Repositories</h2>
<ul><li><strong>C# / .NET SDK Guide</strong>: <a href="https://docs.hanzo.ai/docs/sdks/csharp">docs.hanzo.ai/docs/sdks/csharp</a></li><li><strong>Godot 4 &amp; Game Backend Guide</strong>: <a href="https://docs.hanzo.ai/docs/sdks/godot">docs.hanzo.ai/docs/sdks/godot</a></li><li><strong>Kai Decisions Wire Reference</strong>: <a href="https://docs.hanzo.ai/docs/decisions">docs.hanzo.ai/docs/decisions</a></li><li><strong>Full Docs Index</strong>: <a href="https://docs.hanzo.ai/llms.txt">docs.hanzo.ai/llms.txt</a></li><li><strong>Source, Releases &amp; Runnable Slices</strong>: <a href="https://github.com/hanzo-csharp/sdk">github.com/hanzo-csharp/sdk</a></li></ul>
<h2>Install &amp; Configure</h2>
<p>Target <code>.NET 8.0+</code> (<code>net8.0</code>). Install from NuGet or GitHub Packages (<code>https://nuget.pkg.github.com/hanzo-csharp/index.json</code>):</p>
<pre><code class="lang-bash">dotnet add package Hanzo --version 8.5.1027</code></pre>
<p><code>Gateway.Configuration()</code> reads <code>HANZO_API_KEY</code> (falling back to <code>OPENAI_API_KEY</code>) and <code>HANZO_BASE_URL</code> (default <code>https://api.hanzo.ai</code>), wiring Bearer auth automatically:</p>
<pre><code class="lang-csharp">using Hanzo.AI;
using Hanzo.AI.Api;
using Hanzo.AI.Client;
Configuration cfg = Gateway.Configuration();
cfg.Timeout = TimeSpan.FromSeconds(90);
var ai = new AiApi(cfg);
var kv = new KvApi(cfg);
var agents = new AgentApi(cfg);
var mcp = new OpenapiApi(cfg);</code></pre>
<p>Keep secret <code>sk-</code> keys server-side or in local developer environments (<code>export HANZO_API_KEY=&quot;$(hanzo auth token)&quot;</code>); never ship secret keys inside browser WASM bundles.</p>
<h2>Core Operations</h2>
<h3>1. Zen 6 Chat Completions (<code>/v1/chat/completions</code>)</h3>
<p>Use <code>zen6-flash</code> for low-latency interactive replies, <code>zen6</code> for deep reasoning (<code>reasoning_effort = &quot;low&quot;</code> keeps interactive calls fast), and <code>zen6-coder</code> / <code>zen6-max</code> for heavy synthesis. Never use retired <code>zen-4</code> or <code>zen-5</code> IDs.</p>
<pre><code class="lang-csharp">object reply = await ai.PostChatCompletionsAsync(new
{
model = &quot;zen6-flash&quot;,
max_tokens = 256,
messages = new[]
{
new { role = &quot;system&quot;, content = &quot;Reply concisely.&quot; },
new { role = &quot;user&quot;, content = &quot;Summarize three benefits of revisioned KV saves.&quot; }
}
});</code></pre>
<h3>2. Kai Zero-Output-Token Decisions (<code>/v1/decisions</code>)</h3>
<p>Use <code>model = &quot;kai&quot;</code> whenever C# code needs a bounded judgment over known options (routing, triage, moderation gates, NPC state selection, AI Director pacing) instead of parsing LLM prose. <code>usage.output_tokens</code> is <code>0</code>:</p>
<pre><code class="lang-csharp">object decision = await ai.PostDecisionsAsync(new
{
model = &quot;kai&quot;,
state = new { health = 0.22, under_fire = true, cover_distance_m = 4.0 },
questions = new
{
action = new
{
type = &quot;choice&quot;,
instructions = &quot;Select the squad unit&#x27;s immediate combat action.&quot;,
criteria = new Dictionary&lt;string, string&gt;
{
[&quot;attack&quot;] = &quot;Healthy unit with clear close-range shot.&quot;,
[&quot;flank&quot;] = &quot;Medium range engagement with lateral cover.&quot;,
[&quot;retreat&quot;] = &quot;Health below 25% while under active fire.&quot;
}
}
}
});</code></pre>
<h3>3. Zen Voice Binary MP3 Synthesis (<code>/v1/audio/speech</code>)</h3>
<p>Call the handwritten <code>PostAudioSpeechBytesAsync</code> extension (<code>AiApiSpeech.cs</code>) to receive raw MP3 <code>byte[]</code> from <code>zen-voice</code> without JSON string corruption:</p>
<pre><code class="lang-csharp">byte[] mp3Bytes = await ai.PostAudioSpeechBytesAsync(new
{
model = &quot;zen-voice&quot;,
voice = &quot;af_heart&quot;,
input = &quot;Checkpoint synced. Hostiles flanking from sector north.&quot;
});</code></pre>
<p>In Godot 4 <code>.NET</code>, assign directly to an <code>AudioStreamPlayer3D</code>:</p>
<pre><code class="lang-csharp">player3D.Stream = new AudioStreamMP3 { Data = mp3Bytes };
player3D.Play();</code></pre>
<h3>4. Revisioned Cloud KV State &amp; Game Saves (<code>/v1/kv/{bucket}/{key}</code>)</h3>
<p>Bucket names MUST use 1โ€“64 ASCII letters, digits, or underscores (<code>^[A-Za-z0-9_]{1,64}$</code>, never hyphens):</p>
<pre><code class="lang-csharp">string bucket = &quot;game_saves_prod&quot;;
await kv.PostKvByBucketAsync(bucket, new { history = 10 });
await kv.PutKvByBucketAndKeyAsync(bucket, &quot;slot_1&quot;, new
{
value = &quot;{\&quot;scene\&quot;:\&quot;bunker_02\&quot;,\&quot;tension\&quot;:0.68,\&quot;ammo\&quot;:15}&quot;
});
object current = await kv.GetKvByBucketAndKeyAsync(bucket, &quot;slot_1&quot;);
object revisions = await kv.GetKvByBucketAndKeyHistoryAsync(bucket, &quot;slot_1&quot;);
await kv.DeleteKvByBucketAsync(bucket);</code></pre>
<h3>5. Cloud Agents &amp; MCP (<code>/v1/agent</code>, <code>/v1/mcp</code>)</h3>
<p>Create persistent agents on <code>zen6-flash</code>, trigger runs via <code>PostAgentByRefRunAsync</code>, and call the 50+ Cloud MCP tools over JSON-RPC <code>2.0</code> (<code>protocolVersion = &quot;2026-07-28&quot;</code>):</p>
<pre><code class="lang-csharp">object created = await agents.PostAgentAsync(new
{
name = &quot;world-sim&quot;,
model = &quot;zen6-flash&quot;,
system = &quot;Return compact JSON world-event updates.&quot;
});
object mcpInit = await mcp.PostMcpAsync(new
{
jsonrpc = &quot;2.0&quot;,
id = 1,
method = &quot;initialize&quot;,
@params = new
{
protocolVersion = &quot;2026-07-28&quot;,
capabilities = new { },
clientInfo = new { name = &quot;hanzo-csharp&quot;, version = &quot;8.5.1027&quot; }
}
});</code></pre>
<h2>Verification</h2>
<p>Run both wire tests (offline) and live <code>https://api.hanzo.ai</code> integration tests in <code>hanzo-csharp/sdk</code>:</p>
<pre><code class="lang-bash"># Offline wire &amp; serialization tests
HANZO_OFFLINE=1 dotnet test
# Live api.hanzo.ai integration suite + full game-backend slice
export HANZO_API_KEY=&quot;$(hanzo auth token)&quot;
dotnet test
dotnet run --project examples -- game-backend</code></pre>
<h2>Install</h2>
<pre><code class="lang-bash">npx skills add https://hanzoskills.com/csharp.md</code></pre>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/csharp.md">This page as plain text</a> ยท <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>