Skip to main content

​
Devin

ShanoneのDevin連携は、Cognition社のDevin AIソフトウェアエンジニアを扱う38個のツールをエージェントに提供します。セッション、プレイブック、ナレッジノート、スケジュール、シークレット、PRレビュー、ファイル、セッションインサイトが対象です。

​
はじめに

1

APIキーと組織IDを取得する

DevinのSettings → Service Usersでサービスユーザーを作成し、APIキーと組織IDを取得します。
2

認証情報をShanoneに登録する

Shanoneダッシュボードの連携を開き、Devinを選択してAPIキーと組織IDの両方を入力します(両方が必須です)。
3

リクエストを再実行する

保存が完了すると、devin_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはDevin向けに38個のツールを、以下のカテゴリに整理して提供しています。
devin_list_sessions, devin_get_session, devin_create_session, devin_send_message, devin_update_session_tags, devin_terminate_session, devin_archive_session, devin_get_session_messages, devin_get_session_tags, devin_append_session_tags, devin_create_session_advanced
devin_list_knowledge_notes, devin_get_knowledge_note, devin_create_knowledge_note, devin_update_knowledge_note, devin_delete_knowledge_note, devin_list_knowledge_folders
devin_list_playbooks, devin_get_playbook, devin_create_playbook, devin_update_playbook, devin_delete_playbook
devin_list_schedules, devin_get_schedule, devin_create_schedule, devin_update_schedule, devin_delete_schedule
devin_upload_file, devin_get_session_files, devin_download_attachment
devin_get_session_insights, devin_generate_session_insights, devin_list_sessions_with_insights
devin_list_secrets, devin_create_secret, devin_delete_secret
devin_trigger_pr_review, devin_get_pr_review_status

​
よくあるユースケース

コーディングタスクの委任

タスク内容を指定してDevinセッションを作成し、進行中に補足指示を送る

再利用可能なプレイブック

繰り返し発生するワークフローをプレイブックとして定義し、以降のセッションで再利用する

PRレビューの自動化

新しいプルリクエストに対してDevinのPRレビューをトリガーし、マージ前にステータスを確認する

定期メンテナンス

Devinが定期的なメンテナンスや依存関係の更新を実行するスケジュールを設定する

​
トラブルシューティング

Devinのv3 APIでは、APIキーと組織IDの両方が必要です。連携ページで両方のフィールドが正しく保存されているか確認してください。APIキー単体では、どの組織のセッションを操作するのか解決できません。
メッセージはstatus_detailがwaiting_for_userのセッションにのみ送信できます。まずdevin_get_sessionで確認してください。Devinがまだworking状態の場合、メッセージはキューに入りますが、入力を受け付けられる状態になるまで処理されません。
devin_get_sessionでstatus: errorを確認し、devin_get_session_messagesを調べてください。多くの場合、タスク内容がアクセスできないリソース(組織のDevinインスタンスが接続されていないリポジトリなど)を参照していることが原因です。