외부 에이전트 구성 예시
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
다음 예시를 사용하여 외부 에이전트 구성을 만드세요. 다음 에이전트는 GitLab과 통합되어 GitLab.com에서 사용할 수 있습니다.
히스토리
ai_flow_triggers라는 플래그와 함께 GitLab 18.3에서 도입됨. 기본적으로 활성화됨.- GitLab 18.8에서 GitLab Self-Managed 및 GitLab Dedicated에서 활성화됨.
다음 예시를 사용하여 외부 에이전트 구성을 만드세요. 이러한 예시에는 다음 변수가 포함됩니다:
AI_FLOW_CONTEXT: JSON 직렬화된 부모 객체, 포함 내용:- 머지 리퀘스트에서는 diff 및 댓글(한도까지)
- 이슈 또는 에픽에서는 댓글(한도까지)
$AI_FLOW_EVENT: 트리거 이벤트 유형(예:mention)$AI_FLOW_INPUT: 사용자가 머지 리퀘스트, 이슈 또는 에픽의 댓글로 입력하는 프롬프트
GitLab과 통합#
다음 에이전트는 GitLab과 통합되어 GitLab.com에서 사용할 수 있습니다.
Claude Code#
injectGatewayToken: true
image: node:22-slim
commands:
- echo "Installing claude"
- npm install -g @anthropic-ai/claude-code
- echo "Installing glab"
- apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/*
- curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash
- apt-get install -y glab
- mkdir -p ~/.config/glab-cli
- |
cat > ~/.config/glab-cli/config.yml < - chmod 600 ~/.config/glab-cli/config.yml
- echo "Configuring git"
- git config --global user.email "claudecode@gitlab.com"
- git config --global user.name "Claude Code"
- echo "Setting up git remote with authentication"
- git remote set-url origin https://gitlab-ci-token:$AI_FLOW_GITLAB_TOKEN@$AI_FLOW_GITLAB_HOSTNAME/$AI_FLOW_PROJECT_PATH.git
- export ANTHROPIC_AUTH_TOKEN=$AI_FLOW_AI_GATEWAY_TOKEN
- export ANTHROPIC_CUSTOM_HEADERS=$AI_FLOW_AI_GATEWAY_HEADERS
- export ANTHROPIC_BASE_URL="https://cloud.gitlab.com/ai/v1/proxy/anthropic"
- echo "Running claude"
- |
claude --allowedTools="Bash(glab:*),Bash(git:*)" --permission-mode acceptEdits --verbose --output-format stream-json -p "
You are an AI assistant helping with GitLab operations.
Context: $AI_FLOW_CONTEXT
Task: $AI_FLOW_INPUT
Event: $AI_FLOW_EVENT
Please execute the requested task using the available GitLab tools.
Be thorough in your analysis and provide clear explanations.
<important>
Use the glab CLI to access data from GitLab. The glab CLI has already been authenticated. You can run the corresponding commands.
When you complete your work create a new Git branch, if you aren't already working on a feature branch, with the format of 'feature/<short description of feature>' and check in/push code.
Lastly, after pushing the code, if a merge request doesn't already exist, create a new merge request for the branch and link it to the issue using:
glab mr create --title '<title>' --description '<desc>' --source-branch '<branch>'
If you are asked to summarize a merge request or issue, or asked to provide more information then please post back a note to the merge request / issue so that the user can see it.
$ADDITIONAL_INSTRUCTIONS
</important>
"
variables:
- ADDITIONAL_INSTRUCTIONS
OpenAI Codex#
image: node:22-slim
injectGatewayToken: true
commands:
- echo "Installing codex"
- npm install --global @openai/codex
- echo "Installing glab"
- export OPENAI_API_KEY=$AI_FLOW_AI_GATEWAY_TOKEN
- apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/*
- curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash
- apt-get install --yes glab
- mkdir -p ~/.config/glab-cli
- |
cat > ~/.config/glab-cli/config.yml < - chmod 600 ~/.config/glab-cli/config.yml
- echo "Configuring git"
- git config --global user.email "codex@gitlab.com"
- git config --global user.name "OpenAI Codex"
- echo "Setting up git remote with authentication"
- git remote set-url origin https://gitlab-ci-token:$AI_FLOW_GITLAB_TOKEN@$AI_FLOW_GITLAB_HOSTNAME/$AI_FLOW_PROJECT_PATH.git
- echo "Running Codex"
- |
# Parse AI_FLOW_AI_GATEWAY_HEADERS (newline-separated "Key: Value" pairs)
header_str="{"
first=true
while IFS= read -r line; do
# skip empty lines
[ -z "$line" ] && continue
key="${line%%:*}"
value="${line#*: }"
if [ "$first" = true ]; then
first=false
else
header_str+=", "
fi
header_str+="'$key' = '$value'"
done <<< "$AI_FLOW_AI_GATEWAY_HEADERS"
header_str+="}"
echo "Headers: $header_str"
codex exec \
--config 'model="gpt-5.1-codex"' \
--config 'model_provider="gitlab"' \
--config 'model_providers.gitlab.name="GitLab Managed Codex"' \
--config 'model_providers.gitlab.base_url="https://cloud.gitlab.com/ai/v1/proxy/openai/v1"' \
--config 'model_providers.gitlab.env_key="OPENAI_API_KEY"' \
--config 'model_providers.gitlab.wire_api="responses"' \
--config "model_providers.gitlab.http_headers=${header_str}" \
--config shell_environment_policy.ignore_default_excludes=true \
--dangerously-bypass-approvals-and-sandbox "
You are an AI assistant helping with GitLab operations.
Context: $AI_FLOW_CONTEXT
Task: $AI_FLOW_INPUT
Event: $AI_FLOW_EVENT
Please execute the requested task using the available GitLab tools.
Be thorough in your analysis and provide clear explanations.
<important>
Use the glab CLI to access data from GitLab. The glab CLI has already been authenticated. You can run the corresponding commands.
When you complete your work create a new Git branch, if you aren't already working on a feature branch, with the format of 'feature/<short description of feature>' and check in/push code.
Lastly, after pushing the code, if a merge request doesn't already exist, create a new merge request for the branch and link it to the issue using:
glab mr create --title '<title>' --description '<desc>' --source-branch '<branch>'
If you are asked to summarize a merge request or issue, or asked to provide more information then please post back a note to the merge request / issue so that the user can see it.
$ADDITIONAL_INSTRUCTIONS
</important>
"
variables:
- ADDITIONAL_INSTRUCTIONS
