> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof Cloud CLI > Failproof AI Cloud ile sorgulamak ve yönetmek için fp komut satırı arabiriminin tam başvurusu. Bulut telemetrisini incelemek ve denetimler, bulgular, sorunlar, uyarılar, anahtarlar, kullanıcılar, sorgular ve ayarları yönetmek için `fp` kullanın. Yerel kancalar, politikalar, yakalama ve makine kaydı için [`failproofai`](/tr/reference/failproof-cli) komutunu kullanın. Yayınlanan Bulut CLI'yi izole bir araç olarak yükleyin: ```bash theme={null} uv tool install fp-cli fp version ``` ## Oturum aç ```bash theme={null} fp login fp whoami ``` ## Söz dizimi ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` Global seçenekler komuttan önce gelmelidir: ```bash theme={null} fp --json sessions --since 24h ``` Terminal yardımı için `fp COMMAND --help` veya `fp COMMAND SUBCOMMAND --help` komutlarını çalıştırın. ## CLI komutları ### Kimlik doğrulama | Komut | Amaç | Seçenekler | | ------------ | ---------------------------------------------------------------------------- | ----------------------------------- | | `fp login` | E-posta ile gönderilen tek kullanımlık kod ile oturum açın ve kuruluş seçin. | `--email`, `-e`; `--org`; `--force` | | `fp logout` | Kaydedilen kullanıcı oturumunu iptal edin ve kaldırın. | — | | `fp whoami` | Geçerli kimliği, kimlik doğrulama modunu, kuruluşu ve izinleri gösterin. | — | | `fp version` | Yüklü CLI sürümünü gösterin. | — | | `fp help` | Üst düzey komut yardımını gösterin. | — | ```bash theme={null} fp login --email you@example.com --org reliability-team fp whoami ``` ### Olaylar ```text theme={null} fp events [OPTIONS] ``` Bireysel aracı olaylarını listeler. Varsayılan hafif akış ham yükleri hariç tutar; `--full` seçeneğini yalnızca sınırlı bir araştırma için kullanın. | Seçenek | Açıklama | | ----------------------------------------- | ----------------------------------------------------------------------------- | | `--limit`, `-n ` | Maksimum toplam satır. Varsayılan: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` veya `7d`. | | `--from ` / `--to ` | ISO 8601 UTC aralığı; `--since` seçeneğini geçersiz kılar. | | `--env ` | Ortam filtresi; değerleri tekrar edin veya virgülle ayırın. | | `--event-type ` | Olay türü filtresi; tekrar edin veya virgülle ayırın. | | `--agent-id ` | Aracı filtresi; tekrar edin veya virgülle ayırın. | | `--session-id ` | Oturum filtresi; tekrar edin veya virgülle ayırın. | | `--search ` | Yük metni araması; tekrarlanabilir, herhangi bir terim eşleşir. | | `--order asc\|desc` | Zaman sırası. Varsayılan: en yeniler önce. | | `--all` | `--limit` ile otomatik sayfalandırma. | | `--cursor ` | Opak imleyiciden devam edin. | | `--page-size ` | `--all` ile istek başına satır; maksimum `200`. | | `--full` | Daha ağır olay uç noktası aracılığıyla ham yükleri ekleyin. | | `--fields ` | Yalnızca seçilen alanları döndürün; `payload` istemek tam modu etkinleştirir. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### Oturumlar ```text theme={null} fp sessions [OPTIONS] ``` | Seçenek | Açıklama | | ----------------------------------------- | ----------------------------------------------------------------- | | `--limit`, `-n ` | Maksimum toplam satır. Varsayılan: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` veya `7d`. | | `--from ` / `--to ` | ISO 8601 UTC aralığı; `--since` seçeneğini geçersiz kılar. | | `--env ` | Ortam filtresi; tekrar edin veya virgülle ayırın. | | `--status ` | `done`, `error` veya `timeout`; tekrar edin veya virgülle ayırın. | | `--agent-id ` | Seçilen herhangi bir aracıyı içeren oturumları eşleştirin. | | `--session-id ` | Oturum filtresi; tekrar edin veya virgülle ayırın. | | `--all` | `--limit` ile otomatik sayfalandırma. | | `--cursor ` | Opak imleyiciden devam edin. | | `--page-size ` | `--all` ile istek başına satır; maksimum `200`. | | `--fields ` | Yalnızca seçilen alanları döndürün. | | `--full-ids` | Terminal çıktısında oturum kimliklerini kısaltmayın. | | `--agents` | Çoklu aracılı oturumlar için aracı listesini genişletin. | ### Değerlendirmeler ```text theme={null} fp evals [OPTIONS] ``` | Seçenek | Açıklama | | ------------------------------------------------- | ----------------------------------------------------------------------------------- | | `--aggregate` | Bireysel değerlendirmeler yerine toplamları ve puan başına istatistikleri gösterin. | | `--limit`, `-n ` | Maksimum liste satırları. Varsayılan: `50`. | | `--since`, `--from`, `--to` | Zaman aralığını seçin. | | `--env`, `--status`, `--agent-id`, `--session-id` | Filtre başına bir tam değere daraltın. | | `--score KEY:MIN..MAX` | Puan aralığı; tekrarlanabilir ve tüm aralıklar eşleşmelidir. | | `--all`, `--cursor`, `--page-size` | Liste sayfalandırmasını kontrol edin. | | `--fields ` | Yalnızca seçilen alanları döndürün. | | `--full-ids` | Tam oturum kimliklerini gösterin. | | `--scores-full` | Terminal çıktısında her puanı gösterin. | ### Hatalar ```text theme={null} fp errors [OPTIONS] ``` | Seçenek | Açıklama | | --------------------------------------------------------------------- | ------------------------------------------------------- | | `--aggregate` | Satırları listelemek yerine eşleşen hataları özetleyin. | | `--limit`, `-n ` | Maksimum liste satırları. Varsayılan: `50`. | | `--since`, `--from`, `--to` | Zaman aralığını seçin. | | `--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id` | Hata popülasyonunu daraltın. | | `--search ` | Yük metni araması; tekrarlanabilir. | | `--order asc\|desc` | Zaman sırası. | | `--all`, `--cursor`, `--page-size` | Liste sayfalandırmasını kontrol edin. | | `--fields ` | Yalnızca seçilen alanları döndürün. | | `--full-ids` | Tam oturum kimliklerini gösterin. | ### Kullanım ve filtre değerleri | Komut | Amaç | | ----------------------- | ------------------------------------------------ | | `fp usage` | Geçerli ölçüm penceresi için kullanımı gösterin. | | `fp list envs` | Gözlemlenen ortamları listeleyin. | | `fp list agents` | Gözlemlenen aracı kimliklerini listeleyin. | | `fp list event_types` | Olay türlerini listeleyin. | | `fp list score_filters` | Değerlendirme puan anahtarlarını listeleyin. | | `fp list models` | Model adlarını listeleyin. | | `fp list hooks` | Kanca adlarını listeleyin. | | `fp list tools` | Araç adlarını listeleyin. | | `fp list error_types` | Hata türlerini listeleyin. | ### Kuruluşlar | Komut | Amaç | | ----------------------- | ---------------------------------------- | | `fp orgs list` | Erişilebilir kuruluşları listeleyin. | | `fp orgs switch [SLUG]` | Etkin kuruluş kaydedin; atlanırsa sorar. | | `fp orgs current` | Etkin kuruluşu gösterin. | | `fp orgs perms` | Etkin kuruluştaki izinlerinizi gösterin. | ### API anahtarları | Komut | Amaç | Seçenekler | | ------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------ | | `fp keys list` | Kuruluş anahtarlarını listeleyin. | `--show-id`; `--fields ` | | `fp keys show NAME` | Bir anahtarı ve izinlerini gösterin. | — | | `fp keys create NAME` | Bir anahtar oluşturun ve gizli bilgisini bir kez ortaya çıkarın. | `--permission-set`; `--add`; `--remove` | | `fp keys update NAME` | İzin kümesini değiştirin veya izinleri ayarlayın. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp keys regenerate NAME` | Gizli bilgiyi döndürün ve değiştirileni bir kez ortaya çıkarın. | `--yes`, `-y` | | `fp keys disable NAME` | Bir anahtarı kalıcı olarak iptal edin. | `--yes`, `-y` | İzin tokenleri `resource:action` biçimini (örneğin `events:add`) kullanır. `--add` seçeneğini tekrarlayın, tokenleri virgülle ayırın veya `events:read.add` gibi noktalı eylemler kullanın. ### Sorgular | Komut | Amaç | Seçenekler | | ------------------------- | --------------------------------------------------------------- | ------------------------------------------------- | | `fp query list` | Kaydedilmiş sorguları listeleyin. | `--show-id`; `--fields ` | | `fp query show NAME` | Bir sorguyu gösterin. | — | | `fp query create NAME` | Bir sorgu kaydedin. | `--sql `; `--description` | | `fp query update NAME` | Bir sorguyu güncelleyin veya yeniden adlandırın. | `--name`; `--sql`; `--description`; `--yes`, `-y` | | `fp query delete NAME` | Kaydedilmiş bir sorguyu silin. | `--yes`, `-y` | | `fp query run [NAME]` | Kaydedilmiş bir sorguyu veya ad hoc SQL'i çalıştırın. | `--sql`; `--limit`; `--all`; `--arg`, `--param` | | `fp query schema [TABLE]` | Sorgulanabilir tabloları listeleyin veya bir tabloyu inceleyin. | — | ### Kullanıcılar | Komut | Amaç | Seçenekler | | ------------------------ | ------------------------------------ | ------------------------------------------------------ | | `fp users list` | Kuruluş üyelerini listeleyin. | `--active-only`; `--show-id` | | `fp users show EMAIL` | Bir üyeyi ve izinlerini gösterin. | — | | `fp users create EMAIL` | Bir üye ekleyin. | `--permission-set`; `--add`; `--remove` | | `fp users update EMAIL` | Bir üyenin izinlerini değiştirin. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp users disable EMAIL` | Oturum açmayı devre dışı bırakın. | `--yes`, `-y` | | `fp users enable EMAIL` | Oturum açmayı yeniden etkinleştirin. | `--yes`, `-y` | ### Ayarlar | Komut | Amaç | Seçenekler | | --------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `fp settings list` | Kuruluş ayarlarını ve geçerli değerleri listeleyin. | — | | `fp settings schema` | Kabul edilen değerleri ve açıklamaları gösterin. | — | | `fp settings set KEY` | Mevcut bir ayarı değiştirin. | `--value`, `--json-value`, `--file` seçeneklerinden tam olarak biri; isteğe bağlı `--yes`, `-y` | ### Uyarılar | Komut | Amaç | Seçenekler | | ----------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `fp alerts list` | Uyarı kurallarını listeleyin. | `--show-id` | | `fp alerts show NAME` | Bir uyarıyı gösterin. | — | | `fp alerts create NAME` | Bir uyarı oluşturun. | `--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window` | | `fp alerts update NAME` | Bir uyarıyı güncelleyin veya yeniden adlandırın. | oluşturma seçenekleri ile `--name`; `--yes`, `-y` | | `fp alerts delete NAME` | Bir uyarıyı silin. | `--yes`, `-y` | | `fp alerts test NAME` | Test bildirimini gönderin. | `--channels`; `--yes`, `-y` | Uyarı önem dereceleri `info`, `warning` ve `critical` olur. Tetikleme türleri `metric_threshold`, `custom_sql`, `evaluation_score`, `eval_compound` ve `per_event` dir. Değerlendirme aralıkları 30 ile 86.400 saniye arasında olmalıdır. ### Denetimler | Komut | Amaç | Seçenekler | | -------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | `fp audits list` | Denetimleri listeleyin. | `--enabled-only`; `--show-id` | | `fp audits show NAME` | Bir denetim tanımı ve durumunu gösterin. | — | | `fp audits create NAME` | Bir denetim oluşturun ve ilk çalıştırmasını hemen kuyruğa alın. | Bkz. [oluşturma seçenekleri](#audit-create-options). | | `fp audits edit NAME` | Denetim ayarlarını değiştirirken belirtilmemiş değerleri koruyun. | tanım seçeneklerini oluşturun; `--name`; `--yes`, `-y` | | `fp audits delete NAME` | Bir denetimi, bulgularını ve çalıştırma geçmişini silin. | `--yes`, `-y` | | `fp audits run NAME` | Manuel çalıştırma kuyruğu. | — | | `fp audits runs NAME` | Çalıştırma geçmişini listeleyin. | `--limit`, `-n`; `--show-id` | | `fp audits context-show NAME` | Özet ve referans URL getirme durumunu gösterin. | — | | `fp audits context-set NAME` | Özeti veya referans URL'lerini değiştirin. | `--text`; `--text-file`; `--url`; `--clear-urls` | | `fp audits context-refresh NAME` | Referans URL'lerini yeniden getirin. | — | | `fp audits findings` | Bulguları listeleyin. | `--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id` | | `fp audits finding FINDING_ID` | Bir bulguyu ve kanıtlarını gösterin. | — | | `fp audits ack FINDING_ID` | Bir bulguyu kabul edin. | `--reason` | | `fp audits mute FINDING_ID` | Yinelenen deseni bastırın. | `--reason`; `--yes`, `-y` | | `fp audits dismiss FINDING_ID` | Deseni işlem yapılabilir olmayan olarak işaretleyin ve bastırın. | `--reason`; `--yes`, `-y` | | `fp audits resolve FINDING_ID` | Bir bulguyu düzeltilmiş olarak işaretleyin ve gelecekteki bastırmayı yapılmayın. | `--yes`, `-y` | | `fp audits reopen FINDING_ID` | Bir bulguyu canlı kuyruğa döndürün ve bastırmayı temizleyin. | — | | `fp audits assign FINDING_ID` | Bulgu sahibini ayarlayın. | gerekli `--to ` | #### Denetim oluşturma seçenekleri ```bash theme={null} fp audits create checkout-reliability \ --description "Find checkout failures that agents do not recover from" \ --scope '{"environments":["production"],"agent_ids":["checkout-agent"]}' \ --schedule-interval-secs 86400 \ --window-mode since_last \ --sensitivity medium \ --text-file ./checkout-audit-brief.txt \ --url https://runbooks.example.com/checkout ``` | Seçenek | Açıklama | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `--file ` | Tanımı JSON'a dayandırın veya stdin için `-` kullanın. Açık bayraklar dosya değerlerini geçersiz kılar. | | `--description ` | Hata sorusunu veya amacı belirtin. | | `--enabled` / `--disabled` | Planlamayı açık veya kapalı başlatın. Varsayılan: etkin. | | `--schedule-interval-secs ` | `3600`–`604800`. Varsayılan: `86400`. | | `--schedule-anchor ` | ISO 8601 biçiminde sabit UTC aşaması. Varsayılan: sonraki 09:00 UTC. | | `--window-mode since_last\|fixed` | Son tam analiz edilen pencereden sonra devam edin veya tekrar tekrar haddeleme penceresini inceleyin. Varsayılan: `since_last`. | | `--lookback-window-secs ` | `3600`–`7776000`. Varsayılan: `604800`. | | `--scope ''` | `environments`, `agent_ids` veya diğer desteklenen kapsam alanlarına göre filtreleyin. | | `--ignore-error-type ` | Hata türlerini hariç tutun; tekrar edin veya virgülle ayırın. | | `--llm` / `--no-llm` | Aracı analizi etkinleştirin veya devre dışı bırakın. Varsayılan: etkin. | | `--top-k ` | `1`–`500` bulguyu tutun. Varsayılan: `50`. | | `--sensitivity low\|medium\|high` | Raporlama hassasiyetini ayarlayın. Varsayılan: `medium`. | | `--channels ''` | Bildirim kanalı dizisi. | | `--text ` | Satır içi özet, maksimum 8.192 karakter. | | `--text-file ` | Özeti bir dosyadan okuyun; `--text` ile karşılıklı olarak birbirini dışlar. | | `--url ` | Genel HTTPS referansı ekleyin; en fazla beş kez tekrarlayın. | İlk çalıştırmaya ihtiyacı olduğunda oluşturma sırasında bağlam ekleyin. Oluşturma tanımı ve bağlamı kuyruğa alınan çalıştırma başlamadan önce birlikte kaydeder. `fp audits run` asenkrondur. Bulgularını okumadan önce en son çalıştırmanın başarılı veya başarısız olmasını `fp audits runs NAME` ile yoklayın. ### Sorunlar | Komut | Amaç | Seçenekler | | ------------------------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- | | `fp issues list` | Sorunları listeleyin. | `--state`; `--alert-id`; `--limit`, `-n`; `--show-id` | | `fp issues count` | Açık veya seçilen sorun durumlarını sayın. | `--state` | | `fp issues show INCIDENT_ID` | Sorun ayrıntılarını, açıklamaları, abone üyeleri ve etkinliği gösterin. | — | | `fp issues open` | Manuel veya uyarıya bağlı sorun açın. | gerekli `--summary`; isteğe bağlı `--title`, `--alert-id`, `--severity` | | `fp issues ack INCIDENT_ID` | Bir sorunu kabul edin. | — | | `fp issues assign INCIDENT_ID` | Atanmışları değiştirin; temizlemek için seçeneği atlayın. | tekrarlanabilir `--assignee` | | `fp issues resolve INCIDENT_ID` | Bir sorunu çözün. | `--yes`, `-y` | | `fp issues comment-list INCIDENT_ID` | Açıklamaları listeleyin. | — | | `fp issues comment-add INCIDENT_ID` | Bir açıklama ekleyin. | `--body`, `--file` seçeneklerinden tam olarak biri | | `fp issues comment-delete INCIDENT_ID COMMENT_ID` | Bir açıklamayı silin. | `--yes`, `-y` | | `fp issues subscribers INCIDENT_ID` | Abone üyeleri listeleyin. | — | | `fp issues subscribe INCIDENT_ID` | Kendinizi veya başka bir operatörü abone yapın. | `--email` | | `fp issues unsubscribe INCIDENT_ID` | Abone üyeliğini kaldırın. | `--email` | Geçerli sorun durumları `firing`, `acknowledged` ve `resolved` dir. Bağımsız sorun önem dereceleri `info`, `warning` ve `critical` dir. ### Bulut yardımcısı | Komut | Amaç | Seçenekler | | ------------------------- | --------------------------------------------------------------------- | ------------------------------------- | | `fp agent health` | Yardımcı kullanılabilirliğini ve yapılandırmasını kontrol edin. | — | | `fp agent models` | Mevcut yardımcı modellerini listeleyin. | — | | `fp agent chats` | Kaydedilmiş sohbetleri listeleyin. | — | | `fp agent ask [MESSAGE]` | Bir sohbeti başlatın veya devam edin; ileti atlanırsa stdin'i okuyun. | `--chat`; `--model`; `--page-context` | | `fp agent show CHAT_ID` | Kaydedilmiş bir konuşmayı gösterin. | — | | `fp agent rename CHAT_ID` | Bir konuşmayı yeniden adlandırın. | gerekli `--title` | | `fp agent delete CHAT_ID` | Bir konuşmayı silin. | `--yes`, `-y` | ## Genel bayraklar | Bayrak | Açıklama | | ------------------------- | ----------------------------------------------------------------------- | | `--json` | Makine tarafından okunabilir JSON yayın. | | `--base-url ` | Kendi barındırılan veya geliştirme panosunu kullanın. | | `--org ` | Bu çalıştırma için bir kuruluş seçin. | | `--token ` | Kaydedilen kullanıcı oturumu tokenini geçersiz kılın. | | `--api-key ` | Otomasyon ile kimlik doğrulayın bir API anahtarı ile; asla kaydedilmez. | | `--timeout ` | HTTP zaman aşımı; pozitif olmalı. Varsayılan: `30`. | | `--quiet`, `-q` | stderr'de durum çıktısını bastırın. | | `--no-color` | Renkli çıktıyı devre dışı bırakın. | | `--insecure` / `--secure` | TLS sertifika doğrulamasını devre dışı bırakın veya geri yükleyin. | | `--version` | Kutulu sürümü yazdırın ve çıkın. | | `--help`, `-h` | Yardımı gösterin. | `--api-key` otomasyon için tasarlanmıştır. Oturum açma, kuruluş geçişi ve yardımcı komutları bir kullanıcı oturumu gerektirir. ## Ortam değişkenleri | Değişken | Eşdeğer veya amaç | | ------------------------------------------------- | -------------------------------------------------------- | | `AGENTEYE_DASHBOARD_URL` | `--base-url` | | `AGENTEYE_ORG` | `--org` | | `AGENTEYE_CLI_TOKEN` | `--token` | | `AGENTEYE_CLI_API_KEY` | `--api-key` | | `AGENTEYE_CLI_JSON` | `--json` | | `AGENTEYE_INSECURE` | `--insecure` | | `AGENTEYE_HOME` | Geçerli CLI yapılandırma dizinini yeniden konumlandırın. | | `AGENTEYE_ANALYTICS_DISABLED` veya `DO_NOT_TRACK` | Anonim CLI analitiğini devre dışı bırakın. | | `NO_COLOR` | Renkli çıktıyı devre dışı bırakın. | Açık bayraklar ortam değişkenlerini geçersiz kılar, ortam değişkenleri kaydedilen yapılandırmayı geçersiz kılar. API anahtarı modunda, kiracıyı `--org` veya `AGENTEYE_ORG` ile açıkça seçin. Yapılandırmayı silen, iptal eden, bastıran, çözen veya değiştiren komutlar varsayılan olarak sor. Etkin kuruluşu ve hedefi doğruladıktan sonra `--yes` kullanın.