Skills cookbook

import json
from pathlib import Path
from atlanai import AtlanClient

client = AtlanClient(
    "https://api.atlan.com",
    bearer_token="...",
    workspace="workspace_01example",
)

skill = client.skills.create(
    # A multipart part, so this is a JSON *string* — not a dict.
    metadata=json.dumps(
        {
            "name": "disposable-example",
            "description": "A disposable documentation check",
            "workspace_id": "workspace_01example",
        }
    ),
    Path("./disposable-example.zip").read_bytes(),
)
print(skill.id)

import { readFile } from "node:fs/promises";
import { AtlanClient } from "@atlanai/sdk";

const client = new AtlanClient({
  gatewayOrigin: "https://api.atlan.com",
  bearerToken: "...",
  workspace: "workspace_01example",
});

const skill = await client.skills.create({
  // A multipart part, so this is a JSON string — not an object.
  metadata: JSON.stringify({
    name: "disposable-example",
    description: "A disposable documentation check",
    workspace_id: "workspace_01example",
  }),
  body: new Blob([await readFile("./disposable-example.zip")]),
});
console.log(skill.id);

import json
from pathlib import Path

result = client.skills.bulk_create(
    json.dumps(
        [
            {
                "metadata": {
                    "name": "incident-brief",
                    "description": "Create an incident brief from a reviewed timeline.",
                    "workspace_id": "workspace_01example",
                },
                "body_part": "incident-brief",
            },
            {
                "metadata": {
                    "name": "release-notes",
                    "description": "Turn merged changes into release notes.",
                    "workspace_id": "workspace_01example",
                },
                "body_part": "release-notes",
            },
        ]
    ),
)

for index, item in enumerate(result.items):
    print(index, item.status)

const result = await client.skills.bulkCreate({
  items: JSON.stringify([
    {
      metadata: {
        name: "incident-brief",
        description: "Create an incident brief from a reviewed timeline.",
        workspace_id: "workspace_01example",
      },
      body_part: "incident-brief",
    },
    {
      metadata: {
        name: "release-notes",
        description: "Turn merged changes into release notes.",
        workspace_id: "workspace_01example",
      },
      body_part: "release-notes",
    },
  ]),
});

result.items.forEach((item, index) => console.log(index, item.status));

matches = client.skills.search({
        "query": "release notes",
        "workspace_id": "workspace_01example",
        "limit": 20,
    }
)

everything = client.skills.list(limit=20)
one = client.skills.get_enriched("skill_01example")
client.skills.update("skill_01example",
    {"description": "Turn merged changes into release notes."},
)

const matches = await client.skills.search({
  query: "release notes",
  workspaceId: "workspace_01example",
  limit: 20,
});

const everything = await client.skills.list({ limit: 20 });
const one = await client.skills.getEnriched("skill_01example");
await client.skills.update("skill_01example", {
  description: "Turn merged changes into release notes.",
});

import io
import zipfile

version = client.skills.versions.get_enriched("skill_01example", version_ordinal=1
)

archive = client.skills.versions.get_bundle("skill_01example", version_ordinal=1
)
print(zipfile.ZipFile(io.BytesIO(archive)).namelist())

# The current bundle rather than a pinned version.
current = client.skills.get_bundle("skill_01example")

const version = await client.skills.versions.getEnriched({
  skillId: "skill_01example",
  versionOrdinal: 1,
});

const archive = await client.skills.versions.getBundle({
  skillId: "skill_01example",
  versionOrdinal: 1,
});

const current = await client.skills.getBundle({ skillId: "skill_01example" });

import time

runs = client.skills.traces.list("skill_01example", limit=10)

now = int(time.time())
stats = client.skills.traces.query_stats("skill_01example",
    {
        "request_type": "scalar",
        "queries": [{"name": "runs", "measure": "traces"}],
        "start_time_unix_seconds": now - 7 * 86_400,
        "end_time_unix_seconds": now,
    },
)
for result in stats.data.results:
    print(result.query_name, result.measure, result.value)

insights = client.skills.list_insights("skill_01example")
schemas = client.insights.schemas()

const runs = await client.skills.traces.list({
  skillId: "skill_01example",
  limit: 10,
});

const now = Math.floor(Date.now() / 1000);
const stats = await client.skills.traces.queryStats({
  skillId: "skill_01example",
  {
    requestType: "scalar",
    queries: [{ name: "runs", measure: "traces" }],
    startTimeUnixSeconds: now - 7 * 86_400,
    endTimeUnixSeconds: now,
  },
});

const insights = await client.skills.listInsights({ skillId: "skill_01example" });
const schemas = await client.insights.schemas();