agentuity-services

Use when selecting or using Agentuity service clients from app code. Covers standalone clients for key-value, vector, object storage, durable streams, queues, email, schedules, tasks, webhooks, sandbox, Coder, telemetry, direct clients versus Hono middleware, and service environment configuration.

Ir para a instalação

Repositório: agentuity/sdk
Última atividade na origem: 25 de junho de 2026 às 22:22
Idioma detectado do SKILL.md: inglês
Estrelas: 19
Forks: 2

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/agentuity/sdk --skill agentuity-services

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

agentuity-cli

Use when working with the Agentuity CLI itself: installation, authentication, profiles, JSON output, command discovery, schema inspection, non-interactive automation, structured input, and deciding which Agentuity command family to use.

2026-07-24

agentuity-cloud

Use when managing Agentuity Cloud from the terminal. Covers deployments, deployment logs, environment variables and secrets, regions, project resource linking, cloud resource commands, SSH, SCP, monitoring snapshots, and agent-friendly CLI workarounds.

2026-07-24

agentuity-project

Use when creating, importing, running, building, or deploying an Agentuity app. Covers framework-first project structure, agentuity.json, .env setup, agentuity dev, agentuity build, agentuity deploy, monorepo --dir usage, and deployment bundle inspection.

2026-07-24

Ver todas deste repositório

Need	Package
Exact-key JSON, TTL cache, preferences, counters	`@agentuity/keyvalue`
Semantic search, retrieval, document embeddings	`@agentuity/vector`
S3-compatible files and binary data	`@agentuity/storage`
Durable generated output or resumable streams	`@agentuity/stream`
Model catalog and routed model requests	`@agentuity/aigateway`
Async message handoff	`@agentuity/queue`
Managed outbound or inbound email	`@agentuity/email`
Cron schedules and delivery tracking	`@agentuity/schedule`
Work items, comments, tags, attachments	`@agentuity/task`
Managed webhook ingest URLs and receipts	`@agentuity/webhook`
Isolated command execution	`@agentuity/sandbox`
Cloud coding sessions and workspaces	`@agentuity/coder`
Logger, tracer, and meter setup	`@agentuity/telemetry`

Code location	Use
Framework routes, scripts, and workers	Direct clients such as `new QueueClient()`
Hono routes that should share clients through context	`@agentuity/hono` middleware
Browser components	Your server route, not service clients directly
Non-TypeScript systems	REST API

import { Hono } from 'hono';
import { agentuity } from '@agentuity/hono';
import type { Services } from '@agentuity/hono';

const app = new Hono<{ Variables: Pick<Services, 'kv' | 'queue'> }>();

app.use('*', agentuity());

app.post('/api/jobs', async (c) => {
  const message = await c.var.queue.publish('jobs', { requestedAt: new Date().toISOString() });
  await c.var.kv.set('job-status', message.id, { status: 'queued' });
  return c.json({ messageId: message.id }, 202);
});

Option	Use
`apiKey`	Override `AGENTUITY_SDK_KEY` or `AGENTUITY_CLI_KEY`
`orgId`	Target an organization explicitly for org-scoped APIs
`url`	Override service URL for local or custom endpoints
`logger`	Provide a logger implementation

import { bucketConfigFromEnv, createS3Client } from '@agentuity/storage';

const storage = createS3Client(bucketConfigFromEnv());

import { VectorClient } from '@agentuity/vector';

const vector = new VectorClient();

await vector.upsert('docs', {
  key: 'service-clients',
  document: 'Agentuity services are available through standalone packages.',
  metadata: { source: 'docs' },
});

const results = await vector.search('docs', {
  query: 'How do I use services from app code?',
  limit: 3,
});

import { QueueClient } from '@agentuity/queue';

const queue = new QueueClient();

const message = await queue.publish(
  'report-jobs',
  { accountId: 'acct_123', month: '2026-06' },
  { idempotencyKey: 'report-acct_123-2026-06' }
);

import { TaskClient } from '@agentuity/task';

const tasks = new TaskClient();

await tasks.create({
  title: 'Review generated report',
  description: 'Validate report output before sending it to the customer.',
});

Mistake	Better approach
Choosing a service by package name alone	Start with the job: cache, search, files, queue, schedule, email
Putting service clients in browser code	Keep clients server-side and expose a route
Using KV for relational data	Use a database for relational queries and joins
Using sandbox as a general worker queue	Use queues/schedules/tasks for workflow; sandbox for bounded execution
Forgetting resource setup	Use `agentuity-cloud` to create/link resources and inspect them

Variable	Purpose
`AWS_ENDPOINT`	S3 endpoint written by project linking
`AWS_BUCKET`	Bucket name
`AWS_ACCESS_KEY_ID`	Bucket access key
`AWS_SECRET_ACCESS_KEY`	Bucket secret
`AWS_REGION`	Optional region

agentuity-services

Opções de instalação

Revise os arquivos de origem

Agentuity Service Clients

Basic Pattern

Agentuity Service Clients

Basic Pattern

Choose the Right Service

Direct Clients vs Hono Middleware

Configuration

Service Examples

Common Mistakes

Useful Docs

name	agentuity-services
description	Use when selecting or using Agentuity service clients from app code. Covers standalone clients for key-value, vector, object storage, durable streams, queues, email, schedules, tasks, webhooks, sandbox, Coder, telemetry, direct clients versus Hono middleware, and service environment configuration.
license	Apache-2.0
metadata	{"author":"agentuity","version":"1.0.0"}

agentuity-services

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Agentuity Service Clients

Basic Pattern

Mais deste repositório

Agentuity Service Clients

Basic Pattern

Choose the Right Service

Direct Clients vs Hono Middleware

Configuration

Service Examples

Common Mistakes

Useful Docs