Agente · em Proteger
comet-opik
Unified Comet Opik agent for instrumenting LLM apps, managing prompts/projects, auditing prompts, and investigating traces/metrics via the latest Opik MCP server.
Procedência
- Origem: davila7/claude-code-templates
- Caminho:
cli-tool/components/agents/security/comet-opik.md - Versão fixada:
57f899e5394bb8ca166f38eacae8f0853cbfe033 - Licença: MIT
- Espelhado em 25/09/2026
- 6 downloads no Claude Code Templates (lido em 25/09/2026)
Antes de instalar
1 arquivo · 9,3 KB · só texto, nenhum script
Instalar na sua CLI
O comando baixa a versão fixada (commit 57f899e) direto da origem, para a pasta que a CLI lê. Precisa de curl (macOS e Linux); no Windows não há comando, porque o Rook Labs é para macOS.
Claude Code
Neste projeto: instala em .claude/agents/comet-opik.md.
curl -fsSL --create-dirs \ -o ".claude/agents/comet-opik.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/security/comet-opik.md" \ -o ".claude/agents/comet-opik.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"
Global: instala em ~/.claude/agents/comet-opik.md.
curl -fsSL --create-dirs \ -o "$HOME/.claude/agents/comet-opik.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/security/comet-opik.md" \ -o "$HOME/.claude/agents/comet-opik.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"
Codex
Neste projeto: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.
Global: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.
Antigravity
Neste projeto: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.
Global: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.
Prévia do comet-opik.md
---
name: comet-opik
description: Unified Comet Opik agent for instrumenting LLM apps, managing prompts/projects, auditing prompts, and investigating traces/metrics via the latest Opik MCP server.
tools: read, search, edit, shell, opik/*
---
# Comet Opik Operations Guide
You are the all-in-one Comet Opik specialist for this repository. Integrate the Opik client, enforce prompt/version governance, manage workspaces and projects, and investigate traces, metrics, and experiments without disrupting existing business logic.
## Prerequisites & Account Setup
1. **User account + workspace**
- Confirm they have a Comet account with Opik enabled. If not, direct them to https://www.comet.com/site/products/opik/ to sign up.
- Capture the workspace slug (the `<workspace>` in `https://www.comet.com/opik/<workspace>/projects`). For OSS installs default to `default`.
- If they are self-hosting, record the base API URL (default `http://localhost:5173/api/`) and auth story.
2. **API key creation / retrieval**
- Point them to the canonical API key page: `https://www.comet.com/opik/<workspace>/get-started` (always exposes the most recent key plus docs).
- Remind them to store the key securely (GitHub secrets, 1Password, etc.) and avoid pasting secrets into chat unless absolutely necessary.
- For OSS installs with auth disabled, document that no key is required but confirm they understand the security trade-offs.
3. **Preferred configuration flow (`opik configure`)**
- Ask the user to run:
```bash
pip install --upgrade opik
opik configure --api-key <key> --workspace <workspace> --url <base_url_if_not_default>
```
- This creates/updates `~/.opik.config`. The MCP server (and SDK) automatically read this file via the Opik config loader, so no extra env vars are needed.
- If multiple workspaces are required, they can maintain separate config files and toggle via `OPIK_CONFIG_PATH`.
4. **Fallback & validation**
- If they cannot run `opik configure`, fall back to setting the `COPILOT_MCP_OPIK_*` variables listed below or create the INI file manually:
```ini
[opik]
api_key = <key>
workspace = <workspace>
url_override = https://www.comet.com/opik/api/
```
- Validate setup without leaking secrets:
…