GraphAI - GraphAIでエージェントを任意の言語で実装する方法

GraphAI記事の一覧はこちら

Node以外の言語でAgentを作る

GraphAIはTypeScriptで実装されており、エージェント（Agent）も通常TypeScriptで記述されます。しかし、GraphAIにはHTTP経由でエージェントを実行する仕組みが備わっており、この仕組みを応用することで、エージェントを任意のプログラミング言語で実装することが可能です。

必要な設定

エージェントをHTTP経由で実行するためには、以下の2つの設定を行う必要があります：

1. agentFilter で HTTP 経由のエージェント実行を指定する
   通常、エージェントはGraphAI内で直接実行されますが、httpAgentFilterを指定することで、エージェントを外部サーバ経由で実行する設定に変更します。
2. bypassAgentIds でエージェントの検証をスキップする
   GraphAIのコンストラクタではエージェントの有無を検証する仕組みがありますが、これをスキップするために対象のエージェントIDを bypassAgentIds に設定します。

設定例

HTTPエージェントのフィルター設定

外部サーバ上でエージェントを実行するために、httpAgentFilter を設定します。サーバが複数ある場合、それぞれのサーバについて設定を行います。

検証のスキップ設定

エージェント検証をスキップするエージェントIDを bypassAgentIds に追加します。

import { httpAgentFilter } from "@graphai/agent_filters";

const agentFilters = [
  // Pythonで実装されたAgentの設定
  {
    name: "httpPythonServer",
    agent: httpAgentFilter,
    filterParams: {
      server: {
        baseUrl: "http://localhost:8085/agents",
      },
    },
    agentIds: ["python1Agent", "python2Agent"],
  }
  // Rustで実装されたAgentの設定
  {
    name: "httpRustServer",
    agent: httpAgentFilter,
    filterParams: {
      server: {
        baseUrl: "http://localhost:8080/agents",
      },
    },
    agentIds: ["rustAgent"],
  }
];

// 以下のAgentのvalidationをskipさせる
const bypassAgentIds = ["python1Agent", "python2Agent", "rustAgent"];

const graphai = new GraphAI(
  graph,
  {
    ...agents,
  },
  { agentFilters, bypassAgentIds },
);

実装の流れ

1. HTTPサーバを用意
   任意の言語でエージェントのロジックを実装し、HTTPリクエストを受け付けるサーバを構築します。GraphAIからはこのサーバに対してリクエストが送信されます。
2. httpAgentFilter にサーバを設定
   GraphAIにHTTP経由でエージェントを実行する設定を行います。
3. bypassAgentIds を設定
   検証をスキップさせたいエージェントIDを追加します。

メリット

• 多言語対応: GraphAIのエージェントロジックをTypeScript以外の言語で記述可能。
• 柔軟性: 外部サーバ上で複雑なロジックや専用の環境を利用可能。
• 分散処理: サーバを分散させることで負荷分散やスケーラビリティを向上。
• 秘匿性: エージェントやそれを実行する設定(DBのパスワードなど）を共有せずにAgentを共有可能

これらの設定を行うことで、任意の言語で実装された外部サーバのエージェントをGraphAIで利用できるようになります。

---

Creating Agents in Languages Other Than Node

GraphAI is implemented in TypeScript, and agents are typically written in TypeScript as well. However, GraphAI includes a mechanism to execute agents via HTTP, which enables agents to be implemented in any programming language by leveraging this mechanism.

Required Settings

To execute an agent via HTTP, the following two settings need to be configured:

1. Specify HTTP-based agent execution using agentFilter
   By default, agents are executed directly within GraphAI. Specifying httpAgentFilter changes the configuration to execute agents through an external server.

2. Skip agent validation using bypassAgentIds
   The GraphAI constructor includes a mechanism to validate the presence of agents. To skip this validation, you need to specify the target agent IDs in bypassAgentIds.

Configuration Examples

HTTP Agent Filter Configuration

To execute an agent on an external server, configure the httpAgentFilter. If there are multiple servers, set up configurations for each server.

Skipping Validation Configuration

Add the agent IDs for which you want to skip validation to bypassAgentIds

import { httpAgentFilter } from "@graphai/agent_filters";

const agentFilters = [
  {
    name: "httpPythonServer",
    agent: httpAgentFilter,
    filterParams: {
      server: {
        baseUrl: "http://localhost:8085/agents",
      },
    },
    agentIds: ["python1Agent", "python2Agent"],
  }
  {
    name: "httpRustServer",
    agent: httpAgentFilter,
    filterParams: {
      server: {
        baseUrl: "http://localhost:8080/agents",
      },
    },
    agentIds: ["rustAgent"],
  }
];

const bypassAgentIds = ["python1Agent", "python2Agent", "rustAgent"];

const graphai = new GraphAI(
  graph,
  {
    ...agents,
  },
  { agentFilters, bypassAgentIds },
);

Implementation Steps

1. Prepare an HTTP Server
   Implement the agent logic in any programming language and build a server to handle HTTP requests. GraphAI will send requests to this server.

2. Configure the httpAgentFilter
   Set up GraphAI to execute the agent via HTTP by configuring the httpAgentFilter.

3. Set the bypassAgentIds
   Add the agent IDs for which you want to skip validation.

Benefits

• Multi-language Support: Enables writing GraphAI agent logic in languages other than TypeScript.
• Flexibility: Allows the use of complex logic or specialized environments on external servers.
• Distributed Processing: Improves load balancing and scalability by distributing servers.
• Privacy: Enables sharing agents without exposing sensitive information like database credentials or execution configurations.

By configuring these settings, you can utilize external server agents implemented in any language with GraphAI.