5639606163
This pull request introduces the following changes: 1. **Exclude translated pages from search**: I explored ways to make the search plugin work with the i18n plugin, but it would require extensive custom JavaScript hacks. So for now, I’m holding off on this work. 2. **Switch from GPT-4.1 to o3 for even better translation quality**: While 4.1 performs well, o3 shows even greater quality for this task, and there’s no reason to avoid using it.
87 lines
No EOL
2.9 KiB
Markdown
87 lines
No EOL
2.9 KiB
Markdown
---
|
|
search:
|
|
exclude: true
|
|
---
|
|
# エージェントの可視化
|
|
|
|
エージェントの可視化を使用すると、 ** Graphviz ** を用いてエージェントとその関係を構造化されたグラフィカル表現として生成できます。これは、アプリケーション内でエージェント、ツール、handoffs がどのように相互作用するかを理解するのに役立ちます。
|
|
|
|
## インストール
|
|
|
|
オプションの `viz` 依存関係グループをインストールします:
|
|
|
|
```bash
|
|
pip install "openai-agents[viz]"
|
|
```
|
|
|
|
## グラフの生成
|
|
|
|
`draw_graph` 関数を使用してエージェントの可視化を生成できます。この関数は有向グラフを作成し、以下のように表現します。
|
|
|
|
- **エージェント** は黄色のボックスで表されます。
|
|
- **ツール** は緑色の楕円で表されます。
|
|
- **handoffs** はエージェント間の有向エッジで示されます。
|
|
|
|
### 使用例
|
|
|
|
```python
|
|
from agents import Agent, function_tool
|
|
from agents.extensions.visualization import draw_graph
|
|
|
|
@function_tool
|
|
def get_weather(city: str) -> str:
|
|
return f"The weather in {city} is sunny."
|
|
|
|
spanish_agent = Agent(
|
|
name="Spanish agent",
|
|
instructions="You only speak Spanish.",
|
|
)
|
|
|
|
english_agent = Agent(
|
|
name="English agent",
|
|
instructions="You only speak English",
|
|
)
|
|
|
|
triage_agent = Agent(
|
|
name="Triage agent",
|
|
instructions="Handoff to the appropriate agent based on the language of the request.",
|
|
handoffs=[spanish_agent, english_agent],
|
|
tools=[get_weather],
|
|
)
|
|
|
|
draw_graph(triage_agent)
|
|
```
|
|
|
|
|
|
|
|
これにより、 **triage agent** の構造と、それがサブエージェントやツールとどのようにつながっているかを視覚的に表すグラフが生成されます。
|
|
|
|
## 可視化の理解
|
|
|
|
生成されたグラフには次の要素が含まれます。
|
|
|
|
- エントリーポイントを示す **start node** (`__start__`)
|
|
- 黄色の塗りつぶしを持つ **矩形** のエージェント
|
|
- 緑色の塗りつぶしを持つ **楕円** のツール
|
|
- 相互作用を示す有向エッジ
|
|
- エージェント間の handoffs には **実線の矢印**
|
|
- ツール呼び出しには **破線の矢印**
|
|
- 実行が終了する位置を示す **end node** (`__end__`)
|
|
|
|
## グラフのカスタマイズ
|
|
|
|
### グラフの表示
|
|
デフォルトでは、`draw_graph` はグラフをインラインで表示します。別ウィンドウでグラフを表示するには、次のように記述します。
|
|
|
|
```python
|
|
draw_graph(triage_agent).view()
|
|
```
|
|
|
|
### グラフの保存
|
|
デフォルトでは、`draw_graph` はグラフをインラインで表示します。ファイルとして保存するには、ファイル名を指定します:
|
|
|
|
```python
|
|
draw_graph(triage_agent, filename="agent_graph.png")
|
|
```
|
|
|
|
これにより、作業ディレクトリに `agent_graph.png` が生成されます。 |