エージェントを作る

良く設計されたエージェントは、実行前に 3 つの質問に答えられる必要があります。各層はそれぞれ別の筏を担当します。

Step 1 — Knowledge (知識)

ドキュメントをバケットにアップロードすると、Schift が OCR、チャンキング、埋め込みを自動で処理します。エージェントはその後、インデックスされたすべてのコンテンツを検索できます。

typescriptimport { Schift, RAG } from '@schift-io/sdk';

const schift = new Schift({ apiKey: process.env.SCHIFT_API_KEY });

// ドキュメントをアップロード — Schift が自動でインデックス
await schift.buckets.upload('your-bucket-id', './support-docs/');

// バケットを検索可能な知識ソースとしてラップ
const rag = new RAG(schift, { bucketId: 'your-bucket-id' });

Step 2 — Rules (ルール)

エージェントがどのように推論し応答するかを設定します。システムプロンプトはエージェントの役割を定義し、モデルは性能とコストを調整し、メモリ設定は保持するコンテキスト長を決めます。

typescriptimport { Agent } from '@schift-io/sdk';

const agent = new Agent(schift, {
  model: 'gpt-4.1',
  systemPrompt: 'あなたは親切なカスタマーサポートエージェントです。提供されたドキュメントを元に質問に答えてください。回答が見つからない場合は明確にそう伝えてください。',
  maxSteps: 5,
  memory: { enabled: true, windowSize: 10 },
});

Step 3 — Tasks (タスク)

ツールを登録すると、エージェントは質問への回答以上の能力を持ちます。RAG ソースをツールとして登録したり、リアルタイム情報のための Web 検索を追加したり、外部システムと連携するカスタム関数を書いたりできます。

typescriptimport { WebSearch } from '@schift-io/sdk';

// エージェントに知識ベースへのアクセス権を付与
agent.addTool(rag.asTool());

// リアルタイム情報のための Web 検索を追加
agent.addTool(new WebSearch(schift).asTool());

// 外部連携のためのカスタムツール
agent.addTool({
  name: 'createTicket',
  description: '未解決の問題があるときにサポートチケットを作成',
  parameters: { subject: 'string', priority: 'low | medium | high' },
  run: async ({ subject, priority }) => {
    // チケットシステムを呼び出す
    return { ticketId: 'TKT-001' };
  },
});

まとめてコード例

3 層すべてを 1 つのファイルにまとめた完成例:

typescriptimport { Schift, Agent, RAG, WebSearch } from '@schift-io/sdk';

const schift = new Schift({ apiKey: process.env.SCHIFT_API_KEY });

// Layer 1 — Knowledge
const rag = new RAG(schift, { bucketId: 'your-bucket-id' });

// Layer 2 — Rules
const agent = new Agent(schift, {
  model: 'gpt-4.1',
  systemPrompt: 'あなたは親切なカスタマーサポートエージェントです...',
  maxSteps: 5,
});

// Layer 3 — Tasks
agent.addTool(rag.asTool());
agent.addTool(new WebSearch(schift).asTool());

// 実行
const response = await agent.run('請求の設定方法を教えてください。');
console.log(response.text);