<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="atom.xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://ashis.site/blog</id>
    <title>ashis.site Blog</title>
    <updated>2025-05-01T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://ashis.site/blog"/>
    <subtitle>ashis.site Blog</subtitle>
    <icon>https://ashis.site/img/favicon.svg</icon>
    <entry>
        <title type="html"><![CDATA[Shipping AI Agents to Production]]></title>
        <id>https://ashis.site/blog/ai-agents-production</id>
        <link href="https://ashis.site/blog/ai-agents-production"/>
        <updated>2025-05-01T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Developer guide notes on running AI agents on cloud platforms with evals, guardrails, and observability.]]></summary>
        <content type="html"><![CDATA[<p>Production <strong>AI agents</strong> need more than a clever prompt — they need <strong>evals</strong>, <strong>guardrails</strong>, and <strong>observability</strong> on <strong>cloud platforms</strong>, aligned with <a class="" href="https://ashis.site/docs/deployment/overview">deployment automation</a> practices.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="start-with-evals">Start with evals<a href="https://ashis.site/blog/ai-agents-production#start-with-evals" class="hash-link" aria-label="Direct link to Start with evals" title="Direct link to Start with evals" translate="no">​</a></h2>
<p>Define golden tasks before tuning prompts. Regression-test tool routing and citation quality on every release — the same discipline as <a class="" href="https://ashis.site/docs/open-source/contributing">open-source</a> contributions.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="operate-like-any-service">Operate like any service<a href="https://ashis.site/blog/ai-agents-production#operate-like-any-service" class="hash-link" aria-label="Direct link to Operate like any service" title="Direct link to Operate like any service" translate="no">​</a></h2>
<p>Set SLOs on latency and error rate. Route models by cost and capability. Never log secrets or raw PII in traces.</p>
<div class="language-typescript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-typescript codeBlock_bY9V thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#F8F8F2"><span class="token keyword control-flow" style="color:rgb(189, 147, 249);font-style:italic">await</span><span class="token plain"> agent</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token method function property-access" style="color:rgb(80, 250, 123)">run</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"> input</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> maxSteps</span><span class="token operator">:</span><span class="token plain"> </span><span class="token number">8</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> timeoutMs</span><span class="token operator">:</span><span class="token plain"> </span><span class="token number">30_000</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><br></div></code></pre></div></div>
<p>Pair agent APIs with <a class="" href="https://ashis.site/docs/seo-web/overview">SEO</a> and <a class="" href="https://ashis.site/docs/seo-web/docusaurus">web design</a> docs so integrators find your guides quickly.</p>]]></content>
        <author>
            <name>Ashis Kumar Baral</name>
            <uri>https://ashis.site</uri>
        </author>
        <category label="AI" term="AI"/>
        <category label="Cloud" term="Cloud"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Kubernetes Platform Patterns That Scale]]></title>
        <id>https://ashis.site/blog/kubernetes-platform-patterns</id>
        <link href="https://ashis.site/blog/kubernetes-platform-patterns"/>
        <updated>2025-04-15T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Developer guide to Kubernetes on cloud platforms — GitOps, guardrails, and platform engineering.]]></summary>
        <content type="html"><![CDATA[<p>Platform teams win when application developers don't think about clusters — they think about <strong>services</strong> on <strong>cloud platforms</strong>, with <a class="" href="https://ashis.site/docs/deployment/cicd">deployment automation</a> handling promotion.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="gitops-by-default">GitOps by default<a href="https://ashis.site/blog/kubernetes-platform-patterns#gitops-by-default" class="hash-link" aria-label="Direct link to GitOps by default" title="Direct link to GitOps by default" translate="no">​</a></h2>
<p>Declarative manifests in git, reconciled by controllers, give you audit trails and painless rollbacks — a core pattern in <a class="" href="https://ashis.site/docs/deployment/overview">deployment automation</a>.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="guardrails-not-gatekeeping">Guardrails, not gatekeeping<a href="https://ashis.site/blog/kubernetes-platform-patterns#guardrails-not-gatekeeping" class="hash-link" aria-label="Direct link to Guardrails, not gatekeeping" title="Direct link to Guardrails, not gatekeeping" translate="no">​</a></h2>
<p>NetworkPolicies, resource quotas, and approved base images reduce incidents without blocking velocity.</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">resources</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">requests</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">cpu</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> 100m</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">memory</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> 128Mi</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">limits</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">cpu</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> 500m</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">memory</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> 512Mi</span><br></div></code></pre></div></div>
<p><strong>Open-source technologies</strong> (Helm, Kustomize, Crossplane) keep platforms portable across clouds. Document runbooks with the same clarity as your public <a class="" href="https://ashis.site/docs/intro">developer docs</a>.</p>]]></content>
        <author>
            <name>Ashis Kumar Baral</name>
            <uri>https://ashis.site</uri>
        </author>
        <category label="Cloud" term="Cloud"/>
        <category label="Open Source" term="Open Source"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Technical SEO for Developer Documentation Sites]]></title>
        <id>https://ashis.site/blog/docs-site-seo</id>
        <link href="https://ashis.site/blog/docs-site-seo"/>
        <updated>2025-03-20T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Guide to SEO and web design for docs sites — metadata, performance, search, and discoverability.]]></summary>
        <content type="html"><![CDATA[<p>Developer <strong>docs</strong> are content products. <strong>SEO</strong> and <strong>web design</strong> together help readers discover guides on open-source technologies, cloud platforms, AI agents, deployment automation, and more.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="metadata-matters">Metadata matters<a href="https://ashis.site/blog/docs-site-seo#metadata-matters" class="hash-link" aria-label="Direct link to Metadata matters" title="Direct link to Metadata matters" translate="no">​</a></h2>
<p>Every doc and blog post should have a unique <code>description</code> in front matter. Example site-wide copy:</p>
<div class="language-mdx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-mdx codeBlock_bY9V thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#F8F8F2"><span class="token plain">---</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">description: Developer docs and guides for open-source technologies, cloud platforms, AI agents, deployment automation, web design, and SEO.</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">---</span><br></div></code></pre></div></div>
<p>Use canonical URLs, sitemaps, and stable paths — see the <a class="" href="https://ashis.site/docs/seo-web/overview">SEO overview</a>.</p>
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" id="performance-is-seo">Performance is SEO<a href="https://ashis.site/blog/docs-site-seo#performance-is-seo" class="hash-link" aria-label="Direct link to Performance is SEO" title="Direct link to Performance is SEO" translate="no">​</a></h2>
<p><a class="" href="https://ashis.site/docs/seo-web/performance">Core Web Vitals</a> affect rankings. Static generation, font subsetting, and edge caching keep docs snappy — especially on <a class="" href="https://ashis.site/docs/seo-web/docusaurus">Docusaurus</a> sites like ashis.site.</p>
<p>Pair great content with <strong>local search</strong> so developers find answers in milliseconds.</p>]]></content>
        <author>
            <name>Ashis Kumar Baral</name>
            <uri>https://ashis.site</uri>
        </author>
        <category label="SEO" term="SEO"/>
        <category label="Open Source" term="Open Source"/>
    </entry>
</feed>