creo-kit/claude-ai-generation

O que claude-ai-generation faz?

Habilidade de pipeline de geração de IA para Claude Code. Engenharia de prompts de LLM, validação, filas, streaming SSE e processamento em lote. Instalação com um comando.

Visão Geral

Esta habilidade oferece um sistema modular para construir e executar pipelines de geração de IA, desde a definição de prompts até o processamento das respostas. Ela é projetada para ser flexível e escalável, suportando diferentes modelos de LLM e estratégias de validação.

Funcionalidades

• Engenharia de Prompts: Criação e gerenciamento de templates de prompts com suporte a variáveis e contextos.
• Validação: Verificação de entradas e saídas para garantir qualidade e conformidade com regras definidas.
• Filas: Gerenciamento de requisições para controle de concorrência e priorização.
• Streaming SSE: Entrega de respostas em tempo real usando eventos do servidor.
• Processamento em Lote: Execução de múltiplas tarefas de geração de forma eficiente.

Instalação

Para instalar esta habilidade no Claude Code, execute:

claude code add creo-kit/claude-ai-generation

Uso Básico

Após a instalação, você pode configurar um pipeline simples:

import { createPipeline } from "@creo-kit/ai-generation";

const pipeline = createPipeline({
  model: "claude-3-opus-20240229",
  prompt: "Gere uma descrição para um produto de tecnologia.",
  validation: { maxTokens: 100 },
});

const result = await pipeline.run();
console.log(result.text);

Configuração

Variáveis de Ambiente

• AI_GENERATION_API_KEY: Chave de API para o LLM.
• AI_GENERATION_MODEL: Modelo padrão a ser usado.
• AI_GENERATION_MAX_CONCURRENCY: Número máximo de requisições simultâneas.

Opções de Pipeline

Opção	Tipo	Descrição
model	string	Identificador do modelo LLM.
prompt	string	Template de prompt com placeholders.
context	object	Dados de contexto para preencher prompts.
validation	object	Regras de validação (ex.: maxTokens).
streaming	boolean	Habilitar streaming SSE.

Exemplos

Streaming SSE

const pipeline = createPipeline({
  model: "claude-3-sonnet-20240229",
  prompt: "Explique o conceito de aprendizado de máquina.",
  streaming: true,
});

pipeline.on("token", (token) => {
  process.stdout.write(token);
});

await pipeline.run();

Processamento em Lote

import { batchGenerate } from "@creo-kit/ai-generation";

const tasks = [
  { prompt: "Gere um título para um artigo sobre IA." },
  { prompt: "Escreva uma introdução sobre blockchain." },
];

const results = await batchGenerate(tasks, { concurrency: 2 });
results.forEach((r, i) => console.log(`Tarefa ${i + 1}: ${r.text}`));

Contribuição

Sinta-se à vontade para relatar problemas ou enviar pull requests no repositório oficial.

Licença

MIT