ワークフローのハンドオフ

shape: sequence_diagram

User: {
  shape: c4-person
}

AIGNE-Framework: {
  label: "AIGNE フレームワーク"
}

Agent-A: {
  label: "Agent A\n(汎用)"
}

Agent-B: {
  label: "Agent B\n(俳句専門)"
}

User -> AIGNE-Framework: "1. 'transfer to agent b'"
AIGNE-Framework -> Agent-A: "2. 入力で呼び出す"
Agent-A -> Agent-A: "3. スキル実行: transfer_to_b()"
Agent-A -> AIGNE-Framework: "4. Agent B オブジェクトを返す"
AIGNE-Framework -> AIGNE-Framework: "5. ハンドオフ: Agent A を B に置き換える"
AIGNE-Framework -> Agent-B: "6. 応答のために Agent B を呼び出す"
Agent-B -> AIGNE-Framework: "7. 俳句の応答を生成"
AIGNE-Framework -> User: "8. Agent B の応答を表示"

User -> AIGNE-Framework: "9. 'It's a beautiful day'"
AIGNE-Framework -> Agent-B: "10. 新しい入力で呼び出す"
Agent-B -> AIGNE-Framework: "11. 別の俳句を生成"
AIGNE-Framework -> User: "12. Agent B の応答を表示"

npx -y @aigne/example-workflow-handoff

npx -y @aigne/example-workflow-handoff --interactive

echo "transfer to agent b" | npx -y @aigne/example-workflow-handoff

import { AIAgent, AIGNE } from "@aigne/core";
import { OpenAIChatModel } from "@aigne/core/models/openai-chat-model.js";

const { OPENAI_API_KEY } = process.env;

// 1. AI モデルを初期化する
const model = new OpenAIChatModel({
  apiKey: OPENAI_API_KEY,
});

// 2. ハンドオフを実行するスキルを定義する
function transfer_to_b() {
  return agentB;
}

// 3. ハンドオフスキルを持つ Agent A を定義する
const agentA = AIAgent.from({
  name: "AgentA",
  instructions: "You are a helpful agent.",
  outputKey: "A",
  skills: [transfer_to_b],
});

// 4. 専門家である Agent B を定義する
const agentB = AIAgent.from({
  name: "AgentB",
  instructions: "Only speak in Haikus.",
  outputKey: "B",
});

// 5. AIGNE ランタイムを初期化する
const aigne = new AIGNE({ model });

// 6. Agent A でセッションを開始する
const userAgent = aigne.invoke(agentA);

// 7. 最初の呼び出し：ハンドオフをトリガーする
const result1 = await userAgent.invoke("transfer to agent b");
console.log(result1);
// 期待される出力:
// {
//   B: "Transfer now complete,  \nAgent B is here to help.  \nWhat do you need, friend?",
// }

// 8. 2回目の呼び出し：今度は Agent B と対話する
const result2 = await userAgent.invoke("It's a beautiful day");
console.log(result2);
// 期待される出力:
// {
//   B: "Sunshine warms the earth,  \nGentle breeze whispers softly,  \nNature sings with joy.  ",
// }

git clone https://github.com/AIGNE-io/aigne-framework

cd aigne-framework/examples/workflow-handoff
pnpm install

pnpm start

pnpm start -- --interactive

aigne observe