> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询智能体

<Note>
  智能体创建或更新成功后，可以通过查询接口检查智能体训练状态。
</Note>

### 示例响应数据：

<img src="https://static.geekai.co/storage/2024/07/14/4d3c700f4164813a2c5549b86984edb.png" className="mt-2" alt="查询智能体" />


## OpenAPI

````yaml openapi.yaml GET /agent/{uuid}
openapi: 3.1.0
info:
  title: GeekAI API Docs
  description: >-
    GeekAI API Specification Document Provides AI capabilities such as chat,
    image generation, speech processing, video generation, ai agents and file
    extract.
  version: 1.0.0
servers:
  - url: https://geekai.dev/api/v1
    description: base URL
security:
  - bearerAuth: []
  - apiKeyAuth: []
paths:
  /agent/{uuid}:
    get:
      tags:
        - Agent
      summary: Get Agent
      description: Get detailed information about a specific AI agent.
      operationId: getAgent
      parameters:
        - $ref: '#/components/parameters/UuidParam'
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                type: object
                required:
                  - uuid
                  - name
                  - desc
                  - status
                properties:
                  uuid:
                    type: string
                    format: uuid
                    description: agent UUID
                  name:
                    type: string
                    description: agent name
                  logo:
                    type: string
                    format: uri
                    description: agent logo URL
                  desc:
                    type: string
                    description: agent description
                  status:
                    type: string
                    enum:
                      - initializing
                      - ready
                      - training
                      - error
                    description: agent status
                  model:
                    type: string
                    description: chat model
                  chat_level:
                    type: integer
                    description: chat level
                  interneted:
                    type: integer
                    description: enable internet access
                  stream:
                    type: integer
                    description: enable stream output
                  created_at:
                    type: string
                    format: date-time
                    description: creation timestamp
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/StandardError'
components:
  parameters:
    UuidParam:
      name: uuid
      in: path
      required: true
      schema:
        type: string
        format: uuid
      description: uuid
      example: 123e4567-e89b-12d3-a456-426614174000
  responses:
    Unauthorized:
      description: unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              code:
                type: string
                example: unauthorized
              message:
                type: string
                example: invalid api key or token
    NotFound:
      description: resource not found
      content:
        application/json:
          schema:
            type: object
            properties:
              code:
                type: string
                example: not_found
              message:
                type: string
                example: resource not found
    StandardError:
      description: standard error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: error code
          example: invalid_request
        message:
          type: string
          description: error message
          example: invalid request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: token
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: api key

````