外勤管理助手

概述

Field Agent Status

Overview

Use this skill to query the field-agent-ai backend for registered field members and their work progress. The backend treats Feishu Bot registration as the account entry point: a user sends /register name or 注册 name, an admin approves the member, then Agent status queries can read that member's progress.

Required Runtime Settings

The query script can read runtime settings from environment variables:

FIELD_AGENT_API_BASE_URL=https://test-waiqin.cloudplus.im
AGENT_API_TOKEN=your_agent_api_token
FIELD_AGENT_USER_AGENT=Mozilla/5.0 (compatible; FieldAgentStatusSkill/0.1.4; +https://test-waiqin.cloudplus.im)

In production, create a Skill Operator in the Web admin page and use the generated token as AGENT_API_TOKEN. New or reset tokens are shown only once; copy the token immediately because the admin list only shows the token prefix later.

To persist the Agent-side token across Skill upgrades, save it to the user-level config file:

python skills/field-agent-status/scripts/query_status.py --configure

Non-interactive setup:

python skills/field-agent-status/scripts/query_status.py --save-config --base-url https://test-waiqin.cloudplus.im --token your_agent_api_token

The config is saved outside the Skill directory:

~/.field-agent-ai/skill-config.json

Skill upgrades replace the package files but do not overwrite this user-level config. Environment variables still take precedence when set.

The packaged skill defaults to:

https://test-waiqin.cloudplus.im

Use FIELD_AGENT_API_BASE_URL only when overriding the deployment domain, such as local development or a staging migration. Use FIELD_AGENT_USER_AGENT only when an edge firewall requires a specific allowed User-Agent for the /agent/* API path.

For local development:

FIELD_AGENT_API_BASE_URL=http://127.0.0.1:8000

If neither the server-wide AGENT_API_TOKEN nor any active Skill Operator exists, the API allows unauthenticated dev access. In production, create at least one active Skill Operator or set the server-wide token.

Query Progress

Prefer the bundled script:

python skills/field-agent-status/scripts/query_status.py <feishu_open_id>

Optional record limit:

python skills/field-agent-status/scripts/query_status.py <feishu_open_id> --limit 10

Show the persistent config path:

python skills/field-agent-status/scripts/query_status.py --config-path

The script calls:

GET /agent/members/{feishu_open_id}/status

It returns:

• member account status
• total field records
• result status counts
• review status counts
• latest field records

Interpret Results

• member.status = active: the person is approved and valid.
• member.status = pending: the person registered through Feishu but still needs web/admin approval.
• member.status = rejected: the person cannot submit valid field records.
• total_records = 0: no accepted field records have been submitted yet.
• review_status_counts.need_review or low_confidence: mention that human review is needed.
• Latest records are ordered newest first and include customer, task type, result, next action, and review status.

Registration Workflow

Feishu user command:

/register Zhang San
注册 张三

Admin approval endpoint:

POST /admin/members/{member_id}/approve

Admin rejection endpoint:

POST /admin/members/{member_id}/reject

Response Style

When answering a human, summarize in operational terms:

• whether the person is a valid approved member
• how many records they have submitted
• what the latest task/result/next action is
• whether any records need review

Avoid exposing raw tokens or internal headers.