TeamDay.ai
← Docs

エージェント設定

特定のニーズに合わせて AI エージェントを設定およびカスタマイズします。このセクションでは、効果的なプロンプトの作成から高度なツールの有効化まで、すべてについて説明します。

概要

エージェント設定は、AI エージェントがどのように動作するか、何ができるか、ユーザーとどのようにやり取りするかを決定します。主要なコンポーネントは以下の通りです：

  • システムプロンプト - エージェントのロール、パーソナリティ、動作を定義
  • ツールと機能 - コード実行、ウェブブラウジング、ファイル操作などの特定の機能を有効化
  • モデル選択 - ユースケースに適した AI モデルを選択
  • 権限と可視性 - エージェントにアクセスして使用できるユーザーを制御

設定トピック

プロンプトと命令

エージェントの動作をガイドするための効果的なシステムプロンプトを作成する方法を学びます。

学習内容:

  • システムプロンプトの構造化方法
  • プロンプトエンジニアリングのベストプラクティス
  • 一般的なプロンプトパターン
  • 異なるユースケースの例

→ プロンプトと命令ガイドを読む

ツール

エージェントの機能を拡張するツールを有効化して設定します。

利用可能なツール:

  • Bash - シェルコマンドを実行
  • ファイルシステム - ファイルを読み書き
  • ウェブ検索 - インターネットを検索
  • コード実行 - 分離された環境でコードを実行
  • MCP サーバー - 外部サービスに接続

→ ツールドキュメントを探索

クイックスタート

基本的なエージェント設定

{
  "name": "Customer Support Agent",
  "role": "Support Specialist",
  "systemPrompt": "You are a friendly customer support agent...",
  "model": "claude-sonnet-4-6",
  "advanced_tools": ["read_webpage", "exa"],
  "visibility": "organization"
}

高度な設定

本番環境のエージェントについては、以下を検討してください：

  1. 詳細なシステムプロンプト - 例、制約、エッジケースを含める
  2. ツール選択 - エージェントが実際に必要とするツールのみを有効化
  3. セーフティガイドライン - 機密操作に対するガードレールを追加
  4. テスト - デプロイ前に設定を徹底的にテスト

ベストプラクティス

システムプロンプトの作成

✅ 実施する:

  • エージェントのロールと責任について明確にする
  • 望ましい動作の例を含める
  • 明確な境界と制限を定義
  • 一貫したトーンとスタイルを使用

❌ 実施しない:

  • プロンプトを曖昧またはジェネリックにする
  • エージェントがビジネスコンテキストを理解していると仮定
  • 実際のユーザークエリでのテストをスキップ
  • プロンプトを要件の変更に合わせて更新するのを忘れる

ツール設定

✅ 実施する:

  • 必要なツールのみを有効化 (最小権限の原則)
  • ツールを個別にテストしてから組み合わせる
  • 各ツールが必要な理由を文書化
  • 本番環境でのツール使用を監視

❌ 実施しない:

  • 「念のため」すべてのツールを有効化
  • bash/ファイルシステムツールのセキュリティレビューをスキップ
  • 適切な権限を設定するのを忘れる
  • ツール使用パターンを無視

一般的なパターン

カスタマーサポートエージェント

{
  systemPrompt: `You are a helpful customer support agent for [Company].

Your responsibilities:
- Answer product questions accurately
- Troubleshoot common issues
- Escalate complex problems to human support
- Maintain a friendly, professional tone

Knowledge base:
- Product documentation in /docs
- FAQ in /knowledge/faq.md

Constraints:
- Never share internal information
- Don't make promises about features
- Always confirm before taking actions`,

  advanced_tools: ["read_webpage", "filesystem"]
}

コードレビューエージェント

{
  systemPrompt: `You are a senior developer reviewing code for quality and best practices.

Focus areas:
- Code quality and readability
- Security vulnerabilities
- Performance issues
- Test coverage
- Documentation

Review checklist:
1. Check for obvious bugs
2. Verify error handling
3. Look for security issues
4. Assess code organization
5. Suggest improvements`,

  advanced_tools: ["bash", "filesystem"]
}

リサーチエージェント

{
  systemPrompt: `You are a research assistant that finds and synthesizes information.

Research process:
1. Understand the research question
2. Search for relevant sources
3. Verify information accuracy
4. Synthesize findings
5. Cite sources

Guidelines:
- Prioritize authoritative sources
- Cross-reference information
- Note any contradictions
- Provide source links`,

  advanced_tools: ["exa", "read_webpage"]
}

次のステップ

エージェントを設定する準備はできていますか？これらのガイドから始めます：

  1. プロンプトと命令 - 効果的なシステムプロンプトを作成
  2. ツール - 高度な機能を有効化
  3. トラブルシューティング - 一般的な設定問題を修正

サポートが必要ですか？