Agent SDK をはじめる

このガイドでは、Code Repositories で TypeScript エージェントを作成し、そのエージェントを公開して、Agent Manager でエージェントとのセッションを実行する方法を説明します。

エージェントリポジトリを作成する

任意のプロジェクトに移動し、+ 新規 > エージェント > コードで構築を選択して、新しいエージェントを作成します。

エージェント定義を格納するコードリポジトリと、公開するエージェント自体の両方に名前を入力する必要があります。

エージェントをオントロジーにバインドすることは任意ですが、バインドすると、オントロジーおよびプラットフォーム SDK を通じてコード内でエージェントを使用できます。エージェントのAPI名は、オントロジー内で一意である必要があります。

エージェントを記述する

コードリポジトリは、はじめるのに適したサンプルエージェントを含む状態でセットアップされています。Anthropic モデルの場合、typescript-functions/src/agents/myAgent.ts にある定義は、次の抜粋のようになります。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
export default defineAgent({
    // 公開用メタデータ
    locator: Aliases.custom("myAgent"),
    apiName: "myNewAgent", // エージェントがオントロジーにバインドされている場合に存在します。
    // 基本設定
    model: anthropic({
        modelRid: Aliases.model("model").rid,
        modelSettings: { max_tokens: 4096 },
    }),
    tools: () => [WeatherTool],
    // 詳細設定
    agentStateSchema: AgentStateSchema,
    createSessionArgsSchema: z.object({}),
    createSession: () => ({ agentState: {} }),
    contextItemDefinitions: [WeatherResult],
});

生成されたファイルでは、この定義の前に API をインポートし、AgentStateSchema、WeatherResult、WeatherTool を定義しています。モデルのコンストラクターとエイリアスには、セットアップ時に選択したモデルが反映されています。

また、選択した Compass フォルダーには、このエージェントに対応する新しいエージェントリソースが作成されているはずです。現時点では、公開済みのバージョンはありません。

コミットして公開する

コードリポジトリで変更をコミットします。エージェントのチェックを表示するには、ページ上部のチェックタブを開きます。コミット後、このタブに実行中のチェックが表示されるはずです。

作業をコミットしたら、エージェントを公開するためにタグタブに移動します。このタブでは、エージェントの公開に使用するセマンティックバージョンを選択できます。

エージェントが正常に公開されると、Agent Manager で開くことができます。

セッションを実行する

公開済みのエージェントを Agent Manager で開き、セッションをはじめて質問を送信します。レスポンスと、セッションのメッセージ、イベント、コンテキスト項目を確認します。

次のステップ

• エージェントが有用な作業を行えるようにするためのエージェントのカスタマイズ方法を学べます。
• Agent SDK でエージェントを細かくカスタマイズする方法をさらに詳しく知るには、高度なカスタマイズをご覧ください。