mcpField
I
interactiveai

interactiveai

github.com/interactive-ai-labsエージェントワークフロー42 回インストール
リポジトリ

interactiveai について

InteractiveAIは、プラットフォームを扱う開発者向けのスキルです。ドキュメントとiaiコマンドラインを使い、アプリの計測、プロンプト移行、構造化プロンプト、リソース管理を案内します。

主な機能

  1. 01アプリ計測のガイダンス
  2. 02プロンプト移行ワークフロー
  3. 03構造化プロンプト対応
  4. 04プラットフォームリソース管理
  5. 05iaiコマンドラインの利用案内

活用シーン

  1. 01アプリへのInteractiveAI計測の導入
  2. 02コードベースのプロンプトをInteractiveAIへ移行
  3. 03構造化プロンプトの編集
  4. 04iaiによるプラットフォームリソースの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/interactive-ai-labs/skills --skill interactiveai

インストール後、Claude Code で/interactiveaiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cli.md
instrumentation.md
prompt-migration.md
structured-prompts.md

詳細

InteractiveAI

このスキルでは、アプリケーションへの計装、プロンプトの移行、プラットフォームリソースの管理、ドキュメントへのアクセスなど、一般的なワークフローで InteractiveAI を効果的に使う方法を説明します。

基本原則

InteractiveAI を使うすべての作業で、次の原則に従ってください。

  1. まずドキュメントを確認：記憶に頼って実装してはいけません。コードを書く前に、必ず最新のドキュメントを取得してください。下記のドキュメントのセクションを参照してください。
  2. まず CLI とスキーマを確認：InteractiveAI のリソースを変更する前に、iai --help、iai <command> --help、iai <command> <subcommand> --help を使って、コマンドの正確な形式を確認してください。構造化プロンプトでは、利用可能な場合は iai <type> schema を使ってください。
  3. ユースケースに応じたベストプラクティス：実装する前に、下記の該当するリファレンスファイルを確認してください。
  4. プロンプトの取得には常に latest を使用：プロンプトを読み取るときや、プロンプト取得を組み込むときは、ユーザーが別のラベルや固定バージョンを明示的に指定しない限り、latest バージョンを使用してください。
  5. 本番環境への変更には明示的な確認が必要：サービスやレプリカのスケーリング、またはプロンプトバージョンへの production ラベルの割り当ては、本番環境の動作を変更します。ユーザーから明示的な確認がない限り、どちらも実行しないでください。
  6. InteractiveAI の最新バージョンを使用：ユーザーが別途指定している場合、または別のバージョンを使う妥当な理由がある場合を除き、最新の InteractiveAI SDK と API バージョンを使用してください。

ユースケース別リファレンス

  • 既存の関数／アプリケーションへの計装：references/instrumentation.md
  • コードベースから InteractiveAI へのプロンプトの移行：references/prompt-migration.md
  • 構造化プロンプトタイプ（routine、policy、variable、glossary、macro）の操作：references/structured-prompts.md
  • iai CLI の使用に関するその他のヒント：references/cli.md

1. InteractiveAI CLI (iai)

iai CLI を使って、プラットフォームリソースを管理し、データを確認してください。npx ベースのツールとは異なり、iai はローカルにインストールする必要があります。

まず、利用可能かどうかを確認し、コマンドの形式を調べてください。

iai --help
iai <command> --help
iai <command> <subcommand> --help

構造化プロンプトを扱う場合は、利用可能であればタイプのスキーマも確認してください。

iai <type> schema

iai がインストールされていない場合は、最新バージョンをインストールしてください。

go install github.com/Interactive-AI-Labs/interactive-cli/cmd/iai@latest
export PATH=$PATH:$(go env GOPATH)/bin
認証情報

SDK または CLI を使用する前に、次の環境変数を設定してください。

export INTERACTIVEAI_PUBLIC_KEY=pk-lf-...
export INTERACTIVEAI_SECRET_KEY=sk-lf-...
export INTERACTIVEAI_HOST=https://app.interactive.ai
export INTERACTIVE_API_KEY=$INTERACTIVEAI_PUBLIC_KEY:$INTERACTIVEAI_SECRET_KEY

INTERACTIVEAI_HOST は必ず設定する必要があります。認証情報がない場合は、InteractiveAI Settings から API キーを取得するようユーザーに依頼してください。

ガードレール
  • 容量を変更する iai services または iai replicas コマンドを実行する前に、確認を求めてください。
  • プロンプトバージョンには自動的に latest が設定されます。ユーザーが新しいバージョンを今すぐ本番環境に反映することを明示的に確認しない限り、--labels production を追加しないでください。
  • タスクによって本番環境で現在使用中のバージョンが置き換わる場合は、作業を中断し、先に直接確認を求めてください。
CLI の詳細なリファレンス

一般的なワークフロー、認証の詳細、使用パターンについては、references/cli.md を参照してください。

2. InteractiveAI ドキュメント

InteractiveAI のドキュメントにアクセスする方法は、優先順に 2 つあります。利用可能な場合は、curl よりもネイティブのウェブ取得／検索ツールを常に優先してください。以下の URL パターンはどの取得方法でも使用できます。curl の例は参考用です。

2a. ドキュメントインデックス（llms.txt）

ドキュメントのインデックス全体を取得してください。

curl -s https://docs.interactive.ai/llms.txt

ここにはドキュメントのタイトルと相対パスが返されます。各パスの先頭に https://docs.interactive.ai を付けると、完全な URL になります。

または、https://docs.interactive.ai から目的のページに移動してください。

2b. 個別のページを Markdown として取得

llms.txt に記載されているページは、パスの末尾に .md を追加すると Markdown として取得できます。

curl -s "https://docs.interactive.ai/sdk/tracing.md"
curl -s "https://docs.interactive.ai/sdk/prompts.md"
curl -s "https://docs.interactive.ai/cli/iai.md"
ドキュメントを参照する手順
  1. llms.txt から始めて、該当するページを探してください。
  2. 関連するガイダンスの掲載先がわかったら、該当する Markdown ページを取得してください。

コメント

Markdown 対応