ツール開発

​

ツールの作成

​

ツールエディタ

​

キーボードショートカット

​

TypeScriptでのツール作成

import { z } from "zod";

// Define the input schema
export const input = z.object({
  name: z.string().describe("The user's name"),
  greeting: z.string().optional().describe("Custom greeting prefix"),
});

// Define the output schema
export const output = z.object({
  message: z.string().describe("The greeting message"),
});

// Implement the tool logic
export async function run(data: z.infer<typeof input>) {
  const prefix = data.greeting ?? "Hello";
  return { message: `${prefix}, ${data.name}!` };
}

• "zod"からzをインポートします。Sandboxにプリインストールされています。
• inputとoutputをZodスキーマとしてエクスポートします。バリデーションとAPIのJSON Schema生成に使用されます。
• runをエントリーポイントとしてエクスポートします。検証済みの入力を受け取り、出力スキーマに一致するオブジェクトを返す必要があります。
• ToolSetのPackagesタブに登録されているパッケージをimportできます。
• 環境変数はprocess.env経由でアクセスできます。

​

Pythonでのツール作成

from pydantic import BaseModel, Field

class Input(BaseModel):
    name: str = Field(description="The user's name")
    greeting: str = Field(default="Hello", description="Custom greeting prefix")

class Output(BaseModel):
    message: str = Field(description="The greeting message")

def run(input: Input) -> Output:
    return Output(message=f"{input.greeting}, {input.name}!")

• InputとOutputをPydanticのBaseModelサブクラスとして定義します。
• runをエントリーポイントとして定義します。検証済みの入力を受け取り、Outputモデルのインスタンスを返す必要があります。
• ToolSetのPackagesタブに登録されているパッケージをimportできます。
• 環境変数はos.environ経由でアクセスできます。

​

入力・出力スキーマ

1. バリデーション — APIは実行前に入力を入力スキーマに対して検証します（必須フィールドとプロパティの型）。出力は検証されません。
2. ドキュメンテーション — スキーマはAPIおよびMCPエンドポイントを通じて公開され、AIエージェントがツールの期待する入出力を理解できるようにします。

​

メタデータの自動生成

• Name — コードから推定される人間が読みやすい名前。
• Slug — コードから導出されます。
• Description — ツールの機能の要約。

​

AI Copilot

Create a tool that posts a message to a Slack channel
Add a limit parameter to the input
Fix the error

• コードの生成・変更 — エージェントが実装を書いたり編集したりします。エージェントが編集ツールで行った変更はそのままエディタに反映されます。チャットに表示されたコードはApplyをクリックするとエディタに取り込まれ、ツールも保存されます。Copyはスニペットをコピーするだけです。
• 失敗したテストの修正 — 最新の実行結果（ステータス、入力、出力、エラー、stdout、stderr）はすべてのメッセージに添えて送られます。テストが失敗するとAuto Fix Errorボタンが表示され、その結果に基づいてエラーを修正するようエージェントに依頼できます。
• 実行とテスト入力の反映 — エージェントはツールを自分で実行でき、TestパネルのInputタブにテスト入力の提案を書き込めます（通常は実行が成功した後）。
• 会話 — 会話はツールごと・ユーザーごとに保存されます。パネルを開くと最新の会話が読み込まれ、ヘッダーには会話の選択、New conversation、Export conversationがあります。

​

APIパネル

• Organization Endpoint（POST .../v1/orgs/{orgId}/toolsets/{slug}/tools/{toolSlug}/run）と、ツールの入力スキーマから生成されたサンプル入力を含むコピー可能なcurl例。
• Public Endpoint（POST .../v1/public/{orgId}/{slug}/run/{toolSlug}）と、ToolSetが公開の場合はそのcurl例、非公開の場合はその旨の注記。
• 各実行が1クレジットを消費するという注記。

​

保存と削除

• 保存 — Saveボタンをクリックするか、Cmd/Ctrl + Sを押します。変更はドラフト状態に保存され、公開済みバージョンには影響しません。
• 削除 — ヘッダーのDeleteボタンをクリックします。確認ダイアログが表示されます。ツールを削除するとドラフト状態から削除されます。公開済みバージョンに含まれていた場合、それらのスナップショットは変更されません。

​

ベストプラクティス

• ツールを単機能に保つ。 各ツールは1つのことを適切に行うべきです。関連するツールをグループ化するにはToolSetを使用します。
• 分かりやすいスキーマを書く。 適切なフィールド説明は、AIエージェントがツールを正しく呼び出すのに役立ちます。
• 公開前にテストする。 新しいバージョンを公開する前に、テストパネルでさまざまな入力による動作を確認します。
• シークレットには環境変数を使用する。 APIキーやトークンをツールコードにハードコードしないでください。ToolSetのEnvironmentタブに保存します。
• 反復にCopilotを活用する。 テスト実行が失敗した後、Copilotはエラー出力にアクセスでき、的確な修正を提案できます。