よくある質問
最初の1週間で出てくる質問。
ご質問はありますか?エージェントに聞いてみましょう
Letaido ができることについて質問がある場合、エラーが発生した場合、または何かの動作がわからない場合は、チャットでエージェントに直接尋ねるのが最も早い方法です。エージェントは自身のドキュメントを読み、ワークスペースを確認し、設定をチェックし、同じ場所で見えているものを案内してくれます。
以下の FAQ では、最もよく寄せられる質問を取り上げています。お探しの質問がここにない場合は、エージェントにお尋ねください。追加する価値があると判断された場合、エージェントが FAQ への追加を提案します。
基本
チャット間で記憶されますか?
はい、ただし記憶するように指示した内容のみです。各チャットの開始時に ~/workspace/.memory.md を読み込みます。「remember this: X」と言うと追記されます。変更ログ(progress.md)も読み込まれるため、最近構築された内容を把握しています。
作成されたものをロールバックできますか?
ファイルは簡単です。「過去1時間に変更した内容を見せて、Xを元に戻して」と依頼するだけです。データベースの変更は自動的には元に戻りませんが、すべてのアクションがログに記録されるため、元に戻すことは通常明確な会話で行えます。破壊的な変更(テーブルの削除、スキルの削除など)については、エージェントが実行前に確認を求めます。
複数の人がワークスペースを共有できますか?
はい。役割は、オーナー、管理者、メンバー、閲覧者です。オーナーと管理者は承認カードを決定し、シークレットを管理し、公開サイトを切り替えます。メンバーはチャットを行い、コンソールページを使用します。閲覧者は読み取り専用です。
私が入力した内容は第三者に送信されますか?
エージェントは、ローカルプロキシを介して LLM プロバイダーを通じて推論を行います。メッセージは推論のために送信され、出力が返されます。モデルプロバイダー自身のポリシーに記載されている内容を超えるデータ保持はありません。他のワークスペースとは何も共有されません。
外部 API が失敗した場合はどうなりますか?
エージェントは失敗を報告し(ステータスコード、コネクタが公開している場合はエラーカテゴリ)、停止して指示を待ちます。予算が爆発するまで再試行することはありません。
物を作る
Console アプリの構築にはどのくらいの時間がかかりますか?
シンプルなもの(1つのフォーム、1つのクエリ、1つの結果)は数分で完成します。複雑なもの(複数ステップのパイプライン、サードパーティ統合、カスタム可視化)は、チャットセッション1回、場合によっては2回かかります。エージェントは、複数回のやり取りが必要になると予想される場合、その旨を伝えます。
顧客と何かを共有するにはどうすればよいですか?
公開サイトで構築し、URL を取得して、サイトモードを open または authorized に切り替え、リンクを共有します。知っておくべきパターン:トークンゲート型レポート(/<route>/<token>)、公開ドキュメント(このサイト)、リードキャプチャページ。
エージェントは、これまで構築したことのないものを構築できますか?
はい、プリミティブが存在する限り(Console ブループリント、サイトルート、cron ジョブ、webhook、コネクタ)、それらを組み合わせます。プリミティブが存在しない場合(新しいプラットフォーム機能が必要な場合)、偽装するのではなく、明確に伝えます。
必要なサービスのコネクタがない場合はどうすればよいですか?
サポートに連絡して、そのアプリ用の新しいコネクタの追加をリクエストしてください。新しいコネクタは、お客様からのリクエストに基づいて定期的に追加されています。それまでの間、エージェントは通常、汎用 API キー、ドメイン許可リスト、生の HTTP にフォールバックできますが、適切なコネクタが常に推奨されます(型付き入力、ログ記録、スコープ付き認証情報、サーフェスごとの承認が標準で提供されます)。
メモリー、スキル、音声
エージェントが当社のブランドボイスを使用するようにするにはどうすればよいですか?
ワークスペースにブランドボイススキルがあります。エージェントは、コピーを書いたりレビューしたりする際にそれを読み取ります。新しいルールを追加するには:「ブランドボイススキルを更新して追加:
なぜ em ダッシュを使わないと言うのですか?
このワークスペースが採用しているハウススタイルの選択です。このルールはメモリとブランドボイススキルに記録されているため、すべての下書き(およびこれらのドキュメント)ではセミコロンを避けています。カンマ、コロン、ピリオド、または括弧で置き換えてください。
すべてをメモリに入れるべきですか?
メモリは、エージェントのデフォルトを変更するものに使用します。つまり、あなたが誰であるか、どのように書くか、長期的に何を重視するかといったことです。ワークフローのルール(「私たちの標準的なローンチチェックリストは X です」など)には、スキルの方が適しています。一時的なコンテキスト(「この顧客は価格設定に敏感です」など)については、チャットで伝えてください。
公開サイト、ドキュメント、週刊ダイジェスト
このドキュメントはどのように更新されますか?
ソースとなるマークダウンは ~/workspace/docs/*.md に保存されています。メンテナーが手動で編集します。同期ジョブ(30 分ごと)がマークダウンをデータベースにレンダリングします。公開サイトはデータベースから読み取ります。
ウィークリーダイジェストとは何ですか?
ヨーロッパ/ブカレスト時間の毎週月曜日10:00に実行されるスケジュールジョブです。前回のダイジェスト以降のエージェントのメモリ、変更ログ、スキルフォルダの差分を取得し、LLM に顧客が知るべき変更内容を尋ね、提案されたドキュメント編集を Slack でメンテナーに送信します。メンテナーがレビューし、ドキュメントが更新されます。
提案を自動公開しないのはなぜですか?
2つの理由があります。(1) LLMが提案する編集は微妙に間違っている可能性があり、ドキュメントは製品の公の顔です。(2) 人間によるレビューは、声のトーンを一貫させ、正しく見えても実際には正しくないものを見つけます。
ドキュメントの問題を報告するにはどうすればよいですか?
チャットでエージェントに伝えてください。ワークスペースにメモが開かれ、次の週次ダイジェストでドキュメント管理者に表示されます。
承認、シークレット、資金
なぜ承認を求められ続けるのですか?
アクションにはコストがかかったり、ネットワークにアクセスしたり、認証情報に触れたりするためです。それぞれがログに記録されます。「承認カードが多すぎる」問題の解決策は、通常、リクエストをバッチ処理することです。エージェントにフロー全体を最初に計画させることで、すべてのスコープと承認を一度にリクエストできるようにします。
設定されている認証情報を確認できますか?
はい、ワークスペース UI から確認できます。シークレット名、タイプ、ステータス、およびどのコネクタとサーフェスに付与されているかを確認できます。シークレットの値は確認できません。エージェントを含め、誰も確認できません。
エージェントの支出にレート制限をかけることはできますか?
このプラットフォームは、LLM トークンとコネクタ呼び出しを計測します。継続的なコスト管理には、ジョブが適切な手段です(明示的な定期支出であるため)。アドホックチャットの支出は、リクエストした内容に応じて変動します。ジョブが正常に動作していない場合は、「ジョブ」タブから一時停止してください。
トラブルシューティング
公開サイトの URL が 403 を返します。
サイトモードは off です。公開サイトタブから authorized(メンバーのみ)または open(誰でも)に切り替えてください。
Console ページの読み込みが終わらない。
ページが長時間の外部呼び出しを行っているか(nginx のタイムアウトは 30 秒です。長時間の処理には job-id-then-poll パターンを使用する必要があります)、または Flask プロセスがクラッシュしています。/home/console/http/data/.tail.log でログの末尾を確認してください。
コネクタ呼び出しが approval_pending または not_approved を返します。
その(コネクタ、シークレット、サーフェス)の組み合わせは初めてです。カードを承認してください。Console またはサイトサーフェスの場合、オーナーまたは管理者がチャットサーフェスとは別に request_connector_approval をクリックします。
ジョブが予想通りに実行されませんでした。
Cron の時刻はホスト上で UTC です。ジョブが「ブカレスト時間で毎週月曜日午前 9 時」の場合、スケジュール行は 0 7 * * 1(夏時間)または 0 8 * * 1(冬時間)になります。エージェントは通常、どちらか一方を選択し、スクリプト内に zoneinfo ガードを追加して夏時間に対応します。次回実行時刻については、Jobs タブで確認してください。
トリガーが起動しません。
サブスクリプションリストを確認してください。paused または revoked と表示されている場合は、再度サブスクライブしてください。active と表示されているがイベントがない場合は、サードパーティアプリの設定を確認してください(サブスクリプション URL は相手側でも設定する必要があります)。
ワークスペースが遅く感じます。
長いチャットセッションは劣化します。新しいチャットを開始してください。メモリと進行状況により、重要なコンテキストが引き継がれます。